character

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

概要

character [-addElement name] [-characterPlug] [-clear name] [-empty] [-excludeDynamic] [-excludeRotate] [-excludeScale] [-excludeTranslate] [-excludeVisibility] [-flatten name] [-forceElement name] [-include name] [-intersection name] [-isIntersecting name] [-isMember name] [-library] [-memberIndex uint] [-name string] [-noWarnings] [-nodesOnly] [-offsetNode] [-remove name] [-root string] [-scheduler] [-split name] [-subtract name] [-text string] [-union name] [-userAlias name] objects

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

戻り値

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

関連項目

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
-name(-n)	string
新しいキャラクタの名前として文字列を割り当てます。新しいキャラクタを作成する操作に対して有効です。
-text(-t)	string
キャラクタと共に格納される注釈の文字列を定義します。
-empty(-em)
作成するキャラクタを空にする必要があることを示します。つまり、キャラクタに追加するオブジェクトを識別する引数がすべて無視されます。
-subtract(-sub)	name
2 つのキャラクタ間の操作で、2 番目のキャラクタにない最初のキャラクタのメンバーを返します。通常、キャラクタは相互排他的にする必要があります。
-union(-un)	name
リストされたキャラクタすべてのリストを返す操作です。
-intersection(-int)	name
リストのキャラクタすべてのメンバーである項目のリストを返す操作です。通常、キャラクタは相互排他的にする必要があります。
-clear(-cl)	name
指定したキャラクタからすべての項目を削除する操作です。
-flatten(-fl)	name
指定したキャラクタの構造を平坦化する操作です。つまり、指定したキャラクタに含まれるキャラクタはすべてそのメンバーで置き換えられ、そのキャラクタはほかのキャラクタではなく、キャラクタのメンバーを含むようになります。
-nodesOnly(-no)
このフラグは、メンバーシップが照会するキャラクタの結果を修正します。 キャラクタに含まれた sphere1.tx などのアトリビュートをリストするとき、ノードだけをリストします。キャラクタにノードのアトリビュートまたはコンポーネントが複数存在する場合でも、各ノードは一度だけリストされます。
-isIntersecting(-ii)	name
リストのキャラクタが共通メンバーを持つかどうかをテストする操作です。通常、キャラクタは、常に false を返すように相互排他的にする必要があります。
-isMember(-im)	name
指定した項目がすべて指定したキャラクタのメンバーであるかどうかをテストする操作です。
-split(-sp)	name
項目リストを持つ新しいセットを作成し、指定したセットから項目リスト内の各項目を削除します。
-noWarnings(-nw)
無効な項目をキャラクタに追加する場合などに、警告メッセージが発生してはならないことを示します （UI で使用）。
-addElement(-add)	name
指定したキャラクタに項目リストを追加します。別のキャラクタにあるためキャラクタに追加できない項目がある場合、このコマンドは失敗します。別のキャラクタは -addElement に渡されると、サブ キャラクタとして追加されます。ノードが渡されるとキー設定可能なアトリビュートに展開されて、キャラクタに追加されます。
-include(-in)	name
指定したキャラクタに項目リストを追加します。キャラクタに追加できない項目がある場合は、警告メッセージが発生します。 これは、-add/addElement 操作よりも厳密性に欠けます。
-remove(-rm)	name
指定したキャラクタの項目リストを削除します。
-forceElement(-fe)	name
編集モードのみで使用してください。項目を強制的にキャラクタに追加します。項目が characterPartition にある別のキャラクタにあれば、別のキャラクタから削除され、characterPartition のキャラクタは通常メンバーシップに対して相互排他的になります。
-excludeTranslate(-et)
キャラクタを作成するときに、Transform-type ノードから Translate アトリビュートを除外します。たとえば、キャラクタにジョイントだけが含まれている場合に、そのキャラクタに回転だけを含めたいことがあります。
-excludeRotate(-er)
キャラクタを作成するときに、Transform-type ノードから Rotate アトリビュートを除外します。
-excludeScale(-es)
キャラクタを作成するときに、Transform-type ノードから Scale アトリビュートを除外します。
-excludeVisibility(-ev)
キャラクタを作成するときに、Transform-type ノードから Visibility アトリビュートを除外します。
-excludeDynamic(-ed)
キャラクタを作成するときに、Dynamic アトリビュートを除外します。
-userAlias(-ua)	name
キャラクタの指定したアトリビュートのユーザ定義エイリアスを返します。定義されていなければ、空の文字列を返します。キャラクタは、キャラクタ アニメーション データを格納するアトリビュートに自動的にエイリアスを作成します。自動的に設定されたエイリアスが aliasAttr コマンドで置き換えられた場合、ユーザが設定したエイリアスが存在します。
-characterPlug(-cp)
指定したキャラクタ メンバーに対応するキャラクタのプラグを返します。
-scheduler(-sc)
このキャラクタに関連付けられたスケジューラがあれば返します。スケジューラがあるのは、キャラクタにクリップを作成した場合だけです。
-library(-lib)
このキャラクタに関連付けられたクリップ ライブラリがあれば返します。クリップ ライブラリがあるのは、キャラクタにクリップを作成した場合だけです。
-memberIndex(-mi)	uint
Query フラグの後に使用すると、指定したキャラクタ メンバーの memberIndex を返します。または、照会フラグの前に使用すると、指定したインデックスに対応するメンバーを返します。
-root(-rt)	string
作成しているキャラクタのルートとして動作するトランスフォーム ノードを指定します。 このコマンドは、キャラクタ ノードの他に characterOffset ノードを作成します。characterOffset ノードを使えば、キャラクタにオフセットを追加して、階層内にノードを追加しなくてもキャラクタのアニメーションの方向を変更することができます。
-offsetNode(-ofs)
キャラクタのルートにオフセットを追加するために使用する characterOffset ノードの名前を返します。

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

MEL の例

// create two characters with whatever is currently active
character;
character;

// create a set which contains two sub characters
character -n parentCharacter character1 character2;

// Add the keyable attributes of ikHandle1 to a character
character -add character1 ikHandle1;

// Remove the scale attributes for a transform from a character
character -remove character1 sphere1.sx sphere1.sy sphere1.sz;

// Query the members of the character
string $members[] = `character -q character1`;

// Query the character plug for a specified member
character -q -cp $members[0];

// Query the library and scheduler of the character
character -q -library character1;
character -q -sc character2;