characterMap

移動先: 概要 戻り値 キーワード 関連項目 フラグ MEL の例

概要

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

characterMap は「元に戻す」が可能、「照会」が可能、「編集」が可能です。

戻り値

戻り値の型は照会モードでは照会フラグが基になります。

キーワード

関連項目

フラグ

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

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: 1 つのコマンドで複数回使用可能なフラグ

MEL の例

// 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;