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

概要

group [-absolute] [-empty] [-name string] [-parent string] [-relative] [-useAsGroup string] [-world] [objects...]

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

このコマンドは、新規グループで指定したオブジェクトをグループ化して、新規グループ名を返します。

-em フラグを指定すると、空のグループ(オブジェクトなし)が作成されます。

-w フラグを指定すると新規グループはワールド空間に置かれ、-p を指定すると指定したノードに配置されます。-w も -p も指定しなければ、新規グループは一番下の共通グループに置かれます(そのようなグループが存在しない場合はワールド空間)。

オブジェクトが同名の別のオブジェクトにグループ化されると、このコマンドによってどちらかのオブジェクトの名前が変更されます。

戻り値

string- グループノード名

関連

duplicate, instance, parent, ungroup

フラグ

absolute, empty, name, parent, relative, useAsGroup, world
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-name(-n) string create
新しいグループ ノードに特定の名前を割り当てます。
-world(-w) create
ワールドに新しいグループを配置します。
-parent(-p) string create
特定の親に新しいグループを配置します。
-empty(-em) create
オブジェクトが入っていない空のグループを作成します。
-relative(-r) create
オブジェクトの既存のローカル変換を保持します(新規グループ ノードに相対して)。
-absolute(-a) create
既存のワールド オブジェクトの変換を保存します(オブジェクトの全体的な変換は、オブジェクのローカルな変換を修正することによって保持されます)。［既定］
-useAsGroup(-uag) string create
指定されたノードをグループノードとして使用します。指定されたノードは トランスフォーム ノードから派生し、既存の親も子もない状態である 必要があります。
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

MEL 例

// create an empty group node with no children
group -em -name null1;
// create some objects and group them
sphere -n sphere1;
circle -n circle1;
group -n group1 circle1 sphere1;
// create a group node under another node and move
// the sphere under the new group node.
group -parent null1 sphere1;