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

Synopsis

characterMap [-mapAttr string string] [-mapMethod string] [-mapNode string string] [-mapping string] [-proposedMapping] [-unmapAttr string string] [-unmapNode string string]

characterMap is undoable, queryable, and editable.

This command is used to create a correlation between the attributes of 2 or more characters.

Return value

stringcharacterMap name

In query mode, return type is based on queried flag.

Keywords

character, clip, animation

Related

bakeClip, character, clip, clipEditor, clipSchedule

Flags

mapAttr, mapMethod, mapNode, mapping, proposedMapping, unmapAttr, unmapNode
Long name (short name) Argument types Properties
-mapAttr(-ma) string string createqueryedit
In query mode, this flag can be used to query the mapping stored by the specified map node. It returns an array of strings. In non-query mode, this flag can be used to create a mapping between the specified character members. Any previous mapping on the attributes is removed in favor of the newly specified mapping.
-mapMethod(-mm) string create
This is is valid in create mode only. It specifies how the mapping should be done. Valid options are: "byNodeName", "byAttrName", and "byAttrOrder". "byAttrOrder" is the default. The flags mean the following: "byAttrOrder" maps using the order that the character stores the attributes internally, "byAttrName" uses the attribute name to find a correspondence, "byNodeName" uses the node name *and* the attribute name to find a correspondence.
-mapNode(-mn) string string createquery
This flag can be used to map all the attributes on the source node to their matching attributes on the destination node.
-mapping(-m) string query
This flag is valid in query mode only. It must be used before the query flag with a string argument. It is used for querying the mapping for a particular attribute. A string array is returned.
-proposedMapping(-pm) query
This flag is valid in query mode only. It is used to get an array of the mapping that the character map would prvide if called with the specified characters and the (optional) specified mappingMethod. If a character map exists on the characters, the map is not affected by the query operation. A string array is returned.
-unmapAttr(-ua) string string createedit
This flag can be used to unmap the mapping stored by the specified map node.
-unmapNode(-umn) string string create
This flag can be used to unmap all the attributes on the source node to their matching attributes on the destination node. Note that mapped attributes which do not have matching names, will not be unmapped.

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 mapping between character1 and character2, or if a map already
// exists, update the mapping between any unmapped members.
//
characterMap character1 character2;

// Query as to whether a mapping exists between two characters
//
characterMap -q character1 character2;

// Query which attributes are mapped between two characters
//
characterMap -q -mapAttr character1 character2;

// Delete the mapping between two pairs of attributes. If no mapping
// exists between the attributes, nothing will happen.
//
characterMap -unmapAttr sphere1.tx cone1.tx character1 character2;

// Add a mapping between two attributes.  Only attributes that
// are members of characters can be mapped.
//
characterMap -mapAttr sphere1.tx sphere2.tx character1 character2;

// Query what attribute(s) are mapped to sphere1.tx between character1 and
// character2
//
characterMap -mapping sphere1.tx character1 character2;