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

概要

dgfilter [-attribute string] [-list] [-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) create
使用可能なフィルタをリスト表示します。-name フラグと一緒に使用すると、フィルタの説明を表示します。
-logicalAnd(-and) string string create
2 つのフィルタの論理積です。
-logicalNot(-not) string create
2 つのフィルタの否定です。
-logicalOr(-or) string string create
2 つのフィルタの論理和です。
-name(-n) string create
FILTER という名前のフィルタを使用します(または、その名前のフィルタを新規作成します)。オブジェクトを指定していない場合、フィルタに指定した名前が返されます。
-node(-nd) string create
ノード名がパターンに一致するオブジェクトを選択します。
-nodeType(-nt) string create
ノード タイプ名がパターンに一致するオブジェクトを選択します。
-plug(-p) string create
プラグ名がパターンに一致するオブジェクトを選択します。

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

MEL 例

dgfilter -atr translateX -n TX;	// Define attribute filter on translateX
// Result: "TX"
dgfilter -plug node.ty -n TY;	// Define plug filter on node.ty
// Result: "TY"
dgfilter -n OR -logicalOr TX TY;		// Define logical 'OR' filter.
// Result: "OR"

polyCube;
// Result: pCube1 polyCube1 //
polyCube;
// Result: pCube2 polyCube2 //

dgfilter -n TX pCube1.tx;			// Filter passes since attribute matches
// Result: 1
dgfilter -n OR pCube1.tx;			// Filter passes since TX portion succeeds
// Result: 1
dgfilter -n OR pCube1.tz;			// Filter fails ; wrong attributes
// Result: 0

dgfilter -n TY pCube2.ty;		// Filter fails ; wrong node
// Result: 0
dgfilter -n TY pCube1.ty;			// Filter passes
// Result: 1

dgfilter -list;					// List filters available
// Result: TX TY OR

dgfilter -list -n OR;			// Show filter information
// Result: "logicalOr( Plug(node.ty), Attribute(tx) )"