移動先: 概要 戻り値 キーワード. 関連項目. フラグ. MEL 例.

概要

createRenderLayer [-empty] [-global] [-makeCurrent] [-name string] [-noRecurse] [-number int]

createRenderLayer は 「元に戻す」が可能、「照会」が不可能「編集」が不可能 です。

新しいレンダー レイヤを作成します。レンダー レイヤには、レンダー レイヤのグローバル パラメータの基準インデックス番号より大きい、まだ割り当てられていない最初の番号が割り当てられます。通常、すべてのオブジェクトとその子孫が新規のレンダー レイヤに追加されますが、-noRecurse を指定するとオブジェクトのみが追加されます。トランスフォームとジオメトリのみが新しいレンダー レイヤに追加されます。

戻り値

string作成したレンダー レイヤ ノードの名前

キーワード

renderLayer, 2d3d, layer, color, playback, render

関連項目

editRenderLayerGlobals, editRenderLayerMembers

フラグ

empty, global, makeCurrent, name, noRecurse, number
ロング ネーム(ショート ネーム) 引数型 プロパティ
-noRecurse(-nr) create
設定すると、指定したオブジェクトのみがレンダー レイヤに追加されます。設定しないと、すべての子孫も追加されます。
-empty(-e) create
設定すると、空のレンダー レイヤが作成されます。グローバル フラグや指定したメンバー リストは、このフラグより優先されます。
-global(-g) create
設定すると、シーン内にあるすべての DAG オブジェクトを含むレイヤを作成します。以降に作成するオブジェクトも、自動的にこのレイヤのメンバーになります。 グローバル フラグは、空のフラグまたは指定したメンバー リストより優先されます。
-makeCurrent(-mc) create
設定すると、新しいレンダー レイヤがカレント レイヤになります。
-name(-n) string create
作成する新しいレンダー レイヤの名前
-number(-num) int create
作成する新しいレンダー レイヤの番号

: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : 1 つのコマンドで複数回使用可能なフラグ

MEL 例

// Add nut and nutShape to a new render layer
//
select nut;
createRenderLayer;
// Result: renderLayer1 //
// Add only bolt to a new render layer
//
createRenderLayer -noRecurse bolt;
// Result: renderLayer2 //
// Add washer to the new render layer 'assembly'.
//
createRenderLayer -noRecurse -name assembly washer;
// Result: assembly //
// Create a layer that will always contains everything
//
createRenderLayer -global;
// Result: renderLayer3 //