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

概要

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

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

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

インスタンスを作成することによって、同じシーンに同じオブジェクトを 2 回登場させることができます。このためには、既存のオブジェクトをポイントする新規トランスフォームを作成します。トランスフォームへの変更によってほかのものが影響を受けることはありませんが、「インスタンス化された」オブジェクトへの変更は、すべてのインスタンスに影響を与えます。これはノードが共有されているからです。

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

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

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

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

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

関連項目: duplicate

戻り値

string新しいトランスフォーム ノードの名前が返されます。

フラグ

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

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

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 )