ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.
listAttr(
[objects]
, [array=boolean], [caching=boolean], [category=string], [changedSinceFileOpen=boolean], [channelBox=boolean], [connectable=boolean], [extension=boolean], [fromPlugin=boolean], [hasData=boolean], [hasNullData=boolean], [inUse=boolean], [keyable=boolean], [leaf=boolean], [locked=boolean], [multi=boolean], [output=boolean], [ramp=boolean], [read=boolean], [readOnly=boolean], [scalar=boolean], [scalarAndArray=boolean], [settable=boolean], [shortNames=boolean], [string=string], [unlocked=boolean], [usedAsFilename=boolean], [userDefined=boolean], [visible=boolean], [write=boolean])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
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)
|
boolean
|
|
|
読み込み可能なアトリビュートのみがリストされます。
|
|
write(w)
|
boolean
|
|
|
書き込み可能なアトリビュートのみがリストされます。
|
|
scalar(s)
|
boolean
|
|
|
array(a)
|
boolean
|
|
|
配列(マルチ以外)アトリビュートのみがリストされます。
|
|
scalarAndArray(sa)
|
boolean
|
|
|
スカラー アトリビュートと配列アトリビュートのみがリストされます。
|
|
visible(v)
|
boolean
|
|
|
可視アトリビュート、つまり隠れていないアトリビュートのみが表示されます。
|
|
connectable(c)
|
boolean
|
|
|
category(ct)
|
string
|
|
|
指定したカテゴリに属するアトリビュートのみを表示します。カテゴリの文字列には正規表現を使用できます。
|
|
fromPlugin(fp)
|
boolean
|
|
|
プラグインで作成されたアトリビュートのみを表示します
|
|
inUse(iu)
|
boolean
|
|
|
現在、使用中とマークされたアトリビュートのみを表示します。このフラグは、アトリビュートが何らかの方法でシーン データに作用していることを示します。たとえば、既定以外の値を持つか、別のアトリビュートに接続されています。これは一般的な例であり、実際はそれぞれ異なります。
|
|
keyable(k)
|
boolean
|
|
|
キーフレームにできるアトリビュートのみが表示されます。
|
|
channelBox(cb)
|
boolean
|
|
|
チャネル ボックスに表示されるキー設定不可のアトリビュートだけを表示します。
|
|
caching(ca)
|
boolean
|
|
|
内部的にキャッシュされているアトリビュートのみが表示されます。
|
|
extension(ex)
|
boolean
|
|
|
このタイプのすべてのノードのユーザ定義アトリビュート(拡張子アトリビュート)のリストを表示します。
|
|
multi(m)
|
boolean
|
|
|
マルチアトリビュートの既存の要素がリストされます。
|
|
locked(l)
|
boolean
|
|
|
ロックされているアトリビュートのみがリストされます。
|
|
unlocked(u)
|
boolean
|
|
|
ロックが解除されているアトリビュートのみがリストされます。
|
|
userDefined(ud)
|
boolean
|
|
|
ユーザ定義(ダイナミック)アトリビュートがリストされます。
|
|
settable(se)
|
boolean
|
|
|
shortNames(sn)
|
boolean
|
|
|
ショート アトリビュート ネームがリストされます。既定ではロング ネームがリストされます。
|
|
string(st)
|
string
|
|
|
他の基準に一致し、さらにこのフラグから渡された文字列に一致するアトリビュートのみを表示します。文字列には正規表現を使用できます。
|
|
readOnly(ro)
|
boolean
|
|
|
読み込み可能だが書き込み不可能なアトリビュートのみがリストされます。
|
|
output(o)
|
boolean
|
|
|
数値であるか、数値アトリビュートの複合であるアトリビュートのみがリストされます。
|
|
hasData(hd)
|
boolean
|
|
|
データを持つアトリビュートのみがリストされます(メッセージ アトリビュート以外すべてのアトリビュート)。
|
|
hasNullData(hnd)
|
boolean
|
|
|
ヌル データを持つアトリビュートのみがリストされます。データを持つすべてのアトリビュートがリストされますが(hasData フラグ参照)、データ値は初期化されません。アトリビュートがヌル データを持つ一般的な例として、文字列アトリビュートが作成されたが、初期値がまだ代入されていない場合が挙げられます。同様に、配列型データは初期化されるまでヌルの場合がよくあります。
|
|
leaf(lf)
|
boolean
|
|
|
アトリビュートの名前の末端のみがリストされます。controlPoints[44].xValue ならば、「xValue」とリストされます。
|
|
changedSinceFileOpen(cfo)
|
boolean
|
|
|
アトリビュートの元のファイルが開いてから変更されたアトリビュートのみがリストされます。特に、リファレンス ファイルのオブジェクトやアトリビュートのみに便利です。
|
|
ramp(ra)
|
boolean
|
|
|
usedAsFilename(uf)
|
boolean
|
|
|
ファイル名として扱われるように指定したアトリビュートのみをリスト表示します
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
cmds.sphere()
cmds.listAttr( r=True, s=True )
# This will list the scalar readable attributes of the
# selected nodes. If more than one node is selected attributes
# may be listed several times.
cmds.listAttr( s=True, r=True, w=True, c=True, st=['centerX','centerY'] )
# This will list all scalar, readable, writable, and connectable
# attributes whose names are "centerX" or "centerY".
cmds.listAttr( r=True, 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".
cmds.listAttr( 'nurbsSphere1', s=True, cfo=True )
# 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.