addAttr

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

概要

addAttr [-attributeType string] [-binaryTag string] [-cachedInternally boolean] [-category string] [-dataType string] [-defaultValue float] [-enumName string] [-exists] [-fromPlugin boolean] [-hasMaxValue boolean] [-hasMinValue boolean] [-hasSoftMaxValue boolean] [-hasSoftMinValue boolean] [-hidden boolean] [-indexMatters boolean] [-internalSet boolean] [-keyable boolean] [-longName string] [-maxValue float] [-minValue float] [-multi] [-niceName string] [-numberOfChildren uint] [-parent string] [-readable boolean] [-shortName string] [-softMaxValue float] [-softMinValue float] [-storable boolean] [-usedAsColor] [-usedAsFilename] [-writable boolean]

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

戻り値

なし

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

キーワード

関連項目

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
-longName(-ln)	string
アトリビュートのロング ネームを設定します。
-shortName(-sn)	string
アトリビュートのショート ネームを設定します。
-niceName(-nn)	string
UI に表示するアトリビュートのナイス ネームを設定します。アトリビュートのナイス ネームに空でない文字列を設定すると、Maya の文字列カタログからナイス ネームを検索するデフォルト動作が無効になります。（カタログにあるアトリビュートのナイス ネームを検索するには、MEL コマンド「attributeNiceName」と「attributeQuery -niceName」を使用します）。
-binaryTag(-bt)	string
このフラグはサポートしていません。いかなる動作もしません。
-attributeType(-at)	string
アトリビュート タイプを指定します。詳細は上の表を参照してください。注意が必要なのは、アトリビュート タイプ 「float」、「matrix」、「string」は MEL キーワードでもあるため、引用符で囲む必要があることです。
-dataType(-dt)	string
データ型を指定します。データ型の名前の詳細については、「setAttr」を参照してください。
-defaultValue(-dv)	float
アトリビュートのデフォルト値を指定します（数値アトリビュートでのみ使用可能）。
-multi(-m)
新しいアトリビュートをマルチ アトリビュートにします。
-indexMatters(-im)	boolean
マルチ アトリビュートにコネクトするときに、インデックスを使用する必要があるかどうかを設定します。indexMatters を false に設定すると、アトリビュートは強制的に読み取り不可になります。
-minValue(-min)	float
アトリビュートに最小値を指定します（数値アトリビュートでのみ使用可能）。
-hasMinValue(-hnv)	boolean
アトリビュートに最小値があるかどうかを示すフラグです（数値アトリビュートでのみ使用可能）。
-maxValue(-max)	float
アトリビュートの最大値を指定します（数値アトリビュートでのみ使用可能）。
-hasMaxValue(-hxv)	boolean
アトリビュートに最大値があるかどうかを示すフラグです（数値アトリビュートでのみ使用可能）。
-cachedInternally(-ci)	boolean
アトリビュート データをノード内部にキャッシュするかどうかを指定します。このフラグは現在サポートしていません（常にデフォルト値の true に設定されます）。
-internalSet(-is)	boolean
このアトリビュート値が変更されたときに内部にキャッシュされた値にセットするかどうかを指定します。これは UI 要素の更新に使用する内部フラグです。
-parent(-p)	string
新しいアトリビュートの親になるアトリビュートです。
-numberOfChildren(-nc)	uint
新しいアトリビュートには子が何個あるかを指定します。
-usedAsColor(-uac)
アトリビュートをカラー定義として使用します。このフラグを使用するには、3 DOUBLE または 3 FLOAT の子が必要です。アトリビュートタイプ「-at」は必要に応じて「double3」または「float3」にする必要があります。また、このフラグを「double3」または「float3」としたデータ型「-dt」とともに使用してエフェクトを小さくすることもできますが、コードの部分によってはこの代替をサポートしないことがあります。特別なアトリビュート タイプ/データである「スペクトラム」と「反射率」はカラー フラグもサポートしており、この上ではデフォルトでカラー フラグが設定されます。
-usedAsFilename(-uaf)
アトリビュートをファイル名定義として扱います。このフラグはデータ型が「string」の「-dt」フラグを持つアトリビュートでのみサポートされます。
-hidden(-h)	boolean
このアトリビュートは UI から非表示になります。
-readable(-r)	boolean
このアトリビュートからの出力コネクションを作成できます。
-writable(-w)	boolean
このアトリビュートへの入力コネクションを作成できます。
-storable(-s)	boolean
アトリビュートをファイルに格納できます。
-keyable(-k)	boolean
アトリビュートはデフォルトではキー設定可です。
-fromPlugin(-fp)	boolean
元はプラグンで作成したアトリビュートですか？API コールが行われた場合、通常は自動的に設定されます - 作成プラグインとは関係ないファイル内でのソートをサポートするために追加されました。
-softMinValue(-smn)	float
ソフト最小値、数値アトリビュートにのみ有効です。このアトリビュート用のスライダで使用するデフォルトの上限値を指定します。
-hasSoftMinValue(-hsn)	boolean
数値アトリビュートがソフト最小値を持つかどうかを示すフラグです。
-softMaxValue(-smx)	float
ソフト最大値、数値アトリビュートにのみ有効。このアトリビュート用のスライダで使用するデフォルトの上限値を指定します。
-hasSoftMaxValue(-hsx)	boolean
数値アトリビュートがソフト最大値を持つかどうかを示すフラグです。
-category(-ct)	string
アトリビュート カテゴリは、識別するためにアトリビュートに関連付けられています（アトリビュートを作成したプラグインの名前、バージョン情報など）。任意のアトリビュートを任意の数のカテゴリに関連付けすることが可能です。ただし、一度関連付けしたカテゴリを削除することはできません。
-enumName(-en)	string
enum 値に対応する UI 名を指定するために使用するフラグです。指定する文字列には、コロンで区切った名前のリストとオプション値を含めます。値を指定しないと、0 で始まる連続した整数として扱われます。例:-enumName "A:B:C" が生成するオプション値は、A、B、C の順に 0、1、2 で、-enumName "zero:one:two:thousand=1000" は、値 0、1、2、1000 の 4 つのオプションを生成し、-enumName "solo=1:triplet=3:quintet=5" は、値が 1、3、5 の 3 つのオプションを生成します。（現時点でのチャンネル ボックス（Channel Box）に関する制限事項として、列挙型アトリビュートのプルダウン メニューが正しく表示されない場合があります。オプション値が連続していない場合に、その間の数がメニュー項目として余分に表示される可能性があります。この制限事項を回避するために、チャンネル ボックスで表示する列挙型アトリビュートのオプションには連続した値を指定してください。例:"solo=1:triplet=2:quintet=3"）。
-exists(-ex)
照会されたアトリビュートがユーザが追加したダイナミック アトリビュートであれば true を、そうでない場合には false を返します。

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

