setAttr

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

概要

setAttr [-alteredValue] [-caching boolean] [-channelBox boolean] [-clamp] [-keyable boolean] [-lock boolean] [-size uint] [-type string] attribute Any [Any...]

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

• {TYPE} はスペースで区切られた任意の数のタイプ（TYPE）の値を意味します。
• [TYPE] はタイプ（TYPE）の値がオプションであることを意味します。
• A|B は A または B のいずれかを表示できることを意味します。

sphere -n node;
addAttr -ln short2Attr -at short2;
addAttr -ln short2a -p short2Attr -at short;
addAttr -ln short2b -p short2Attr -at short;
addAttr -ln short3Attr -at short3;
addAttr -ln short3a -p short3Attr -at short;
addAttr -ln short3b -p short3Attr -at short;
addAttr -ln short3c -p short3Attr -at short;
addAttr -ln long2Attr -at long2;
addAttr -ln long2a -p long2Attr -at long;
addAttr -ln long2b -p long2Attr -at long;
addAttr -ln long3Attr -at long3;
addAttr -ln long3a -p long3Attr -at long;
addAttr -ln long3b -p long3Attr -at long;
addAttr -ln long3c -p long3Attr -at long;
addAttr -ln float2Attr -at float2;
addAttr -ln float2a -p float2Attr -at "float";
addAttr -ln float2b -p float2Attr -at "float";
addAttr -ln float3Attr -at float3;
addAttr -ln float3a -p float3Attr -at "float";
addAttr -ln float3b -p float3Attr -at "float";
addAttr -ln float3c -p float3Attr -at "float";
addAttr -ln double2Attr -at double2;
addAttr -ln double2a -p double2Attr -at double;
addAttr -ln double2b -p double2Attr -at double;
addAttr -ln double3Attr -at double3;
addAttr -ln double3a -p double3Attr -at double;
addAttr -ln double3b -p double3Attr -at double;
addAttr -ln double3c -p double3Attr -at double;
addAttr -ln int32ArrayAttr -dt Int32Array;
addAttr -ln doubleArrayAttr -dt doubleArray;
addAttr -ln pointArrayAttr -dt pointArray;
addAttr -ln vectorArrayAttr -dt vectorArray;
addAttr -ln stringArrayAttr -dt stringArray;
addAttr -ln stringAttr -dt "string";
addAttr -ln matrixAttr -dt "matrix";
addAttr -ln sphereAttr -dt sphere;
addAttr -ln coneAttr -dt cone;
addAttr -ln meshAttr -dt mesh;
addAttr -ln latticeAttr -dt lattice;
addAttr -ln spectrumRGBAttr -dt spectrumRGB;
addAttr -ln reflectanceRGBAttr -dt reflectanceRGB;
addAttr -ln componentListAttr -dt componentList;
addAttr -ln attrAliasAttr -dt attributeAlias;
addAttr -ln curveAttr -dt nurbsCurve;
addAttr -ln surfaceAttr -dt nurbsSurface;
addAttr -ln trimFaceAttr -dt nurbsTrimface;
addAttr -ln polyFaceAttr -dt polyFaces;

戻り値

なし

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

関連項目

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
-keyable(-k)	boolean
アトリビュートのキー設定可能な状態をオンまたはオフに設定します。
-lock(-l)	boolean
アトリビュートのロック状態をオンまたはオフに設定します。
-channelBox(-cb)	boolean
channelBox でのアトリビュートの表示をオンまたはオフに設定します。 キー設定可能なアトリビュートは、channelBox 設定に関係なく常に channelBox に表示されます。
-caching(-ca)	boolean
アトリビュートの内部キャッシュをオンまたはオフに設定します。すべてのアトリビュートの キャッシュを定義できるわけではありません。デフォルトでキャッシュするように定義されていない アトリビュートに限り、キャッシュを設定することができます。また、マルチ アトリビュート エレメントには キャッシュを設定することができません。キャッシュの設定は、複合アトリビュートの 子アトリビュートにも影響を及ぼします。
-size(-s)	uint
マルチアトリビュート配列のサイズを定義します。これは単なるヒントで、できるだけ効率的にメモリを割り当てられるようにするために使用します。
-type(-typ)	string
データ型を識別します。-type フラグが指定されていない場合は、数値型と想定されます。
-alteredValue(-av)
値はカレント値にすぎず、（アトリビュートに入力コネクションがある場合は）次の評価で変更される可能性があります。 このフラグはファイル入出力時のみに使用します。 したがって、入力コネクションを持つアトリビュートのデータが、 ファイルが開かれてから最初の評価時に上書きされることはありません。
-clamp(-c)
数値アトリビュートで、その値がアトリビュートの範囲外である場合、 強制的に最小値あるいは最大値にします。失敗することはありません。

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

MEL 例

sphere -n sphere;

// Set a simple numeric value
setAttr sphere.translateX 5;

// Lock an attribute to prevent further modification
setAttr -lock on sphere.translateX;

// Make an attribute unkeyable
setAttr -keyable off sphere.translateZ;

// Set an entire list of multi-attribute values in one command
setAttr -size 7 "sphereShape.weights[0:6]" 1 1 2 1 1 1 2;

// Set an attribute with a compound numeric type
setAttr "sphere.rotate" -type "double3" 0 45 90;

// Clamp the value of the attribute to the min/max
// Useful floating point math leaves the value just
// a little out of range - here the min is .01
setAttr -clamp "anisotropic1.roughness" 0.0099978;

// Set a multi-attribute with a compound numeric type
setAttr "sphereShape.controlPoints[0:2]" -type "double3" 0 0 0 1 1 1 2 2 2;