makeLive

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

概要

makeLive [-addObjects] [-none] [-registry int] [-registryCount] [-registryReset] [-registrySize int] [-removeObjects] [surface...]

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

makeLive コマンドは、このタイプのオブジェクトを明示的な引数として期待します。引数を明示的に指定しない場合は、現在アクティブになっているものに基づいて、多くの既定動作が実行されます。アクティブなオブジェクトが有効なタイプのオブジェクトでない場合、このコマンドはエラーになります。アクティブなものがない場合、現在のライブ オブジェクトは休止状態になります。アクティブなものがある場合、アクティブ オブジェクトがライブ オブジェクトになります。

このコマンドを使用すると、限られた数のオブジェクトのコレクションをレジストリ エントリに保存できます。これらのコレクションは、照会したり、ライブ状態にすることができます。

戻り値

なし

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

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-addObjects(-ao)
リストされたオブジェクトを現在のライブ リストに追加します。オブジェクトが既にライブ リストに含まれている場合、このオブジェクトは無視されます。
-none(-n)
-n/none フラグを指定した場合、ライブ オブジェクトは休止状態になります。このフラグを使用すると、すべての引数は無視されます。
-registry(-r)	int
指定したレジストリ エントリで定義されたオブジェクトをライブ オブジェクトにします。照会モードでは、指定したレジストリ エントリで定義されているオブジェクトのリストを返します。
-registryCount(-rc)
レジストリ エントリの実際の数を返します。この数の範囲は 0 から「registrySize」- 1 です。
-registryReset(-rr)
レジストリ エントリの最大数を既定値にリセットし、格納されているすべてのデータをクリアします。
-registrySize(-rs)	int
コマンドが記憶するレジストリ エントリの最大数を定義します。照会モードでは、現在設定されている最大数を返します。
-removeObjects(-ro)
リストされたオブジェクトを現在のライブ リストから除去します。リストにオブジェクトが含まれていない場合、このオブジェクトは無視されます。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	コマンド内でフラグを複数回使用できます。

MEL 例

// get the registry size
makeLive -q -registrySize;

// set surface1 as the live object
makeLive surface1;

// make surface1 the dormant object
makeLive -none;

// make both surface1 and surface2 the live objects.
makeLive surface1 surface2

// Get the active number of registry entries and the stored collection
int $nbReg = `makeLive -q -registryCount`;
for ($i = 0; $i < $nbReg; $i++) {
	string $liveObjs[] = `makeLive -q -registry $i`;
	print $liveObjs;
	print "\n";
}

// make live the objects collection stored in registry entry 1
makeLive -registry 1;

// clears all the registry and reset the data stucture to the defaults.
makeLive -registryReset

// add both surface1 and surface2 to the registry list that is currently live
makeLive -addObjects surface1 surface2

// remove surface1 from the registry list that is currently live
makeLive -removeObjects surface1