instanceable

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

概要

instanceable([allow=boolean], [recursive=boolean], [shape=boolean])

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

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

1 つまたは複数の DAG ノードをインスタンス化できる(またはできない)ようにするためのフラグを立てます。このコマンドは指定した DAG ノードの内部状態を設定し、インスタンス化操作を実行する度に確認されます。コマンドラインでノード名を指定していない場合、現在のセレクション リストを使用します。

セットは、自動的にその構成オブジェクトにも拡張されます。既にインスタンス化されたノード(または、既にインスタンス化された子を持つノード)を、インスタンス化不可とマークすることはできません。

戻り値

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

キーワード

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
allow(a)	boolean
ノードに、新しいインスタンス化可能状態を指定します。ノードをインスタンス化可能にするには true を指定し、インスタンス化を防止するには false を指定します。既定は true です(ノードは既定でインスタンス化されます)。
recursive(r)	boolean
作成モードや編集モードの -allow フラグで指定して、-allow の設定を、選択したノードのシェイプ以外の子に、帰納的に適用できます。シェイプにも作用させるには、-recursive とともに -shape フラグも指定します。
shape(s)	boolean
作成モードや編集モードの -allow フラグで指定して、-allow の設定を、選択したノードのシェイプの子に適用できます。このフラグは、-recursive フラグと一緒に使用できます。

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

Python 例

import maya.cmds as cmds

# create a sphere.
# flag the transform and its shape as non-instanceable, then try to instance the sphere.
# you get an error because the shape is non-instanceable.
cmds.sphere()
cmds.instanceable( allow=0, shape=True )
cmds.instance()
# Error: '|nurbsSphere1' has non-instanceable children thus it cannot be instanced.

# Flag the sphere and its shape as instanceable. Then it can be instanced.
cmds.instanceable( allow=1, shape=True )
cmds.instance()
# Result: nurbsSphere2 #