MEL 例

sphere -name earth;
// Add an attribute named ms/mass with a default value of 1 and a
// minimum value of 0.001 and a maximum of 10000.
//
addAttr -shortName ms -longName mass -defaultValue 1.0 -minValue 0.001 -maxValue 10000;
// Add a multi attribute named ff/forcefield of type double3.
//
addAttr -shortName ff -longName forcefield -dataType double3 -multi;
// Add a compound attribute named sampson with children homeboy, midge,
// damien, elizabeth, and sweetpea of varying types
//
addAttr -longName sampson -numberOfChildren 5 -attributeType compound;
    addAttr -longName homeboy -attributeType "matrix" -parent sampson;
    addAttr -longName midge -attributeType message -parent sampson;
    addAttr -longName damien -attributeType double -parent sampson;
    addAttr -longName elizabeth -attributeType double -parent sampson;
    addAttr -longName sweetpea -attributeType double -parent sampson;
// To add an attribute that is to be interpreted as a color the
// following attribute group must be used.
//
// Note that the word "float" must be in quotations since it is a
// MEL keyword.
//
addAttr -longName rainbow -usedAsColor -attributeType float3;
    addAttr -longName redBow -attributeType "float" -parent rainbow;
    addAttr -longName greenBow -attributeType "float" -parent rainbow;
    addAttr -longName blueBow -attributeType "float" -parent rainbow;
// Other legal attribute types that can be interpreted as colors need
// not specify the "-usedAsColor" flag as it will be assumed.  These
// include "-attributeType spectrum", "-attributeType reflectance",
// "-dataType spectrumRGB", and "-dataType reflectanceRGB".
//
addAttr -longName implColor -dataType spectrumRGB;
addAttr -query -usedAsColor ".implColor";
// Result: 1 //
// Add a double3 attribute named sanders with children bess, les and wes
//
addAttr -longName sanders -attributeType double3;
    addAttr -longName bess -attributeType double -parent sanders;
    addAttr -longName les -attributeType double -parent sanders;
    addAttr -longName wes -attributeType double -parent sanders;