itemFilterAttr

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

概要

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

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

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

戻り値

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

フラグ

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

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

import maya.cmds as cmds

#    Create a filter that will pass all the SRT (scale-rotate-translate)
#    attributes.
#
srtFilter = cmds.itemFilterAttr('itemFilterAttr', scaleRotateTranslate=True)

#    Create a filter that will pass all the attributes driven by an
#    expression.
#
exprFilter = cmds.itemFilterAttr(hasExpression=True)

#    Create a filter that will pass all the SRT attributes driven by an
#    expression (intersect two previous ones).
#
srtExprFilter = cmds.itemFilterAttr(intersect=(srtFilter, exprFilter))

#    Delete the filters when done with them.
#
cmds.delete( srtFilter, exprFilter, srtExprFilter )