ジャンプ先: 概要. 戻り値.
関連項目. フラグ. MEL 例.
lightlink [-break]
[-hierarchy boolean] [-light name] [-make]
[-object name] [-sets boolean] [-shapes boolean] [-transforms boolean] objects
lightlink は 「元に戻す」が可能、「照会」が可能、「編集」が不可能 です。
ライトまたはライト セットとオブジェクトまたはオブジェクト
セットの間で、ライトのリンクリレーションの作成、破壊、照会を実行するために使用します。 make フラグ、break
フラグ、query フラグを指定せず、light フラグと object フラグの両方を指定すると、make
フラグが指定したと仮定されます。 make フラグ、break フラグ、query フラグを指定せず、light フラグか
object フラグのいずれかを指定すると、query フラグが指定したと仮定されます。 多重使用の -light フラグと
-object フラグを使用すると、ライトとオブジェクトを好きなだけ指定できます。
ライトのリンク機能を実行する最適な方法は、ライトのセットとジオメトリのセットを作成することです。シーン内のシーリング
ライトなどのライトを含むセット、およびキャラクタのジオメトリなどのジオメトリを含むセットを作成すると、ジオメトリのセットにライトのセットをリンクして、そのライトがそのジオメトリの構成要素を照らすようにできます。
さらに、それぞれのセットでは、ライト リンクの作成と破壊を実行せずにライトとジオメトリの追加と削除を実行できます。
戻り値の型は照会モードでは照会フラグが基になります。
ambientLight, directionalLight, exclusiveLightCheckBox, lightList, pointLight, spotLight, spotLightPreviewPort
break, hierarchy, light,
make, object,
sets, shapes,
transforms
| ロング ネーム（ショート ネーム） |
引数型 |
プロパティ |
-make(-m) |
|
 |
|
コマンドでこのフラグを指定すると、ライトとレンダリング可能オブジェクトの間にリンクを作成するためにコマンドが呼び出されます。 |
|
-break(-b) |
|
|
|
コマンドでこのフラグを指定すると、ライトとレンダリング可能オブジェクトの間でリンクを破壊するためにコマンドが呼び出されます。 |
|
-light(-l) |
name |
 |
|
light フラグの引数は、アクションの実行でコマンドが使用するノードを、そのノードがライトであるかのように指定します。
これは多重使用フラグです。つまり lightlink コマンドの 1 回の呼出しで複数のライト ノードを指定できます。 |
|
-object(-o) |
name |
|
|
object
フラグの引数は、アクションの実行でコマンドが使用するノードを、そのノードがオブジェクトであるかのように指定します。
これは多重使用フラグです。つまり lightlink コマンドの 1 回の呼出しで複数のオブジェクト ノードを指定できます。 |
|
-shapes(-shp) |
boolean |
|
|
照会する場合は、照会するライトやオブジェクトにリンクされたシェイプを結果に含めるかどうかを指定します。デフォルトは true
です。 |
|
-transforms(-t) |
boolean |
|
|
照会する場合は、照会するライトやオブジェクトにリンクされたシェイプの上のトランスフォームを結果に含めるかどうかを指定します。デフォルトは
true です。 |
|
-hierarchy(-h) |
boolean |
|
|
照会する場合は、照会するライトやオブジェクトにリンクされたシェイプの上のトランスフォームの階層を結果に含めるかどうかを指定します。階層の一部とみなされるトランスフォームには、シェイプのすぐ上のトランスフォームが含まれません。デフォルトは
true です。 |
|
-sets(-set) |
boolean |
|
|
照会する場合は、照会するライトやオブジェクトにリンクされたセットを結果に含めるかどうかを指定します。デフォルトは true
です。 |
|
| : コマンドの作成モードで使用可能なフラグ |
 : コマンドの編集モードで使用可能なフラグ |
 : コマンドの照会モードで使用可能なフラグ |
: 1 つのコマンドで複数回使用可能なフラグ |
lightlink -light spotLight1 -light pointLight2 -object apple -object orange -object banana -light ambientLight4;
// causes a light link to be "created between" each of the lights
// spotLight1, pointLight2, ambientLight4 and each of the objects
// apple, orange, banana. This creates 9 links. Note that no make,
// break or query flag is specified so make is assumed since both
// lights and objects are specified.
lightlink -make -light ceilingLightSet -object apple;
// causes a light link to be "created between" the ceiling lights and
// the apple geometry. If apple is already illuminated by
// ceilingLightSet, then nothing changes and a warning is produced.
lightlink -object stillLifeSet -light spotLight1;
// causes a light link to be "created between" spotLight1 and the still
// life. If stillLifeSet is already illuminated by spotLight1, then
// nothing changes and a warning is produced. Note: no make, break or
// query flag is specified so the make flag is assumed since both lights
// and objects are specified.
lightlink -light ceilingLightSet -light floorLightSet -object tableAndChairsSet;
// causes a light link to be "created between" each of the light sets
// ceilingLightSet, floorLightSet and the object set tableAndChairsSet.
lightlink -query -light ceilingLightSet;
// will return a string array of objects which are illuminated by the
// set ceilingLightSet. For example, the return value might be:
// stillLifeSet table chair floor roomWallsSet binky
lightlink -query -object apple;
// will return a string array of lights which illuminate the object
// apple. For example, the return value might be ceilingLightSet
// spotLight1 spotLight2 ambientLight1
lightlink -object apple;
// will return a string array of lights which illuminate the object
// apple. For example, the return value might be ceilingLightSet
// spotLight1 spotLight2 ambientLight1. Note that no make, break
// or query flag is specified, so query is assumed since no lights
// are specified.
lightlink -break -light ceilingLightSet -object apple;
// causes the light set ceilingLightSet to no longer illuminate the
// object apple. If ceilingLightSet was already not illuminating apple,
// nothing changes and a warning is produced.