instance

フレームを表示

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

概要

instance( [objects] , [leaf=boolean], [name=string], [smartTransform=boolean])

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

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

オブジェクトが指定されていない場合、選択したリストがインスタンス化されます。オブジェクトをインスタンス化すると、選択したオブジェクトをポイントする新規トランスフォームが作成されます。

スマート トランスフォーム機能を使用すると、インスタンス間で事前に行われた変換に基づき、インスタンスを新規インスタンス オブジェクトにトランスフォームすることができます。

例: オブジェクトをインスタンス化して、別の位置に移動します。スマート トランスフォーム フラグを使用して、もう一度このオブジェクトをインスタンス化します。このオブジェクトは、前に移動したのと同じ距離だけ、もう一度移動されます。

注: スマート インスタンスどうしの間でリストを変更すると、トランスフォーム情報が削除されます。

インスタンス化の操作によって作成された新規オブジェクトのリストが返されます。

関連項目: duplicate

戻り値

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
leaf(lf)	boolean
末端のオブジェクトをインスタンス化します。duplicate コマンドと同様の動作をしますが、末端のオブジェクトがインスタンス化されます。
name(n)	string
新規インスタンス名を指定します。
smartTransform(st)	boolean
トランスフォーム間の移動に基づき、インスタンス項目を変換します。

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

Python 例

import maya.cmds as cmds

# Create a hierarchy
cmds.sphere( n='sphere1' )
cmds.move( 3, 0, 0 )
cmds.sphere( n='sphere2' )
cmds.move( -3, 0, 0 )
cmds.group( 'sphere1', 'sphere2', n='group1' )
cmds.group( 'group1', n='group2' )

# Create an instance of one of the spheres
cmds.instance( 'sphere1' )

# Duplicate the hierarchy except for the shapes which are
# instanced.instances of all leaf level shapes
cmds.instance( 'group1', leaf=True )

# Create a row of 4 instanced circles which are equally spaced
cmds.circle( n='circle1' )
cmds.instance()
cmds.move( 3, 0, 0 )
cmds.instance( smartTransform=True )
cmds.instance( smartTransform=True )