移動先: 概要 戻り値 関連項目 フラグ MEL の例

概要

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

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

このコマンドは指定したオブジェクトのアトリビュート値を返します。 該当する場合には UI ユニットが使用されます。 現在、表示できるアトリビュートのタイプは次のとおりです。

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

戻り値

Anyアトリビュートの値、または状態です。返される値の数とタイプは、アトリビュート タイプによって異なります。

関連項目

addAttr, attributeQuery, connectAttr, disconnectAttr, listAttr, setAttr

フラグ

asString, caching, channelBox, expandEnvironmentVariables, keyable, lock, multiIndices, settable, silent, size, time, type
ロング ネーム(ショート ネーム) 引数型 プロパティ
-keyable(-k) create
アトリビュートのキー設定可能な状態を返します。
-lock(-l) create
アトリビュートのロックされた状態を返します。
-type(-typ) create
アトリビュートで予想されるデータ型を返します。
-size(-s) create
マルチアトリビュート配列のサイズを返します。マルチでない場合は、1 を返します。
-time(-t) time create
カレント タイムでなく指定した時間にアトリビュートを評価します。
-silent(-sl) create
数値や文字列の値でないアトリビュートの評価時に、データを表示できないというエラー メッセージを表示しないようにします。データは表示されませんが、アトリビュートは評価されます。このフラグはすべてのエラー メッセージではなく、問題のないエラーのメッセージのみを対象とします。
-settable(-se) create
このアトリビュートが現在 setAttr で設定できる場合は 1 を、そうでない場合は 0 を返します。アトリビュートが、ロックされていない、コネクトされていない、またはキーフレームされたアニメーションがないといった場合は、設定できます。
-expandEnvironmentVariables(-x) create
返される文字列アトリビュート内の環境変数とチルダ文字(UNIX の場合)を展開します。
-asString(-as) create
このフラグは列挙型のアトリビュートの場合にだけ有効です。このフラグを使えば、アトリビュート値を整数ではなく文字列として取得することができます。 返される文字列の値は、Maya が実行している UI 言語(-uiLanguage)に依存することに注意してください。
-channelBox(-cb) create
アトリビュートがチャンネル ボックスで表示されるように設定されているかどうかを返します。 チャンネル ボックスにはキー設定可能なアトリビュートも表示されます。
-caching(-ca) create
アトリビュートが内部的にキャッシュされるように設定されているかどうかを返します。
-multiIndices(-mi) create
アトリビュートがマルチであれば、そのアトリビュートに有効なすべてのインデックスを含むリストを返します。

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

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 //