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

概要

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

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

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

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

戻り値

string作成したディスプレイ レイヤ ノードの名前

キーワード

displayLayer, display, layer, color, playback, render

関連項目

editDisplayLayerGlobals, editDisplayLayerMembers, layerButton

フラグ

empty, makeCurrent, name, noRecurse, number
ロング ネーム(ショート ネーム) 引数型 プロパティ
noRecurse(nr) boolean create
設定すると、選択したオブジェクトのみがディスプレイ レイヤに追加されます。それ以外の場合は、選択したオブジェクトのすべての子孫も追加されます。
empty(e) boolean create
設定すると、空のディスプレイ レイヤが作成されます。つまり、選択項目は新しいディスプレイ レイヤに追加されません。
makeCurrent(mc) boolean create
設定すると、新しいディスプレイ レイヤがカレント レイヤになります。
name(n) string create
作成する新しいディスプレイ レイヤの名前
number(num) int create
作成する新しいディスプレイ レイヤの番号

: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

import maya.cmds as cmds

#    Create a sphere.
#
objectArray = cmds.sphere()
#    Select the sphere.
#
cmds.select( objectArray[0] )
#    Create a layer. The selected object will be placed
#    in this layer. Note in this case both the nurbsSphere
#    and nurbsSphere shape are placed in the layer.
#
cmds.createDisplayLayer()
#    Create a cone.
#
objectArray = cmds.cone()
#    Select the cone.
#
cmds.select( objectArray[0] )
#    Create a layer but only put the nurbsCone in the layer.
#    The nurbsConeShape will remain in the default layer
#    as a result of specifying the -nr/noRecurse flag.
#
#    Note also that you can specify the name of the layer
#    with the -n/name flag.
#
cmds.createDisplayLayer( noRecurse=True, name='ExampleLayer' )