Go to: Synopsis. Return value. Related.
Flags. Python
examples.
parent( [dagObject...] [dagObject] ,
[absolute=boolean], [addObject=boolean], [noConnections=boolean], [relative=boolean], [removeObject=boolean], [shape=boolean], [world=boolean])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
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, relative, removeObject, shape, world
| Long name (short name) |
Argument types |
Properties |
world(w) |
boolean |
 |
|
unparent given object(s) (parent to world) |
|
relative(r) |
boolean |
|
|
preserve existing local object transformations (relative to the
parent node) |
|
absolute(a) |
boolean |
|
|
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) |
boolean |
|
|
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. |
|
removeObject(rm) |
boolean |
|
|
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) |
boolean |
|
|
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. |
|
noConnections(nc) |
boolean |
|
|
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 supresses this
behaviour and is primarily used by the file format. |
|
| 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 have multiple arguments, passed
either as a tuple or a list. |
import maya.cmds as cmds
# Create some objects
cmds.circle( name='circle1' )
cmds.move( 5, 0, 0 )
cmds.group( n='group1' )
cmds.move( -5, 0, 0 )
cmds.group( em=True, n='group2' )
# Move the circle under group2.
# Note that the circle remains where it is.
cmds.parent( 'circle1', 'group2' )
# Let's try that again with the -relative flag. This time
# the circle will move.
cmds.undo()
cmds.parent( 'circle1', 'group2', relative=True )
# Create an instance of the circle using the parent command.
# This makes circle1 a child of group1 and group2.
cmds.undo()
cmds.parent( 'circle1', 'group2', add=True )
# Remove group1 as a parent of the circle
cmds.parent( 'group1|circle1', removeObject=True )
# Move the circle to the top of the hierarchy
cmds.parent( 'group2|circle1', world=True )
# Remove an instance of a shape from a parent
cmds.parent('nurbsSphere3|nurbsSphereShape1',shape=True,rm=True)