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

概要

dgfilter([attribute=string], [list=boolean], [logicalAnd=[string, string]], [logicalNot=string], [logicalOr=[string, string]], [name=string], [node=string], [nodeType=string], [plug=string])

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

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

dgfilter コマンドを使用して、特定の基準に基づいて DG オブジェクトを選択するディペンデンシー グラフ フィルタを定義します。このコマンドで、オブジェクトをフィルタすることも、dbtrace オブジェクトにアタッチしてトレースする出力をフィルタすることもできます。オブジェクトを指定した場合、それらのオブジェクトにフィルタが適用され、通過したかどうかを示すブーリアン値が返されます。指定しなかった場合、フィルタの名前が返されます。無効なフィルタの場合、すべてのオブジェクトが通過します。複数のオブジェクトの場合、戻り値は全オブジェクトの戻り値の論理積です。

戻り値

stringフィルタを作成、またはフィルタ情報を取得する場合
string[]フィルタをリスト表示する場合
booleanフィルタを適用する場合

キーワード

dg, dependency, graph, alias, attribute, name

フラグ

attribute, list, logicalAnd, logicalNot, logicalOr, name, node, nodeType, plug
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
attribute(atr) string create
アトリビュート名がパターンに一致するオブジェクトを選択します。
list(l) boolean create
使用可能なフィルタをリスト表示します。-name フラグと一緒に使用すると、フィルタの説明を表示します。
logicalAnd(logicalAnd) [string, string] create
2 つのフィルタの論理積です。
logicalNot(logicalNot) string create
2 つのフィルタの否定です。
logicalOr(logicalOr) [string, string] create
2 つのフィルタの論理和です。
name(n) string create
FILTER という名前のフィルタを使用します(または、その名前のフィルタを新規作成します)。オブジェクトを指定していない場合、フィルタに指定した名前が返されます。
node(nd) string create
ノード名がパターンに一致するオブジェクトを選択します。
nodeType(nt) string create
ノード タイプ名がパターンに一致するオブジェクトを選択します。
plug(p) string create
プラグ名がパターンに一致するオブジェクトを選択します。
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

# Define attribute filter on translateX
cmds.dgfilter( atr='translateX', n='TX' )
# Result: "TX"

# Define plug filter on node.ty
cmds.dgfilter( plug='node.ty', n='TY' )
# Result: "TY"

# Define logical 'OR' filter.
cmds.dgfilter( logicalOr=('TX', 'TY'), n='OR' )
# Result: "OR"

cmds.polyCube()
# Result: [u'pCube1', u'polyCube1'] #
cmds.polyCube()
# Result: [u'pCube2', u'polyCube2'] #

# Filter passes since attribute matches
cmds.dgfilter( 'pCube1.tx', n='TX' )
# Result: 1

# Filter passes since TX portion succeeds
cmds.dgfilter( 'pCube1.tx', n='OR' )
# Result: 1

# Filter fails ; wrong attributes
cmds.dgfilter( 'pCube1.tz', n='OR' )
# Result: 0

# Filter fails ; wrong node
cmds.dgfilter( 'pCube2.ty', n='TY' )
# Result: 0

# Filter passes
cmds.dgfilter( 'pCube1.ty', n='TY' )
# Result: 1

# List filters available
cmds.dgfilter( list=True )
# Result: [u'TX', u'TY', u'OR'] #

# Show filter information
cmds.dgfilter( list=True, n='OR' )
# Result: LogicalOr( AttributeName(translateX), PlugName(node.ty) )