フォトメトリック ライトの共通プロパティ、演算子、メソッド
 
 
 

> MAXWrapper > ノード > フォトメトリック ライト > 共通プロパティおよびメソッド

 

   

ライトとカメラ - クイック ナビゲーション

3ds Max 2009 以降は、すべてのフォトメトリック ライトが、同じプロパティ セットを持つようになりました。すべてのフォトメトリック ライト タイプは、他のタイプに自由に切り替えることができます。LightProperties インタフェース .type プロパティの説明を参照してください。

詳細は、「フォトメトリック ライト クラス」を参照してください。

プロパティ:

[一般パラメータ]ロールアウト

ライトのプロパティ

   

<Photometric_Light>.on Boolean default: true -- boolean 		  

ライトの放射のオンとオフを切り替えます。

   

<Photometric_Light>.targetDistance Float default: 240.0 -- animatable; float; Target_Distance 		

ライトのターゲットまでの距離を取得/設定します。

シャドウ

   

<Photometric_Light>.castShadows BooleanClass default: false -- boolean; Cast_Shadows 	 

影付けのオンとオフを切り替えます。

   

<Photometric_Light>.useGlobalShadowSettings BooleanClass default: false -- boolean; Use_Global_Params   

true に設定すると、シャドウ ジェネレータでグローバル シャドウ設定が使用されます。false に設定すると、ローカル設定が使用されます。

   

<Photometric_Light>.shadowGenerator shadowMap default: shadowMap:shadowMap -- value; SubAnim 

シャドウ ジェネレータをクラス インスタンスとして取得/設定します。

LightProperties インタフェース

   

<Photometric_Light>.shadowGeneratorByName String default: "Shadow Map" -- value 

名前でシャドウ ジェネレータをを取得/設定します。

LightProperties インタフェース

   

<Photometric_Light>.raytracedShadows BooleanClass default: false -- value 

レイトレース シャドウの使用を取得/設定します。LightProperties インタフェースによって公開されます。

注:

このプロパティは 3ds Max 5 以上では使用 できません。シャドウ ジェネレータを割り当てるときは、 .shadowGenerator プロパティを使用してください。

このプロパティは以前との互換性を保つ目的でのみ公開されています。3ds Max 5 より前のバージョンでは、使用可能なシャドウ ジェネレータ タイプはシャドウ マップとレイトレース シャドウだけでした。このプロパティを設定するとシャドウ ジェネレータが内部的に切り替わります。現在では、使用可能なシャドウ ジェネレータの数がずっと増えているため( サード パーティ製プラグインを含む)、このプロパティは廃止されています。

[含む/除外]リスト

   

<Photometric_Light>.excludeList Array default: #() -- value 

除外リストをオブジェクト上の配列として取得/設定します。値を設定すると、[含む]/[除外]オプションは[除外]に設定されます。

LightProperties インタフェースによって公開されます。

   

<Photometric_Light>.includeList UndefinedClass default: undefined -- value; !error setting value! 

ライトの発光に含めるオブジェクトの配列を取得/設定します。値を設定すると、[含む]/[除外]オプションは[含む]に設定されます。

LightProperties インタフェースによって公開されます。

ライトの配光(タイプ)

   

<Photometric_Light>.distribution Integer default: 0 -- value 

分配タイプを取得/設定します。

有効な値は次のとおりです。

0 - 均一の球状

1 - スポットライト (球体タイプと円柱タイプでは無効)

2 - 均一の拡散反射光 (球タイプと円柱タイプでは無効)

3 - フォトメトリック ウェブ ファイル (球体タイプと円柱タイプでは無効)

LightProperties インタフェースによって公開されます。

[強度/カラー/減衰]ロールアウト

カラー

   

<Photometric_Light>.color Color default:(color 265.933 250.885 263.562)-- color by value 

ライトの RGB カラー。.rgb および .Light_Colorのエイリアス。

LightProperties インタフェースによって公開されます。

   

<Photometric_Light>.useKelvin BooleanClass default: false -- boolean; Use_Kelvin 

[ケルヴィン]ラジオ ボタンの状態を取得/設定します。 true のときは、ケルビン単位のカラーの温度が使われます。 false のときは、RGB カラーが使われます。

   

<Photometric_Light>.kelvin Float default: 3600.0 -- animatable; float 

ケルヴィン単位の色温度を取得/設定します。

   

<Photometric_Light>.rgbFilter Color default: (color 255 255 255) -- animatable; RGB color; Filter_Color; Controller Scaling: ([1,1,1] : (color 255 255 255)) ) 

フィルタ カラーを取得/設定します。

強度

   

<Photometric_Light>.intensityType Integer default: 1 -- integer; Intensity_Type 

強度タイプを取得/設定します。

有効な値は次のとおりです。

0 -lm

1 -cd

2 -lx at

   

<Photometric_Light>.intensityFloat default: 1500.0 -- animatable; float 

強度の値を取得/設定します。

   

<Photometric_Light>.intensityAt Float default: 39.3701 -- float; Intensity_At 

