pymel.core.animation.characterMap

characterMap(*args, **kwargs)

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

Flags:

• mapAttr : ma (unicode, unicode) [create,query,edit]

  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 (unicode) [create]

  This is is valid in create mode only. It specifies how the mapping should be done. Valid options are: byNodeName, byAttrName, and byAttrOrder. byAttrOrderis the default. The flags mean the following: byAttrOrdermaps using the order that the character stores the attributes internally, byAttrNameuses the attribute name to find a correspondence, byNodeNameuses the node name *and* the attribute name to find a correspondence.

• mapNode : mn (unicode, unicode) [create,query]

  This flag can be used to map all the attributes on the source node to their matching attributes on the destination node.

• mapping : m (unicode) [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 (bool) [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 (unicode, unicode) [create,edit]

  This flag can be used to unmap the mapping stored by the specified map node.

• unmapNode : umn (unicode, unicode) [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 have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.characterMap