ジャンプ先: 概要. 戻り値. キーワード. 関連. フラグ. Python 例.

概要

characterMap([mapAttr=[string, string]], [mapMethod=string], [mapNode=[string, string]], [mapping=string], [proposedMapping=boolean], [unmapAttr=[string, string]], [unmapNode=[string, string]])

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

characterMap は、取り消し可能、照会可能、および 編集可能 です。

このコマンドは、複数のキャラクタのアトリビュートの相関関係を作成するために使用します。

戻り値

stringcharacterMap 名

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

キーワード

character, clip, animation

関連

bakeClip, character, clip, clipEditor, clipSchedule

フラグ

mapAttr, mapMethod, mapNode, mapping, proposedMapping, unmapAttr, unmapNode
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
mapAttr(ma) [string, string] createqueryedit
照会モードでこのフラグを使って、指定したマップ ノードに格納されたマッピング情報を照会でき、文字配列が返されます。照会モード以外では、このフラグを使って指定したキャラクタ メンバーのマッピング関係を作成できます。新しく指定したマッピングが優先され、以前のアトリビュートのマッピング情報はすべて除去されます。
unmapAttr(ua) [string, string] createedit
このフラグを使用して、指定したマップ ノードに格納されたマッピングを解除できます。
mapping(m) string query
このフラグは照会モードのみで有効です。文字列引数がある照会フラグの前に使用する必要があります。特定のアトリビュートのマッピングを照会するために使用し、文字配列が返されます。
proposedMapping(pm) boolean query
このフラグは照会モードのみで有効です。指定したキャラクタと指定した mappingMethod (オプション)でコールした場合、キャラクタ マップが提供するマッピングの配列を取得するために使用します。キャラクタにキャラクタ マップが存在する場合、マップは照会操作の影響を受けず、文字配列が返されます。
mapMethod(mm) string create
これは作成モードのみで有効で、マッピングの方法を指定します。有効なオプションは、「byNodeName」、「byAttrName」、「byAttrOrder」で、既定は「byAttrOrder」です。これらのフラグの意味は次の通りです。「byAttrOrder」は、キャラクタが内部的にアトリビュートを格納する順番を使用してマッピングします。「byAttrName」は、アトリビュート名を使用して一致を検索します。「byNodeName」はノード名とアトリビュート名を使用して一致を検索します。
mapNode(mn) [string, string] createquery
このフラグを使用して、ソース ノードのすべてのアトリビュートを対象ノードの一致するアトリビュートにマッピングできます。
unmapNode(umn) [string, string] create
このフラグを使用して、ソース ノードのすべてのアトリビュートと対象ノードの一致するアトリビュートとのマッピングを解除できます。マッピングされたアトリビュートのうち、名前が一致しないものはマッピング解除されません。

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

# Create a mapping between character1 and character2, or if a map already
# exists, update the mapping between any unmapped members.
#
cmds.characterMap( 'character1', 'character2' )
# Query as to whether a mapping exists between two characters
#
cmds.characterMap( 'character1', 'character2', query=True )
# Query which attributes are mapped between two characters
#
cmds.characterMap( 'character1', 'character2', query=True, mapAttr=True )
# Delete the mapping between two pairs of attributes. If no mapping
# exists between the attributes, nothing will happen.
#
cmds.characterMap( 'character1', 'character2', unmapAttr=('sphere1.tx','sphere2.tx') )
# Add a mapping between two attributes.  Only attributes that
# are members of characters can be mapped.
#
cmds.characterMap( 'character1', 'character2', mapAttr=('sphere1.tx','sphere2.tx') )
# Query what attribute(s) are mapped to sphere1.tx between character1 and
# character2
#
cmds.characterMap( 'character1', 'character2', mapping='sphere1.tx' )