.intensityType が 2 - lx at に設定されている場合に、強度が計測される距離を取得/設定します。

   

<Photometric_Light>.flux Float default: 0.0 -- float 

[光強度]を lm で設定します。

   

<Photometric_Light>.originalFlux Float default: 0.0 -- float 

   

<Photometric_Light>.originalIntensity Float default: 0.0 -- float; Shape_Area_Shadows 

減光する

   

<Photometric_Light>.useMultiplier BooleanClass default: false -- boolean; Use_Dimmer 

[減光する]チェックボックスの状態を取得/設定します。

   

<Photometric_Light>.Multiplier Float default: 100.0 -- animatable; float 

[減光する]の強度値をパーセントで取得/設定します。

   

<Photometric_Light>.shiftColorWhenDimming BooleanClass default: false -- boolean; Shift_Color_When_Dimming 

[白熱光ランプのカラー 暗くなるにつれてシフト]チェックボックスの状態を取得/設定します。

遠方減衰

   

<Photometric_Light>.useFarAttenuation BooleanClass default: false -- boolean; Use_Far_Attenuation 

[遠方減衰]の[使用]チェックボックスの状態を取得/設定します。

   

<Photometric_Light>.displayFarAttenuationGizmo BooleanClass default: false -- boolean; Display_Far_Attenuation_Gizmo 

[遠方減衰]の[表示]チェックボックスの状態を取得/設定します。

   

<Photometric_Light>.startFarAttenuation Float default: 80.0 -- animatable; worldUnits; Start_Far_Attenuation 

[遠方減衰]の[開始]の値を取得/設定します。

   

<Photometric_Light>.endFarAttenuation Float default: 200.0 -- animatable; worldUnits;Vertical_Circle_Facing_Photometric_Horizontal 

[遠方減衰]の[終了]の値を取得/設定します。

[シェイプ/領域シャドウ]ロールアウト

   

<Photometric_Light>.type Name default: #Free_Point -- value 

フォトメトリック ライトのタイプを取得/設定します。

有効な値は次のとおりです。

#Free_Point

#Free_Line

#Free_Rectangle

#Free_Disc

#Free_Sphere

#Free_Cylinder

#Target_Point

#Target_Line

#Target_Rectangle

#Target_Disc

#Target_Sphere

#Target_Cylinder

LightProperties インタフェースによって公開されます。

   

<Photometric_Light>.light_length Float default:122.0 -- animatable; worldUnits 

エリア ライトの長さを取得/設定します(当てはまる場合)。

   

<Photometric_Light>.light_width Float default:61.0 -- animatable; worldUnits 

エリア ライトの幅を取得/設定します(当てはまる場合)。

   

<Photometric_Area>.light_radius Float default: 13.0 -- animatable; worldUnits 

エリア ライトの半径を取得/設定します(当てはまる場合)。

   

<Photometric_Light>.length Float default:122.0 --float 

エリア ライトの長さを取得/設定します。

   

<Photometric_Light>.width Float default: 61.0 -- float 

エリア ライトの幅を取得/設定します。

[分配 (スポットライト)]ロールアウト

   

<Photometric_Light>.showCone BooleanClass default: false -- boolean; Cone_Display 

[選択されていない場合はビューポートに円錐を表示]チェックボックスの状態を取得/設定します。

   

<Photometric_Light>.hotSpot Float default: 30.0 -- animatable; float; Beam_Angle 

[ホットスポット/ビーム]角度を取得/設定します。.distribution が 1 - スポットライトに設定されている場合にのみ使用します。

   

<Photometric_Light>.falloff Float default: 60.0 -- animatable; float; Field_Angle 

[ホットスポット/ビーム]角度を取得/設定します。.distribution が 1 - スポットライトに設定されている場合にのみ使用します。

[分配 (フォトメトリック ウェブ)]ロールアウト

   

<Photometric_Light>.webFile String default: "" -- filename; Web_Filename 

.distribution が 0 - ウェブに設定されている場合に使用されるウェブ ファイル。

   

<Photometric_Light>.xRotation Float default: 0.0 -- float; X_Rotation 

フォトメトリック ウェブの[X 回転]値。 .distribution が 0 - ウェブに設定されている場合にのみ使用します。

   

<Photometric_Light>.yRotation Float default: 0.0 -- float; Y_Rotation 

フォトメトリック ウェブの[Y 回転]値。 .distribution が 0 - ウェブに設定されている場合にのみ使用します。

   

<Photometric_Light>.zRotation Float default: 0.0 -- float; Z_Rotation 

フォトメトリック ウェブの[Z 回転]値。.distribution が 0 - ウェブに設定されている場合にのみ使用します。

[シャドウ パラメータ]ロールアウト

オブジェクト シャドウ

   

<Photometric_Light>.shadowColor Color default: (color 0 0 0) -- animatable; RGB color; Shadow_Color; Controller Scaling: ([1,1,1] : (color 255 255 255)) 

シャドウの[カラー]値を取得/設定します。

   

