移動先: 概要 戻り値 フラグ MEL の例

概要

instance [-leaf] [-name string] [-smartTransform] [objects]

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

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

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

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

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

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

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

関連項目: duplicate

戻り値

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

フラグ

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

: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : 1 つのコマンドで複数回使用可能なフラグ

MEL の例

  // Create a hierarchy
  sphere -n sphere1; move 3 0 0;
  sphere -n sphere2; move -3 0 0;
  group -n group1 sphere1 sphere2;
  group -n group2 group1;

  // Create an instance of one of the spheres
instance sphere1;

  // Duplicate the hierarchy except for the shapes which are
  // instanced.instances of all leaf level shapes
instance -leaf group1;

  // Create a row of 4 instanced circles which are equally spaced
  circle -n circle1;
  instance; move 3 0 0;
  instance -smartTransform;
  instance -smartTransform;