Go to: Synopsis. Return value. Related. Flags. MEL examples.

Synopsis

mirrorJoint [-mirrorBehavior] [-mirrorXY] [-mirrorXZ] [-mirrorYZ] [-searchReplace string string] object

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).

Return value

string[]Names of the mirrored joints

Related

connectJoint, ikHandle, ikHandleDisplayScale, ikSolver, ikSystem, ikSystemInfo, insertJoint, joint, jointCluster, jointDisplayScale, jointLattice, removeJoint, removeJoint

Flags

mirrorBehavior, mirrorXY, mirrorXZ, mirrorYZ, searchReplace
Long name (short name) Argument types Properties
-mirrorXY(-mxy) create
mirror skeleton from the selected joint about xy-plane in world space.
-mirrorYZ(-myz) create
mirror skeleton from the selected joint about yz-plane in world space.
-mirrorXZ(-mxz) create
mirror skeleton from the selected joint about xz-plane in world space.
-mirrorBehavior(-mb) create
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 create
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 be used more than once in a command.

MEL examples

// 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.
//
mirrorJoint -myz 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.
//
mirrorJoint -mirrorBehavior -myz jointName;

// 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_".
//
mirrorJoint -mirrorXY -mirrorBehavior -searchReplace "left_" "right_";