| ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
exists(ex)
|
boolean
|
|
|
指定したオブジェクトが存在するかどうかによって、true または false を返します。他のフラグは無視されます。
|
|
defineTemplate(dt)
|
string
|
|
|
他の任意のフラグと引数を解析し、かつ引数で指定したコマンド テンプレートに
追加するモードに、コマンドのモードを変更します。templateName が現在のテンプレートとして設定されていれば、
その後コマンドが実行されるたびに、この引数が既定の引数として使用されます。
|
|
useTemplate(ut)
|
string
|
|
|
コマンドに、現在以外のコマンド テンプレートの使用を強制します。
|
|
parent(p)
|
string
|
|
|
|
enable(en)
|
boolean
|
|
|
コントロールの有効、無効です。既定では true に設定されていて、コントロールは有効になっています。false を指定すると
コントロールはグレー表示になって無効になります。
|
|
width(w)
|
int
|
|
|
コントロールの幅を指定します。コントロールは親のレイアウトの条件によって無効にされない限り、このサイズを保持しようとします。
|
|
height(h)
|
int
|
|
|
コントロールの高さです。コントロールは親のレイアウトの条件によって無効にされない限り、このサイズを保持しようとします。
|
|
visible(vis)
|
boolean
|
|
|
コントロールの可視の状態です。既定では、コントロールは表示されます。コントロールの実際の外見も、その親レイアウトの可視の状態によって
異なることに注意してください。
|
|
visibleChangeCommand(vcc)
|
script
|
|
|
コントロールの可視の状態が変更されたときに実行されるコマンドです。
|
|
isObscured(io)
|
boolean
|
|
|
コントロールが実際に表示されるかどうかを返します。コントロールは、次の場合に隠れた状態になります。非表示の場合、別のコントロールで(完全に、または部分的に)ブロックされた場合、コントロールまたは親のレイアウトを制御できない場合、あるいはコントロールのウィンドウが非表示またはアイコン化されている場合。
|
|
manage(m)
|
boolean
|
|
|
コントロールの状態を管理します。管理されていないコントロールは表示されず、画面の領域も占有しません。既定では、コントロールは管理できるように作成されます。
|
|
numberOfPopupMenus(npm)
|
boolean
|
|
|
このコントロールにアタッチされるポップアップ メニューの数を返します。
|
|
popupMenuArray(pma)
|
boolean
|
|
|
このコントロールにアタッチされる全ポップアップ メニューの名前を返します。
|
|
preventOverride(po)
|
boolean
|
|
|
true の場合、コントロールのコントロールは親のレイアウトの条件によって無効にされ右マウス ボタン メニューを使用したコントロール アトリビュートのオーバーライドは無効です。
|
|
annotation(ann)
|
string
|
|
|
|
backgroundColor(bgc)
|
[float, float, float]
|
|
|
コントロールのバックグラウンド カラーです。引数は、赤、緑、青のカラー成分に対応しています。それぞれの成分の値は、0.0～1.0 です。
backgroundColor を設定する場合、enableBackground を false に指定していない限り、バックグラウンドは自動的に有効になります。
|
|
noBackground(nbg)
|
boolean
|
|
|
コントロールのバックグラウンドをクリア/リセットします。バックグラウンドは、true を渡すと一切描画されず、false を渡すと描画されます。このフラグの状態は、このコントロールの子に継承されます。
|
|
enableBackground(ebg)
|
boolean
|
|
|
コントロールのバックグラウンド カラーを有効にします。
|
|
docTag(dtg)
|
string
|
|
|
コントロールにドキュメンテーション フラグを追加します。ドキュメンテーション フラグは、階層のようなディレクトリ構造になっています。例: -dt render/multiLister/createNode/material
|
|
dragCallback(dgc)
|
script
|
|
|
中マウス ボタンを押すとコールされるコールバックを追加します。MEL バージョンのコールバックの書式は次のとおりです。
global proc string[] callbackName(string $dragControl, int $x, int $y, int $mods)
proc はドロップ先に転送される文字配列を返します。規則により、配列の先頭文字列はユーザ設定可能なメッセージ タイプを表しています。アプリケーションで定義されたドラッグ元のコントロールは、このコールバックを無視する可能性があります。$mods で、キー モディファイアである CTL と SHIFT をテストできます。有効な値は、0 == モディファイアなし、1 == SHIFT、2 == CTL、3 == CTL + SHIFT です。
Python でも同様ですが、コールバックの指定方法が 2 つあります。お勧めの方法は、引数として Python 関数オブジェクトを渡すことです。この場合、Python コールバックの書式は次のようになります。
def callbackName( dragControl, x, y, modifiers ):
この引数の値は、上記の MEL バージョンの引数と同じです。
Python でコールバックを指定するもう 1 つの方法では、実行する文字列を指定します。この場合、Python の標準的なフォーマット演算子を介して文字列に値が代入されます。このフォーマットの値は、キー「dragControl」、「x」、「y」、「modifiers」と共に
辞書で渡されます。dragControl の値は文字列で、その他の値は整数です(コールバック文字列の例: 「print '%(dragControl)s %(x)d %(y)d %(modifiers)d'」)。
|
|
dropCallback(dpc)
|
script
|
|
|
ドラッグ＆ドロップ操作をドロップ位置で解放したときにコールされるコールバックを追加します。MEL バージョンのコールバックの書式は次のとおりです。
global proc callbackName(string $dragControl, string $dropControl, string $msgs[], int $x, int $y, int $type)
proc は、ドラッグ元から転送される文字配列を受け取ります。msgs 配列の先頭文字列はユーザ定義のメッセージ タイプを表します。アプリケーションで定義されたドロップ先のコントロールでは、このコールバックが無視されることがあります。$type の値は、1 == 移動、2 == コピー、3 == リンクのいずれかです。
Python でも同様ですが、コールバックの指定方法が 2 つあります。お勧めの方法は、引数として Python 関数オブジェクトを渡すことです。この場合、Python コールバックの書式は次のようになります。
def pythonDropTest( dragControl, dropControl, messages, x, y, dragType ):
この引数の値は、上記の MEL バージョンの引数と同じです。
Python でコールバックを指定するもう 1 つの方法では、実行する文字列を指定します。この場合、Python の標準的なフォーマット演算子を介して文字列に値が代入されます。このフォーマットの値は、
キー「dragControl」、「dropControl」、「messages」、「x」、「y」、「type」と共に
辞書で渡されます。dragControl の値は文字列で、その他の値は整数です(コールバック文字列の例: 「print '%(dragControl)s %(dropControl)s %(messages)r %(x)d %(y)d %(type)d'」)。
|
|
fullPathName(fpn)
|
string
|
|
|
すべての親を含むウィジェットのフル パス名を返します。
|
|
globalTime(gt)
|
boolean
|
|
|
true では、このウィジェットがグローバルのディペンデンシー グラフの時間を
制御および表示します。false では、このウィジェットでの時間の変更が
ディペンデンシー グラフに影響しません。照会すると、このフラグは整数を返します。
|
|
snap(sn)
|
boolean
|
|
|
「true」では、このウィジェットの値が現在のタイムの単位を示す整数値であるように
コンストレイントされます。「false」では、現在のタイム インジケータは「free floating」であり、
コンストレイントされません。
|
|
sound(s)
|
string
|
|
|
サウンド表示ウィジェットにデータを表示する
オーディオ ディペンデンシー ノードの名前です。照会すると、このフラグは string を返します。
|
|
displaySound(ds)
|
boolean
|
|
|
サウンド表示をオフにします。照会すると、このフラグは整数を返します。
|
|
waveform(wf)
|
string
|
|
|
-displaySound が「true」の場合に、
表示するサウンドの波形の部分を定義します。有効な値は、「top」、「bottom」、「both」です。既定は「top」です。照会すると、このフラグは string を返します。
|
|
resample(r)
|
boolean
|
|
|
ウィジェットに適合するように、サウンド表示を再びサンプリングします。
|
|
repeatOnHold(roh)
|
boolean
|
|
|
マウスダウン イベント時にサウンドを繰り返します。
|
|
repeatChunkSize(rcs)
|
float
|
|
|
-repeatOnHold が true の場合に繰り返すサウンドの量(現在の時間単位)。既定は 1.0 です。
|
|
beginScrub(bs)
|
boolean
|
|
|
サウンドをスクラブするには、このウィジェットを設定します。その後に現在のタイムが変更されると、
このウィジェットに対して「-endScrub」コマンドが発行されるまで、
「サウンド スクラブ」動作を実行します。
|
|
endScrub(es)
|
boolean
|
|
|
このウィジェットのサウンド スクラブを終了します。これでサウンド スクラブ動作が停止します。
これは、その後の「-beginScrub」フラグの前に
発行する必要があります。
|
|
showKeys(sk)
|
string
|
|
|
「active」を指定すると、すべてのアクティブ オブジェクトのキーフレームを
チェック マークで表示します。「none」を指定すると、チェック マークは表示されません。ほかの名前は、
選択したアトリビュートがチェック マークで表示される
チャネル ボックス名として扱われます。既定は「active」です。照会すると、このフラグは string を返します。
|
|
showKeysCombined(skc)
|
boolean
|
|
|
このフラグは、showKeys フラグと一緒に使用すると、「active」と「channel box」動作を組み合わせることができます。具体的には、チャネル ボックスのアトリビュートが選択されると、それらのアトリビュートにキー マークが表示されます。チャネル ボックスのアトリビュートが選択されない場合は、すべてのアクティブ オブジェクトのキーフレームにキー マークが表示されます。
|
|
animCurveNames(acn)
|
boolean
|
|
|
「showKeys」が「none」以外のとき、このフラグを照会すると、
キーフレームにチェック マークがついている
animCurve すべての名前を返します。照会すると、string[] を返します。
|
|
range(rng)
|
boolean
|
|
|
タイム スライダで現在ハイライト表示されている範囲を示す
文字列を返します。10 から 20 の場合、「10:20」と返されます。タイム スライダに可視となっている範囲がない場合、照会すると現在のタイムを範囲にしたものを返します。たとえば、「10:11」となります。これらの値は現在のタイムの単位で返されます。
|
|
rangeArray(ra)
|
boolean
|
|
|
タイム スライダで現在ハイライト表示されている範囲を示す
float 配列を返します。10 から 20 の場合、{10.0, 20.0} となります。タイム スライダに可視となっている範囲がない場合、照会すると現在のタイムを範囲にしたものを返します。{ 10.0, 11.0 }. これらの値は現在のタイムの単位で返されます。
|
|
rangeVisible(rv)
|
boolean
|
|
|
現在ハイライトされた範囲がスライダに可視になっていれば true が、
そうでなければ false を返します。
|
|
pressCommand(pc)
|
script
|
|
|
このコントロールでのマウスダウン イベント時に
実行するスクリプトです。
|
|
releaseCommand(rc)
|
script
|
|
|
このコントロールでのマウスアップ イベント時に実行するスクリプトです。
|
|
mainListConnection(mlc)
|
string
|
|
|
タイム スライダでコンテンツのソースとして使用される
selectionConnection オブジェクトの名前を指定します。タイム スライダは、selectionConnection オブジェクトの
項目のキーフレームのみを表示します。
|
|
animLayerFilterOptions(alf)
|
string
|
|
|
アニメーション レイヤを表示するときに、フィルタを適用するかどうかを指定します。適用する場合、オプションは「allAffecting」(フィルタなし)、「active」(オブジェクト上のアクティブ レイヤのみ表示)、または「animLayerEditor」(設定をアニメーション レイヤ エディタから取得)になります。
|
|
tickSize(ts)
|
int
|
|
|
タイム スライダの中に描かれている
キーフレームのキー マークの幅を指定します。この値は [1, 63] の範囲に固定されます。
|
|
forceRefresh(fr)
|
boolean
|
|
|
時間コントロール UI のリフレッシュを強制します。
|
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。