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

概要

duplicate [-inputConnections] [-instanceLeaf] [-name string] [-parentOnly] [-renameChildren] [-returnRootsOnly] [-smartTransform] [-upstreamNodes] [objects...]

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

指定したオブジェクトが複製されます。オブジェクトを指定しないと、選択したリストが複製されます。

Smart トランスフォーム機能を使用すると、複製間で事前に行われた変換に基づき、複製処理で新しい複製オブジェクトをトランスフォームできます。

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

注: スマート複製間でリストを変更すると、トランスフォーム情報が削除されます。

上流ノード オプションにより、選択したオブジェクトまでのすべての上流ノードの複製が強制されます。上流ノードとは、選択したノードまでのすべてのノードのことです。ディペンデンシー グラフの走査中に別の dagObject が検出された場合は、そのノードとすべての親トランスフォームも複製されます。

inputConnections オプションでは、入力接続の複製が、複製されるノードまで強制されます。これは、相互に接続した 2 つのノードを、複製するノードとして指定する場合に特に便利です。このような場合は、ノード間の接続も複製されます。

関連項目: instance

戻り値

string[]: 作成したオブジェクトの名前。

フラグ

inputConnections, instanceLeaf, name, parentOnly, renameChildren, returnRootsOnly, smartTransform, upstreamNodes
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-inputConnections(-ic) create
複製されるノードの入力接続も複製されます。入力側のノードが(-un オプションとは違って)複製されないので、結果的に展開シナリオになることがあります。
-instanceLeaf(-ilf) create
リーフ DAG ノードをコピーせずにインスタンス化します。
-name(-n) string create
複製オブジェクトに付ける名前。
-parentOnly(-po) create
指定した DAG ノードだけを複製し、その子は複製しません。
-renameChildren(-rc) create
階層の子ノードの名前を、固有になるように変更します。
-returnRootsOnly(-rr) create
新しい階層のルート ノードのみが返されます。upstreamNodes フラグと一緒に使用すると、結局、上流ノードが省略されます。このフラグは、出力の string[] で返されるもののみを制御し、duplicate コマンドの動作は変更しません。
-smartTransform(-st) create
最後の変換を記憶し、複製オブジェクトに適用します。
-upstreamNodes(-un) create
選択したノードまでの上流ノード(接続も含む)も複製されます。
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

MEL 例

  // Create a hierarchy of two spheres;
  sphere -n sphere1; move 3 0 0;
  sphere -n sphere2; move -3 0 0;
  group -n group1 sphere1 sphere2;
  circle -n circle1;

  // Create a duplicate of the group
duplicate group1;
  // Result: group2 sphere1 sphere2 //

  undo; duplicate -rr group1;
  // Result: group2 //

  // Create a row of 4 circles equally spaced using
  // the -smartTransform flag.
duplicate circle1; move 3 0 0; duplicate -st; duplicate -st;

  // Duplicate a sphere along with its input connections.
  // If animCurves were feeding into original transforms of the
  // sphere, they will feed into the duplicated ones also.
  // If the sphere has history (in this case it does),
  // then the history is connected to the duplicate. Note that
  // changing the radius for the makeNurbSphere for the sphere1
  // affects the duplicated sphere.
  //
  duplicate -ic group1|sphere1; move 0 0 0;
  setAttr makeNurbSphere1.radius 2;

  // Duplicate selected objects along with their upstream nodes
  // and connections. This will duplicate the history.
  select group1|sphere2;
duplicate -un;