getAttr

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

概要

getAttr [-asString] [-caching] [-channelBox] [-expandEnvironmentVariables] [-keyable] [-lock] [-multiIndices] [-noEvaluation] [-settable] [-silent] [-size] [-time time] [-type] attribute

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

Ufe アトリビュートの場合、入力アトリビュートの文字列は、「<ufe_path_string>.<ufe_attribute_name>」にする必要があります。

該当する場合には UI ユニットが使用されます。

現在、表示できるアトリビュートのタイプは次のとおりです。

• 数値アトリビュート
• 文字列アトリビュート
• 行列アトリビュート
• 数値複合アトリビュート(子アトリビュートがすべて数値)
• ベクトル配列アトリビュート
• 二重配列アトリビュート
• int32 配列アトリビュート
• ポイント配列アトリビュート
• データ コンポーネント リスト アトリビュート
• Ufe アトリビュート

その他のデータ タイプのアトリビュートは読み出しできません。アトリビュートにデータが含まれない場合、結果は返されません。

戻り値

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-asString(-as)
このフラグは列挙型のアトリビュートの場合にだけ有効です。このフラグを使えば、アトリビュート値を整数ではなく文字列として取得することができます。返される文字列の値は、Maya が実行している UI 言語(-uiLanguage)に依存することに注意してください。 Ufe アトリビュートではサポートされていません。
-caching(-ca)
アトリビュートが内部的にキャッシュされるように設定されているかどうかを返します。 Ufe アトリビュートではサポートされていません。
-channelBox(-cb)
アトリビュートがチャネル ボックス(Channel Box)で表示されるように設定されているかどうかを返します。チャネル ボックス(Channel Box)にはキー設定可能なアトリビュートも表示されます。 Ufe アトリビュートではサポートされていません。チャネル ボックス(Channel Box)における Ufe アトリビュートの表示は、channelBox コマンドの -ual/ufeFixedAttrList フラグを使用して制御します。
-expandEnvironmentVariables(-x)
返される文字列アトリビュート内の環境変数とチルダ文字(UNIX の場合)を展開します。 Ufe アトリビュートではサポートされていません。
-keyable(-k)
アトリビュートのキー設定可能な状態を返します。 Ufe アトリビュートではサポートされていません。
-lock(-l)
アトリビュートのロックされた状態を返します。
-multiIndices(-mi)
アトリビュートがマルチであれば、そのアトリビュートに有効なすべてのインデックスを含むリストを返します。 Ufe アトリビュートではサポートされていません。
-noEvaluation(-ne)
ダーティな値は再評価しないで、ノードで現在使用可能な値のみを返します(値が存在する場合) Ufe アトリビュートではサポートされていません。
-settable(-se)
このアトリビュートが現在 setAttr で設定できる場合は 1 を、そうでない場合は 0 を返します。アトリビュートが、ロックされていない、接続されていない、またはキーフレームされたアニメーションがないといった場合は、設定できます。 Ufe アトリビュートの場合、ロックされていなければ設定できます。
-silent(-sl)
数値や文字列の値でないアトリビュートの評価時に、データを表示できないというエラー メッセージを表示しないようにします。データは表示されませんが、アトリビュートは評価されます。このフラグはすべてのエラー メッセージではなく、問題のないエラーのメッセージのみを対象とします。 Ufe アトリビュートではサポートされていません。
-size(-s)
マルチアトリビュート配列のサイズを返します。マルチでない場合は、1 を返します。 Ufe アトリビュートではサポートされていません。
-time(-t)	time
現在のタイムでなく指定した時間にアトリビュートを評価します。 Ufe アトリビュートではサポートされていません。
-type(-typ)
アトリビュートの現在のデータ型を返します。 文字列や数値などの単純な型のアトリビュートには常にデータが含まれていますが、配列やメッシュなどの複雑な型のアトリビュートには、それまでに何も割り当てられていない場合、データが含まれないことがあります。これが発生すると、コマンドで結果が返されません。空の文字列が返されるのではなく、結果がまったく返されません。この存在しない結果を別の値と直接比較しようとしたり、エクスプレッションで使用しようとしてもエラーが発生しますが、これを変数に割り当て、型の既定値に変数を設定することができます(たとえば、文字列変数には空の文字列、整数変数には 0、配列変数には空の配列)。このフラグを使用したときに安全にするため、結果は常に文字列変数に割り当てるようにし、直接使用しようとはしないでください。

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

MEL 例

createNode revolve -n gravityWell;
sphere -n loxTank;
cone -n noseCone;
cone -n fin;
pointConstraint -n weld fin noseCone;

float  $angle    = `getAttr gravityWell.esw`;
// Result: 360 //
string $type     = `getAttr -type loxTank.translate`;
// Result: double3 //
int    $lock     = `getAttr -lock noseCone.translateX`;
// Result: 0 //
float  $finZ     = `getAttr -time 12 fin.translateZ`;
// Result: 0 //
int    $size     = `getAttr -size weld.target`;
// Result: 1 //
int    $size     = `getAttr -settable weld.target`;
// Result: 0 //
float  $matrix[] = `getAttr loxTank.matrix`;
// Result: 1 0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 //
createNode file -n file1;
setAttr file1.ftn -type "string" "$TMPDIR/smile.gif";
string $s = `getAttr file1.ftn`;
// Result: $TMPDIR/smile.gif //
string $s = `getAttr -x file1.ftn`;
// Result: /var/tmp/smile.gif //

// Get the list of all used indices on a multi attribute
getAttr -multiIndices initialShadingGroup.dagSetMembers
// Result: 0 1 2 //