Show frames
Go to: Synopsis. Return value. Related. Flags. MEL examples.
parent [-absolute] [-addObject] [-noConnections] [-noInvScale] [-relative] [-removeObject] [-shape] [-world]
[dagObject...] [dagObject]
parent is undoable, NOT queryable, and NOT editable.
This command parents (moves) objects under a new group, removes
objects from an existing group, or adds/removes parents.
If the -w flag is specified all the selected or specified objects
are parented to the world (unparented first).
If the -rm flag is specified then all the selected or specified
instances are removed.
If there are more than two objects specified all the objects are
parented to the last object specified.
If the -add flag is specified, the objects are not reparented but
also become children of the last object specified.
If there is only a single object specified then the selected objects
are parented to that object.
If an object is parented under a different group and there is
an object in that group with the same name then this command
will rename the parented object.
string[] | Names of the objects parented (possibly renamed) |
group, listRelatives
absolute, addObject, noConnections, noInvScale, relative, removeObject, shape, world
Long name (short name) |
Argument types |
Properties |
|
-absolute(-a)
|
|
|
|
preserve existing world object transformations
(overall object transformation is preserved
by modifying the objects local transformation)
If the object to parent is a joint, it will
alter the translation and joint orientation of
the joint to preserve the world object
transformation if this suffices. Otherwise, a
transform will be inserted between the joint
and the parent for this purpose. In this case,
the transformation inside the joint is not
altered.
[default]
|
|
-addObject(-add)
|
|
|
|
preserve existing local object transformations
but don't reparent, just add the object(s) under
the parent. Use -world to add the world as
a parent of the given objects.
|
|
-noConnections(-nc)
|
|
|
|
The parent command will normally generate
new instanced set connections when adding instances.
(ie. make a connection to the shading engine for
new instances) This flag suppresses this behaviour
and is primarily used by the file format.
|
|
-noInvScale(-nis)
|
|
|
|
The parent command will normally connect
inverseScale to its parent scale on joints.
This is used to compensate scale on joint.
The connection of inverseScale will occur if both child and parent are joints and no connection is present on child's inverseScale.
In case of a reparenting, the old inverseScale will only get broken if the old parent is a joint. Otherwise connection will remain intact.
This flag suppresses this behaviour.
|
|
-relative(-r)
|
|
|
|
preserve existing local object transformations
(relative to the parent node)
|
|
-removeObject(-rm)
|
|
|
|
Remove the immediate parent of every object specified. To remove only
a single instance of a shape from a parent, the path to the shape
should be specified.
Note: if there is a single parent then the object is effectively deleted from
the scene. Use -world to remove the world as a parent of the given object.
|
|
-shape(-s)
|
|
|
|
The parent command usually only operates on
transforms. Using this flags allows a shape
that is specified to be directly parented under
the given transform. This is used to instance
a shape node. (ie. "parent -add -shape" is
equivalent to the "instance" command).
This flag is primarily used by the file format.
|
|
-world(-w)
|
|
|
|
unparent given object(s) (parent to world)
|
|
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 some objects
circle -name circle1; move 5 0 0;
group -n group1; move -5 0 0;
group -em -n group2;
// Move the circle under group2.
// Note that the circle remains where it is.
parent circle1 group2;
// Let's try that again with the -relative flag. This time
// the circle will move.
undo;
parent -relative circle1 group2;
// Create an instance of the circle using the parent command.
// This makes circle1 a child of group1 and group2.
undo;
parent -add circle1 group2;
// Remove group1 as a parent of the circle
parent -removeObject group1|circle1;
// Move the circle to the top of the hierarchy
parent -world group2|circle1;
// Remove an instance of a shape from a parent
parent -shape -rm nurbsSphere3|nurbsSphereShape1;