Go to: Synopsis. Return value. Related. Flags. MEL examples.
group [-absolute] [-empty] [-name string] [-parent string] [-relative] [-useAsGroup string] [-world]
[objects...]
group is undoable, NOT queryable, and NOT editable.
This command groups the specified objects under a new group
and returns the name of the new group.
If the -em flag is specified, then an empty group (with no
objects) is created.
If the -w flag is specified then the new group is placed under the
world, otherwise if -p is specified it is placed under the
specified node. If neither -w or -p is specified the new group is
placed under the lowest common group they have in common. (or the
world if no such group exists)
If an object is grouped with another object that has the same name
then one of the objects will be renamed by this command.
string | - name of the group node |
duplicate, instance, parent, ungroup
absolute, empty, name, parent, relative, useAsGroup, world
Long name (short name) |
Argument types |
Properties |
-name(-n)
|
string
|
|
|
Assign given name to new group node.
|
|
-world(-w)
|
|
|
|
put the new group under the world
|
|
-parent(-p)
|
string
|
|
|
put the new group under the given parent
|
|
-empty(-em)
|
|
|
|
create an empty group (with no objects in it)
|
|
-relative(-r)
|
|
|
|
preserve existing local object transformations
(relative to the new group node)
|
|
-absolute(-a)
|
|
|
|
preserve existing world object transformations
(overall object transformation is preserved
by modifying the objects local transformation)
[default]
|
|
-useAsGroup(-uag)
|
string
|
|
|
Use the specified node as the group node. The specified node must be
derived from the transform node and must not have any existing parents
or children.
|
|
Flag can appear in Create mode of command
|
Flag can appear in Edit mode of command
|
Flag can appear in Query mode of command
|
Flag can be used more than once in a command.
|
// 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;