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

概要

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(ambientShade) 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
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

# Create an ambientLight light
light = cmds.ambientLight(intensity=0.8)

# Change the light intensity
cmds.ambientLight( light, e=True, intensity=0.5 )

# Query it
cmds.ambientLight( light, q=True, intensity=True )
# Result:0.5 #