character

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

概要

character( objects , [addElement=name], [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], [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 で使用）。
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
キャラクタを作成するときに、Dynamic アトリビュートを除外します。
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 )