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

概要

createRenderLayer([empty=boolean], [g=boolean], [makeCurrent=boolean], [name=string], [noRecurse=boolean], [number=int])

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

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

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

戻り値

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

キーワード

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

関連

editRenderLayerGlobals, editRenderLayerMembers

フラグ

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

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

Python 例

import maya.cmds as cmds

# Add nut and nutShape to a new render layer
#
cmds.select( 'nut' )
cmds.createRenderLayer()
# Result: renderLayer1 #

# Add only bolt to a new render layer
#
cmds.createRenderLayer( 'bolt', noRecurse=True )
# Result: renderLayer2 #

# Add washer to the new render layer 'assembly'.
#
cmds.createRenderLayer( 'washer', noRecurse=True, name='assembly' )
# Result: assembly #

# Create a layer that will always contains everything
#
cmds.createRenderLayer( g=True )
# Result: renderLayer3 #