Go to: Synopsis. Return value. Related.
Flags. Python
examples.
mirrorJoint( object , [mirrorBehavior=boolean], [mirrorXY=boolean], [mirrorXZ=boolean], [mirrorYZ=boolean], [searchReplace=[string,
string]])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
mirrorJoint is undoable, NOT queryable, and NOT
editable.
This command will duplicate a branch of the skeleton from the
selected joint symmetrically about a plane in world space. There
are three mirroring modes(xy-, yz-, xz-plane).
string[] |
Names of the mirrored joints |
connectJoint, ikHandle, ikHandleDisplayScale, ikSolver, ikSystem,
ikSystemInfo, insertJoint, joint,
jointCluster, jointDisplayScale, jointLattice, removeJoint, removeJoint
mirrorBehavior, mirrorXY, mirrorXZ,
mirrorYZ, searchReplace
Long name (short name) |
Argument types |
Properties |
mirrorXY(mxy) |
boolean |
|
|
mirror skeleton from the selected joint about xy-plane in world
space. |
|
mirrorYZ(myz) |
boolean |
|
|
mirror skeleton from the selected joint about yz-plane in world
space. |
|
mirrorXZ(mxz) |
boolean |
|
|
mirror skeleton from the selected joint about xz-plane in world
space. |
|
mirrorBehavior(mb) |
boolean |
|
|
The mirrorBehavior flag is used to specify that when performing
the mirror, the joint orientation axes should be mirrored such that
equal rotations on the original and mirrored joints will place the
skeleton in a mirrored position (symmetric across the mirroring
plane). Thus, animation curves from the original joints can be
copied to the mirrored side to produce a similar (but symmetric)
behavior. When mirrorBehavior is not specified, the joint
orientation on the mirrored side will be identical to the source
side. |
|
searchReplace(sr) |
[string, string] |
|
|
After performing the mirror, rename the new joints by searching
the name for the first specified string and replacing it with the
second specified string. |
|
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 a mirrored branch of the skeleton starting from the joint "jointName"
# about the yz-plane.
# Joint orientations on the mirrored side will be identical to the source side.
#
cmds.mirrorJoint( 'jointName' )
# Create a mirrored branch of the skeleton starting from the joint "jointName"
# about the yz-plane.
# Joint orientations on the mirrored side will be mirrored from the source side.
#
cmds.mirrorJoint('jointName',mirrorBehavior=True,myz=True)
# Create a mirrored branch of the skeleton starting from the selected joint
# about the xy-plane.
# Joint orientations on the mirrored side will be mirrored from the source side.
# Joint names on the duplicated side will contain the string "right_" if
# the corresponding joint on the original side contained the string "left_".
#
cmds.mirrorJoint(mirrorXY=True,mirrorBehavior=True,searchReplace=('left_', 'right_') )