ジャンプ先: 概要. 戻り値. 関連. フラグ. MEL 例.

概要

listAttr [-array] [-caching] [-category string] [-changedSinceFileOpen] [-channelBox] [-connectable] [-extension] [-fromPlugin] [-hasData] [-hasNullData] [-inUse] [-keyable] [-leaf] [-locked] [-multi] [-output] [-ramp] [-read] [-readOnly] [-scalar] [-scalarAndArray] [-settable] [-shortNames] [-string string] [-unlocked] [-usedAsFilename] [-userDefined] [-visible] [-write] [objects]

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

ノードのアトリビュートがリストされます。フラグを指定しないと、すべてのアトリビュートがリストされます。

戻り値

string[]: 基準に一致するアトリビュートのリスト

関連

addAttr, attributeInfo, attributeQuery, connectAttr, disconnectAttr, getAttr, setAttr

フラグ

array, caching, category, changedSinceFileOpen, channelBox, connectable, extension, fromPlugin, hasData, hasNullData, inUse, keyable, leaf, locked, multi, output, ramp, read, readOnly, scalar, scalarAndArray, settable, shortNames, string, unlocked, usedAsFilename, userDefined, visible, write
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-read(-r) create
読み込み可能なアトリビュートのみがリストされます。
-write(-w) create
書き込み可能なアトリビュートのみがリストされます。
-scalar(-s) create
スカラー数値アトリビュートのみがリストされます。
-array(-a) create
配列(マルチ以外)アトリビュートのみがリストされます。
-scalarAndArray(-sa) create
スカラー アトリビュートと配列アトリビュートのみがリストされます。
-visible(-v) create
可視アトリビュート、つまり隠れていないアトリビュートのみが表示されます。
-connectable(-c) create
接続可能アトリビュートのみが表示されます。
-category(-ct) string createmultiuse
指定したカテゴリに属するアトリビュートのみを表示します。カテゴリの文字列には正規表現を使用できます。
-fromPlugin(-fp) create
プラグインで作成されたアトリビュートのみを表示します
-inUse(-iu) create
現在、使用中とマークされたアトリビュートのみを表示します。このフラグは、アトリビュートが何らかの方法でシーン データに作用していることを示します。たとえば、既定以外の値を持つか、別のアトリビュートに接続されています。これは一般的な例であり、実際はそれぞれ異なります。
-keyable(-k) create
キーフレームにできるアトリビュートのみが表示されます。
-channelBox(-cb) create
チャネル ボックスに表示されるキー設定不可のアトリビュートだけを表示します。
-caching(-ca) create
内部的にキャッシュされているアトリビュートのみが表示されます。
-extension(-ex) create
このタイプのすべてのノードのユーザ定義アトリビュート(拡張子アトリビュート)のリストを表示します。
-multi(-m) create
マルチアトリビュートの既存の要素がリストされます。
-locked(-l) create
ロックされているアトリビュートのみがリストされます。
-unlocked(-u) create
ロックが解除されているアトリビュートのみがリストされます。
-userDefined(-ud) create
ユーザ定義(ダイナミック)アトリビュートがリストされます。
-settable(-se) create
設定可能なアトリビュートがリストされます。
-shortNames(-sn) create
ショート アトリビュート ネームがリストされます。既定ではロング ネームがリストされます。
-string(-st) string createmultiuse
他の基準に一致し、さらにこのフラグから渡された文字列に一致するアトリビュートのみを表示します。文字列には正規表現を使用できます。
-readOnly(-ro) create
読み込み可能だが書き込み不可能なアトリビュートのみがリストされます。
-output(-o) create
数値であるか、数値アトリビュートの複合であるアトリビュートのみがリストされます。
-hasData(-hd) create
データを持つアトリビュートのみがリストされます(メッセージ アトリビュート以外すべてのアトリビュート)。
-hasNullData(-hnd) create
ヌル データを持つアトリビュートのみがリストされます。データを持つすべてのアトリビュートがリストされますが(hasData フラグ参照)、データ値は初期化されません。アトリビュートがヌル データを持つ一般的な例として、文字列アトリビュートが作成されたが、初期値がまだ代入されていない場合が挙げられます。同様に、配列型データは初期化されるまでヌルの場合がよくあります。
-leaf(-lf) create
アトリビュートの名前の末端のみがリストされます。controlPoints[44].xValue ならば、「xValue」とリストされます。
-changedSinceFileOpen(-cfo) create
アトリビュートの元のファイルが開いてから変更されたアトリビュートのみがリストされます。特に、リファレンス ファイルのオブジェクトやアトリビュートのみに便利です。
-ramp(-ra) create
ランプであるアトリビュートのみをリスト表示します
-usedAsFilename(-uf) create
ファイル名として扱われるように指定したアトリビュートのみをリスト表示します

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

MEL 例

listAttr -r -s;
     // This will list the scalar readable attributes of the
     // selected nodes.  If more than one node is selected attributes
     // may be listed several times.

listAttr -s -r -w -c -st centerX -st centerY;
     // This will list all scalar, readable, writable, and connectable
     // attributes whose names are "centerX" or "centerY".

listAttr -r -st "center*" -ct "a*";
     // This will list all readable attributes whose names match
	 // "center*" (e.g. "centerX" or "centerpede") and who belong to
	 // a category starting with the letter "a".

listAttr -s -cfo nurbsSphere1;
     // This will list all scalar attributes of
     // nurbsSphere1 that have been changed since the
     // file in which nurbsSphere1 is defined has been
     // opened.  If nurbsSphere1 comes from a referenced file,
     // the result will be all the attributes that have changed
       // since the referenced file was opened.