<Photometric_Light>.shadowMultiplier Float default: 1.0 -- animatable; float; Shadow_Density

シャドウの[密度]値を取得/設定します。

   

<Photometric_Light>.shadowColorMapEnable BooleanClass default: false -- boolean; Use_Shadow_Color_Map 

シャドウの[マップ]有効化チェックボックスの状態を取得/設定します。

   

<Photometric_Light>.shadowProjectorMap UndefinedClass default: undefined -- texturemap; Shadow_Projector_Map 

シャドウのプロジェクタ マップを取得/設定します。

   

<Photometric_Light>.lightAffectsShadow BooleanClass default: false -- boolean; Light_Affects_Shadow 

[ライトがシャドウ カラーに影響]チェックボックスの状態を取得/設定します。

環境効果のシャドウ

   

<Photometric_Light>.atmosShadows BooleanClass default: false -- boolean; Atmospheric_Shadows_On 

[環境効果のシャドウ]のオンとオフを切り替えます。

   

<Photometric_Light>.atmosColorAmt Float default: 100.0 -- animatable; float; Atmospheric_Color_Amount 

[環境効果のシャドウ]の[カラーの量]の値を取得/設定します。

   

<Photometric_Light>.atmosOpacity Float default: 100.0 -- animatable; float; Atmospheric_Opacity 

[環境効果のシャドウ]の[不透明度]の値を取得/設定します。

[拡張効果]ロールアウト

   

<Photometric_Light>.contrast Float default: 0.0 -- animatable; float; Light_Contrast 

ライトの[コントラスト]の値を取得/設定します。

   

<Photometric_Light>.softenDiffuseEdge Float default: 0.0 -- animatable; float; Diffuse_Soften 

[シェーディング和らげ]の値を取得/設定します。

   

<Photometric_Light>.affectDiffuse BooleanClass default: true -- boolean; Affect_Diffuse 

true のとき、ライトは拡散反射光カラーに影響します。

   

<Photometric_Light>.affectSpecular BooleanClass default: true -- boolean; Affect_Diffuse 

true のとき、ライトは鏡面反射光カラーに影響します。

   

<Photometric_Light>.ambientOnly BooleanClass default: false -- boolean; Ambient_Only 

   

When set to true, the light affects the Ambient color only. 

   

<Photometric_Light>.projector BooleanClass default: false -- boolean 

[プロジェクタ マップ]のオンとオフを切り替えます。

   

<Photometric_Light>.projectorMap UndefinedClass default: undefined -- texturemap; Projector_Map 

[プロジェクタ マップ]を取得/設定します。

すべての Photometric Light によって公開されるインタフェースは、次のとおりです。

   

Interface:LightProperties 

プロパティ:

   

.type: value : Read|Write 

フォトメトリック ライトのタイプを取得/設定します。

有効な値は次のとおりです。

#Free_Point

#Free_Line

#Free_Rectangle

#Free_Disc

#Free_Sphere

#Free_Cylinder

#Target_Point

#Target_Line

#Target_Rectangle

#Target_Disc

#Target_Sphere

#Target_Cylinder

   

.distribution: value : Read|Write 

すべての Photometric Light によって公開されるインタフェースは、次のとおりです。

有効な値は次のとおりです。

0 - 均一の球状

1 - スポットライト (球体タイプと円柱タイプでは無効)

2 - 均一の拡散反射光 (球タイプと円柱タイプでは無効)

3 - フォトメトリック ウェブ ファイル (球体タイプと円柱タイプでは無効)

   

.excludeList: value : Read|Write 

除外リストをオブジェクト上の配列として取得/設定します。値を設定すると、[含む]/[除外]オプションは[除外]に設定されます。

   

.includeList: value : Read|Write 

ライトの発光に含めるオブジェクトの配列を取得/設定します。値を設定すると、[含む]/[除外]オプションは[含む]に設定されます。

   

.shadowGenerator: value : Read|Write 

シャドウ ジェネレータをクラス インスタンスとして取得/設定します。

   

.shadowGeneratorByName: value : Read|Write 

名前でシャドウ ジェネレータをを取得/設定します。

   

.raytracedShadows: value : Read|Write 

レイトレース シャドウの使用を取得/設定します。

注:

このプロパティは 3ds Max 5 以上では使用 できません。シャドウ ジェネレータを割り当てるときは、 .shadowGenerator プロパティを使用してください。

このプロパティは以前との互換性を保つ目的でのみ公開されています。3ds Max 5 より前のバージョンでは、使用可能なシャドウ ジェネレータ タイプはシャドウ マップとレイトレース シャドウだけでした。このプロパティを設定するとシャドウ ジェネレータが内部的に切り替わります。現在では、使用可能なシャドウ ジェネレータの数がずっと増えているため( サード パーティ製プラグインを含む)、このプロパティは廃止されています。

   

.color: color by value : Read|Write 

カラーを取得/設定します。

   

.enabled: bool : Read|Write 

使用可能状態を取得/設定します。

関連事項