character

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

概要

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

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

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

戻り値

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

関連

フラグ

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

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

Python 例

import maya.cmds as cmds

# create two characters with whatever is currently active
cmds.character()
cmds.character()

# create a set which contains two sub characters
cmds.character( 'character1', 'character2', n='parentCharacter' )

# Add the keyable attributes of ikHandle1 to a character
cmds.character( 'ikHandle1', add='character1' )

# Remove the scale attributes for a transform from a character
cmds.character( 'sphere1.sx', 'sphere1.sy', 'sphere1.sz', remove='character1' )

# Query the members of the character
members = cmds.character('character1', query=True)

# Query the character plug for a specified member
cmds.character( members[0], q=True, cp=True )

# Query the library and scheduler of the character
cmds.character( 'character1', q=True, library=True )
cmds.character( 'character2', q=True, sc=True )

# Add the sphere as an offset object on the character
cmds.character( 'pSphere1', e=True, addOffsetObject = 'character1' )