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

概要

directionalLight([decayRate=int], [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])

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

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

TlightCmd は他のライト コマンドの基本クラスです。TnonAmbientLightCmd クラスはコマンドのように見えますが、コマンドではありません。延長/非延長ライトの基本クラスです。TnonExtendedLightCmd は基本クラスであり、実際のコマンドではありません。 このクラスはいくつかのライト(TpointLight、TdirectionalLight、TspotLight など)で継承されます。既存のディレクショナル ライトのパラメータを編集するか、新しいディレクショナル ライトを作成するために使用します。既定では、新しいディレクショナル ライトが作成されます。

これは directionalLight のインスタンスを作成したり、既存のパラメータを編集するコマンドです。TdirectionalLightCmd は、softShadow フラグを定義する TnonExtendedLightCmd から継承されます。ライト コマンドのグローバルな説明については、「TlightCmd」を参照してください。

TdirectionalLightCmd は他のコマンドのように動作し、フラグを持ち、元に戻す情報などを保存します。わずかな動作の違いは、コマンドの機能を完了するために TnonExtendedLightCmd を呼び出すことです。

戻り値

double[]rgb または shadowColor フラグ(double)を照会する場合、intensity フラグ(boolean)を照会する場合、useRayTraceShadows または exclusive フラグ(linear[])を照会する場合、position フラグ(angle[])を照会する場合、rotation フラグ(string)を照会する場合、name フラグを照会する場合
intdecayRate フラグを照会する場合はライトの減衰度
intShadowSamples フラグ(boolean)を照会する場合はシャドウ サンプルの数、ソフト シャドウが有効な場合に softShadow フラグ(float)を照会する場合は True、shadowDither フラグ(float)を照会する場合はシャドウ ディザリング値、discRadius フラグを照会する場合はディスクの半径値
stringライト シェイプの名前

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

関連

ambientLight, exclusiveLightCheckBox, lightList, lightlink, pointLight, spotLight, spotLightPreviewPort

フラグ

decayRate, discRadius, exclusive, intensity, name, position, rgb, rotation, shadowColor, shadowDither, shadowSamples, softShadow, useRayTraceShadows
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
decayRate(d) int create
ライトの減衰度です(0- 減衰なし、1- ゆっくり減衰、2- 普通の減衰、3- 速い減衰)。
discRadius(drs) linear createquery
シャドウ ディスクの半径です。
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 createquery
シャドウ ディザリング値。
shadowSamples(sh) int createquery
使用するシャドウ サンプルの数
softShadow(ss) boolean createquery
ソフト シャドウを有効にする場合は True
useRayTraceShadows(rs) boolean createquery
レイ トレースのシャドウを使用する場合は True
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

# Create a directional light
light = cmds.directionalLight(rotation=(45, 30, 15))

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

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