currentUnit

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

概要

currentUnit [-angle string] [-fullName] [-linear string] [-time string] [-updateAnimation boolean]

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

カレント単位によって、Maya の全コマンドでの数値の解釈方法が決まります。たとえば、カレントのリニア単位が cm であるとします。

move 5 -2 3;
sphere -radius 4;

currentTime 6;

コマンドでそれぞれの単位を指定すると、値を特定した単位はいつでもオーバーライドできます。たとえば、上記の例を使用して説明します。

move 5m -2mm 3cm;
sphere -radius 4inch;
currentTime 6ntsc;

戻り値

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

関連項目

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
-linear(-l)	string
カレントのリニア単位を設定します。有効な文字列: [mm | ミリメートル | cm | センチメートル | m | メートル | km | キロメートル | in | インチ | ft | フィート | yd | ヤード | mi | マイル ] 照会すると、カレントのリニア単位を示す文字列を返します。
-angle(-a)	string
カレントの角度単位を設定します。有効な文字列: [deg | ° | rad | ラジアン ] 照会すると、カレントの角度単位を示す文字列を返します。
-time(-t)	string
カレントの時間単位を設定します。有効な文字列: [ 時 | 分 | 秒 | ミリ秒 | ゲーム | フィルム | PAL | NTSC | show | palf | ntscf] 照会すると、カレントの時間単位を返します。 時間単位には長い記述形式はありません。 秒ベースでない時間単位は、以下のフレーム/秒として解釈されます。 game: 15 fps フィルム: 24 fps PAL: 25 fps NTSC: 30 fps show: 48 fps palf: 50 fps ntscf: 60 fps
-fullName(-f)
照会モード専用フラグです。-linear/-angle/-time フラグのいずれかと一緒に指定すると、単位の長い記述形式を返します。 たとえば、mm と millimeter は同じ単位ですが、前者は単位名の短い記述形式で後者は長い記述形式です。
-updateAnimation(-ua)	boolean
編集モード専用フラグです。-time フラグと一緒に指定すると、キーのタイム設定が更新されません。デフォルトでは、カレントの時間単位を変更すると、再生のタイミングが保持されるようにキーのタイム設定が変更されます。たとえば、カレントの時間単位を ntsc に変更すると、12film フレームに設定されていたキーは 15ntsc フレームに変更されます。12film と 15ntsc は両者とも 0.5 秒でキー設定されます。-updateAnimation を false に指定すると、12ntsc フレームにキー設定されたままになります。 デフォルトでは、-updateAnimation は true です。

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

MEL の例

// What is the current linear unit?
currentUnit -query -linear;

// What is the current angular unit in its long name form?
currentUnit -fullName -query -angle;

// Change the current time unit to ntsc
currentUnit -time ntsc;

// Change the current linear unit to inches
currentUnit -linear "in";