ジャンプ先: 概要. 戻り値. 関連. フラグ. MEL 例.

概要

ambientLight [-ambientShade float] [-discRadius linear] [-exclusive boolean] [-intensity float] [-name string] [-position linear linear linear] [-rgb float float float] [-rotation angle angle angle] [-shadowColor float float float] [-shadowDither float] [-shadowSamples int] [-softShadow boolean] [-useRayTraceShadows boolean]

ambientLight は、取り消し可能、照会可能、および編集可能です。

TlightCmd は他のライト コマンドの基本クラスです。ambientLight コマンドは、既存の ambientLight のパラメータを編集したり、新しい ambientLight を作成したりします。既定の動作は、新しい ambientLight の作成です。

これは、ambientLight をインスタンス化するか、既存の ambientLight のパラメータを編集するコマンドです。TambientLightCmd は TlightCmd から継承され、強度やカラーなどの共通のフラグを定義します。ライト コマンドのグローバルな説明については、「TlightCmd」を参照してください。フラグ fAmbientLightUsed はコマンドが任意のアンビエント固有のフラグを使用するかどうかを示します。つまり、ここで定義されたフラグをコマンドが使用しない場合、ブール演算 fAmbientLightUsed が false に設定されるため、このレベルでの元に戻す/やり直しの情報は保存されません。

TambientLightCmd は他のコマンドのように動作し、フラグを持ち、元に戻す情報などを保存します。わずかな動作の違いは、コマンドの機能を完了するために TlightCmd を呼び出すことです。parseArgs の例: TambientLightCmd は -ambientShade のように ambientLight 特定のパラメータを定義しますが、TlightCmd には -intensity などのようないくつかのその他のパラメータも使用できます。そのため、引数を解析する際、共通のパラメータ(強度など)を解析するために、TlightCmd::parseArgs への呼び出しが行われます。

戻り値

double[]rgb または shadowColor フラグ(double)を照会する場合、intensity フラグ(boolean)を照会する場合、useRayTraceShadows または exclusive フラグ(linear[])を照会する場合、position フラグ(angle[])を照会する場合、rotation フラグ(string)を照会する場合、name フラグを照会する場合
stringライト シェイプの名前

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

関連

directionalLight, exclusiveLightCheckBox, lightList, lightlink, pointLight, spotLight, spotLightPreviewPort

フラグ

ambientShade, discRadius, exclusive, intensity, name, position, rgb, rotation, shadowColor, shadowDither, shadowSamples, softShadow, useRayTraceShadows
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-ambientShade(-as) float createqueryedit
ambientShade
-discRadius(-drs) linear createqueryedit
ライトの周りの円形の半径です。
-exclusive(-exc) boolean createquery
ライトが排他的に割り当てられている場合は True
-intensity(-i) float createquery
ライトの強度
-name(-n) string createquery
ライトの名前
-position(-pos) linear linear linear createquery
ライトの位置
-rgb(-rgb) float float float createquery
ライトの RGB カラー
-rotation(-rot) angle angle angle createquery
方向指定のためのライトの回転(該当する場合)
-shadowColor(-sc) float float float createquery
ライトのシャドウの色
-shadowDither(-sd) float createqueryedit
シャドウをディザリングします。
-shadowSamples(-sh) int createqueryedit
シャドウ サンプルの数です。
-softShadow(-ss) boolean createqueryedit
ソフト シャドウです。
-useRayTraceShadows(-rs) boolean createquery
レイ トレースのシャドウを使用する場合は True
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

MEL 例

// Create an ambient light
string $light = `ambientLight -intensity 0.8`;

// Change the light intensity
ambientLight -e -intensity 0.5 $light;

// Query it
ambientLight -q -intensity $light;
// Result:0.5 //