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

Synopsis

pose [-allPoses] [-apply] [-name string]

pose is undoable, queryable, and editable.

This command is used to create character poses.

Flags

allPoses, apply, name
Long name (short name) [argument types] Properties
-name(-n) string createquery
In create mode, specify the pose name. In query mode, return a list of all the poses for the character. In apply mode, specify the pose to be applied.

In query mode, this flag needs a value.
-apply(-a) create
This flag is used in conjunction with the name flag to specify a pose should be applied to the character.
-allPoses(-ap) query
This flag is used to query all the poses in the scene.

In query mode, this flag needs a value.
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

Return value


[string] pose name

Keywords

character, clip, animation, pose

Related

character, clip, clipEditor, clipSchedule, pose

MEL examples

// First, create a character to hold the pose. The character will be
// a 3-bone skeleton named "arm".
//
select -d;
joint -p 0 0 0 ;
joint -p 0 4 0 ;
joint -e -zso -oj xyz joint1;
joint -p 0 8 -1 ;
joint -e -zso -oj xyz joint2;
joint -p 0 9 -2 ;
joint -e -zso -oj xyz joint3;
select -r joint1 joint2 joint3;
character -name arm;
// Create a pose for the current joint position named "handWave"
//
pose -name "handWave" "arm";
// Query the existing poses
//
pose -q -n "arm";
// Restore the pose onto the character
//
pose -name "handWave" -apply "arm";