ジャンプ先: 概要. 戻り値.
フラグ. Python 例.
optionVar([arraySize=string], [clearArray=string], [exists=string], [floatValue=[string, float]], [floatValueAppend=[string,
float]], [intValue=[string,
int]], [intValueAppend=[string, int]],
[list=boolean], [remove=string], [removeFromArray=[string, int]],
[stringValue=[string,
string]], [stringValueAppend=[string,
string]], [version=int])
注意:
オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。
optionVar は 「元に戻す」が可能、「照会」が可能、「編集」が不可能 です。
このコマンドで、Maya
のさまざまな呼び出しに存在する変数を設定および照会できます。この変数はプリファレンスの一部として格納されます。
| int |
存在するオプションに対して 0 または 1 |
| string[] |
リスト オプションが使用される場合 |
戻り値の型は照会モードでは照会フラグが基になります。
arraySize, clearArray, exists,
floatValue, floatValueAppend, intValue, intValueAppend, list, remove, removeFromArray, stringValue, stringValueAppend, version
| ロング ネーム（ショート ネーム） |
引数型 |
プロパティ |
intValue(iv) |
[string, int] |
  |
|
整数値「int」の「string」という新しい変数を作成します。
この名前の変数がすでに存在する場合は、新しい値で上書きされます（タイプに関係なく）。 |
|
intValueAppend(iva) |
[string, int] |
|
|
「string」という整数の配列の末尾に、この値を追加します。
このような配列がない場合は作成されます。この名前の整数値がすでに存在している場合は、配列の最初のエレメントになります。その他のタイプの値が存在する場合、すべて上書きされます。 |
|
floatValue(fv) |
[string, float] |
|
|
double 値「float」の「string」という新しい変数を作成します。
この名前の変数がすでに存在する場合は、新しい値で上書きされます（タイプに関係なく）。 |
|
floatValueAppend(fva) |
[string, float] |
|
|
「string」という浮動小数点数配列の末尾に、この値を追加します。
このような配列がない場合は作成されます。この名前の浮動小数点数がすでに存在している場合は、配列の最初のエレメントになります。その他のタイプの値が存在する場合、すべて上書きされます。 |
|
stringValue(sv) |
[string, string] |
|
|
1 番目の文字列を 2 番目の文字列で指定した値で使用した名前の新しい変数を作成します。
この名前の変数がすでに存在する場合は、新しい値で上書きされます（タイプに関係なく）。 |
|
stringValueAppend(sva) |
[string, string] |
|
|
1 番目の文字列の名前の文字配列の末尾に、2
番目の文字列で指定した値を追加します。このような配列がない場合は作成されます。この名前の文字列値がすでに存在している場合は、配列の最初のエレメントになります。その他のタイプの値が存在する場合、すべて上書きされます。 |
|
remove(rm) |
string |
|
|
あれば、「string」という変数を削除します。
注: 同一のコマンドで -r
およびその他の（-sv、-iv、-fv）フラグが使用されている場合、値を設定する前にすべての削除が行われます。 |
|
removeFromArray(rfa) |
[string, int] |
|
|
「string」という配列の番号付きのエレメント「int」を削除します。 それ以降はすべてシャッフルされます。 |
|
version(v) |
int |
|
|
互換性のないプリファレンス ファイルに関する警告を表示する、プリファレンス バージョン番号 |
|
clearArray(ca) |
string |
|
|
「string」という配列がある場合、空に設定されます。 空の配列は保存されません。 |
|
arraySize(arraySize) |
string |
|
|
「string」という配列のサイズを返します。そのような変数がない場合は、0 を返します。変数が配列でない場合は、1
を返します。 |
|
exists(ex) |
string |
|
|
「string」という変数が存在する場合は 1 を、なければ 0 を返します。
これを使用する場合、その他のフラグはすべて無視されます（照会の方が優先度が高い）。 |
|
list(l) |
boolean |
|
|
これは、定義された変数名すべての一覧を返します。これを使用する場合、その他のフラグはすべて無視されます（照会および
exists フラグの方が優先度が高い）。 |
|
| : コマンドの作成モードで使用可能なフラグ |
 : コマンドの編集モードで使用可能なフラグ |
 : コマンドの照会モードで使用可能なフラグ |
: タプルまたはリストとして渡された複数の引数を持てるフラグ |
import maya.cmds as cmds
cmds.optionVar( iv=('defaultTriangles', 4), sv=('defaultFileName', 'buffalo.maya') )
cmds.optionVar( exists='defaultTriangles' )
# Result: 1 #
cmds.optionVar( q='defaultFileName' )
# Result: buffalo.maya #
cmds.optionVar( list=True )
cmds.optionVar( remove='defaultTriangles' )
cmds.optionVar( exists='defaultTriangles' )
# Result: 0 #