移動先: 概要 戻り値 関連項目 フラグ MEL の例

概要

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

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

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

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

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

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

戻り値

string- グループノード名

関連項目

duplicate, instance, parent, ungroup

フラグ

absolute, empty, name, parent, relative, world
ロング ネーム(ショート ネーム) 引数型 プロパティ
-name(-n) string create
新しいグループ ノードに特定の名前を割り当てます。
-world(-w) create
ワールドに新しいグループを配置します。
-parent(-p) string create
特定の親に新しいグループを配置します。
-empty(-em) create
オブジェクトが入っていない空のグループを作成します。
-relative(-r) create
オブジェクトの既存のローカル変換を保持します(新規グループ ノードに相対して) 。
-absolute(-a) create
既存のワールド オブジェクトの変換を保存します(オブジェクトの全体的な変換は、オブジェクのローカルな変換を修正することによって保持されます)。[デフォルト]

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

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;