移動先: 概要 戻り値 フラグ. MEL 例.

概要

itemFilterAttr [-byName string] [-byNameString string] [-byScript string] [-classification string] [-hasCurve boolean] [-hasExpression boolean] [-hidden boolean] [-intersect string string] [-keyable boolean] [-listBuiltInFilters] [-listOtherFilters] [-listUserFilters] [-negate boolean] [-parent string] [-published boolean] [-readable boolean] [-scaleRotateTranslate boolean] [-secondScript string] [-text string] [-union string string] [-writable boolean] [string]

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

指定した項目フィルタ アトリビュート オブジェクトを作成するためのコマンドです。このオブジェクトをエディタに付加して、通過するアトリビュートをフィルタすることができます。論理和(Union)や論理積(Intersection)フィルタを使用して、複雑な合成フィルタを作成できます。

戻り値

string
string[]

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

フラグ

byName, byNameString, byScript, classification, hasCurve, hasExpression, hidden, intersect, keyable, listBuiltInFilters, listOtherFilters, listUserFilters, negate, parent, published, readable, scaleRotateTranslate, secondScript, text, union, writable
ロング ネーム(ショート ネーム) 引数型 プロパティ
-hidden(-h) boolean createqueryedit
ユーザに対して非表示になっているアトリビュートだけがフィルタを通過します。
-writable(-w) boolean createqueryedit
書き込み可能な(入力)アトリビュートだけがフィルタを通過します。
-readable(-r) boolean createqueryedit
読み出し可能な(出力)アトリビュートだけがフィルタを通過します。
-keyable(-k) boolean createqueryedit
キー設定可能なアトリビュートだけがフィルタを通過します。
-scaleRotateTranslate(-srt) boolean createqueryedit
SRT アトリビュート(スケール、回転、変換、およびこれらの子)だけがフィルタを通過します。
-hasExpression(-he) boolean createqueryedit
エクスプレッションによりドライブされるアトリビュートだけがフィルタを通過します。
-hasCurve(-hc) boolean createqueryedit
アニメーション カーブによりドライブされるアトリビュートだけがフィルタを通過します。
-published(-pub) boolean createqueryedit
コンテナにパブリッシュされたアトリビュートだけがフィルタを通過します。
-byName(-bn) string createqueryedit
指定した正規表現の文字列と一致する名前を持つ項目だけがフィルタを通過します。この文字列には、特殊文字「*」と「?」を含めることができます。「?」は任意の 1 文字のキャラクタに相当し、「*」は任意の従属文字列に相当します。
-byNameString(-bns) string createqueryeditmultiuse
指定した文字列と一致する名前の項目だけがフィルタを通過します。 これは多目的フラグで、複数の文字列を指定することができます。 いずれかの文字列が一致すれば、項目はフィルタを通過します。
-byScript(-bs) string createqueryedit
与えられた文字列で指定した名前を持つ MEL スクリプトが、各アトリビュート名に対して実行されます。スクリプトから 0 以外の値が返された場合、アトリビュートはフィルタを通過します。 スクリプト名の文字列は、次のシグネチャを持つ proc 名でなければなりません。
global proc int procName( string $nodeName string $attrName )
-secondScript(-ss) string createqueryedit
-bs フラグと併用します。2 番目のスクリプトは、リスト全体を個々にではなく、同時にフィルタリングするためのものです。このシグネチャは次のようになります。
global proc string[] procName( string[] $nodeName string[] $attrName )
これはアトリビュートのリストを取り込み、フィルタしたアトリビュートのリストを返します。
-union(-un) string string createqueryedit
このフィルタは、指定した文字列の名前を持つ 2 つのフィルタの論理和(Union)で構成されます。 含まれているフィルタの最低 1 つを通過できるアトリビュートは、このフィルタを通過できます。
-intersect(-in) string string createqueryedit
このフィルタは、指定した文字列の名前を持つ 2 つのフィルタの論理積(Intersection)で構成されます。 含まれている両方のフィルタを通過できる場合のみ、アトリビュートはこのフィルタを通過できます。
-negate(-neg) boolean createqueryedit
このフラグはフィルタ自身を反転させたり、 通過するものと通過しないものを逆転したりするために使用できます。
-parent(-p) string
このフラグは今ではサポートしていません。
-text(-t) string createqueryedit
フィルタを使用して格納する注釈文字列を定義します。
-classification(-cls) string createqueryedit
内部でのみ使用されます。フィルタが組み込みフィルタであるか、ユーザ定義フィルタであるかを指定します。文字列引数は「builtIn」、「user」、「other」のいずれかになります。
-listBuiltInFilters(-lbf) query
「builtIn」に分類されているアトリビュート フィルタすべての配列を返します。
-listUserFilters(-luf) query
「user」に分類されているアトリビュート フィルタすべての配列を返します。
-listOtherFilters(-lof) query
「other」に分類されているアトリビュート フィルタすべての配列を返します。

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

MEL 例

//    Create a filter that will pass all the SRT (scale-rotate-translate)
//    attributes.
//
string $srtFilter = `itemFilterAttr -scaleRotateTranslate true`;

//    Create a filter that will pass all the attributes driven by an
//    expression.
//
string $exprFilter = `itemFilterAttr -hasExpression true`;

//    Create a filter that will pass all the SRT attributes driven by an
//    expression (intersect two previous ones).
//
string $srtExprFilter = `itemFilterAttr -intersect $srtFilter $exprFilter`;

//    Delete the filters when done with them.
//
delete $srtFilter $exprFilter $srtExprFilter;