pymel.core.animation.retarget

retarget(*args, **kwargs)

This command is used to take motion from one character and retarget it to a second character of a different size.

Flags:

• endFrame : end (int) [create]

  Specify the retargeting end frame. Default is 10.

• lowerBody : lb (unicode) [create]

  Specify the desired retargeting technique for the lower body. Valid options are: jointRotationsOnly, scaledFootPlacementand absoluteFootPlacement. Default is scaledFootPlacement.

• lowerScale : ls (unicode) [create]

  Specify the way scale is calculated for the lower body. Valid techniques are: hipToFoot, hipToToe, overallHeight, and other. This option is used when the lowerBody flag is set to anything other than jointRotationsOnly. Default is hipToFoot. When otheris used, the lowerScaleFactor flag should be used to specify the scale factor.

• lowerScaleFactor : lsf (float) [create]

  Specify the scale factor for the lower body. This option is only used when the lowerScale is set to other.

• maintainOffset : mo (bool) [create]

  When this flag is used, the root of the target character will stay the same distance from the source as at the rest pose.

• restPoseFrame : rpf (int) [create]

  The retargeting solution takes the rest pose of the characters into consideration. For example, one character may be bowlegged with respect to the other in the rest pose. When retargeting animation from the bowlegged character to the non-bowlegged character, the solution will take the rest pose into account so that the target character will receive the walk animation without the bowlegged aspects of the walk. The user has 2 options for specifying a restPose: specifying a frame number at which the rest pose is defined, or defining a retargeting rest pose using the Retargeting-SetRestPose menu item. If you use a frame number for the rest pose, the best practice is to use a frame that does not lie within the range of frames being retargeted. This allows you to retarget without wiping out the rest pose. Flag can have multiple arguments, passed either as a tuple or a list.

• scaleHandsFrom : shf (unicode) [create]

  Specify where the arms are scaled from. Valid arguments are: shoulder, rootand origin. This option is only used when the upperBody flag is set to scaledHandPlacement. Defaults is shoulder.

• startFrame : s (int) [create]

  Specify the retargeting start frame. Default is 0.

• upperBody : ub (unicode) [create]

  Specify the desired retargeting technique for the upper body. Valid techniques are: jointRotationsOnly, scaledHandPlacement, absoluteHandPlacementand maintainHandDistance. Default is jointRotationsOnly.

• upperScale : us (unicode) [create]

  Specify the way scale is calculated for the upper body. Valid techniques are: shoulderToWrist, shoulderToHand, followLower, and other. This option is used when the upperBody flag is set to anything other than jointRotationsOnly. Defaults is shoulderToHand. When otheris used, the upperScaleFactor flag should be used to specify the scale factor.

• upperScaleFactor : usf (float) [create]

  Specify the scale factor for the upper body. This option is used when the upperScale is set to other.

• useExistingKeys : uek (bool) [create]

  When this flag is used, the existing keys on the target are used as a hint to help guide the retargeting solution. This option sometimes allows the solver to narrow in on a better solution.

Derived from mel command maya.cmds.retarget