移動先: 概要 戻り値 フラグ. MEL 例.

概要

defineVirtualDevice [-axis int] [-channel string] [-clear] [-create] [-device string] [-parent string] [-undefine] [-usage string]

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

このコマンドは仮想デバイスを定義します。仮想デバイスは実際のデバイスと同じように動作し、コマンド デバイスがコンピュータに接続されていない場合の、データの操作や再生に便利です。

戻り値

なし

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

フラグ

axis, channel, clear, create, device, parent, undefine, usage
ロング ネーム(ショート ネーム) 引数型 プロパティ
-axis(-ax) int
チャンネルの軸番号を指定します。子はすべて、親の軸番号と親のチャンネルの幅で定義された軸番号を持ちます。このフラグが使用されない場合、チャンネルの順序で軸番号が定義されます。
-channel(-c) string
-create の開始後、チャンネルがデバイス定義に追加されることがあります。チャンネル文字列は、デバイスに追加されているチャンネルの名前です。-channel フラグも、-usage フラグと場合により -axis フラグを付ける必要があります。
-clear(-cl)
-clear オプション デバイスの定義を終了して、定義されたチャンネルを破棄します。
-create(-cr)
仮想デバイスの定義を開始します。デバイスの定義中であれば、-create フラグはエラーを生成します。
-device(-d) string
-device フラグはデバイスの定義を終了します。-create フラグと -device フラグ間のチャンネルすべてが指定したデバイスに追加されます。デバイスがすでに存在すれば、このコマンドはエラーになり、デバイスを別のデバイス名で再定義する必要があります。現在定義されているデバイスを確認するには、listInputDevices コマンドを使用します。-device フラグも -undefine と併用して仮想デバイスの定義を取り消します。
-parent(-p) string
定義されるチャンネルの親チャンネルを指定します。チャンネルが存在しない場合、または互換性のないタイプの場合、このコマンドはエラーになります。
-undefine(-u)
-device フラグで指定したデバイスの定義を取り消します。
-usage(-use) string
-usage オプションは、すべての -channel フラグに必要です。定義されたチャンネルの使用タイプを記述します。使用タイプは次のとおりです。
unknownscalar
posrot posRotquaternionposQuaternion
rotXYZrotYZXrotZXY rotXZYrotYXZrotZYX
posRotXYZposRotYZXposRotZXY posRotXZYposRotXZYposRotZYX
posXposYposZrotX rotYrotZ

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

MEL 例

//    Create a virtual clock and read in some data.
defineVirtualDevice -create;
defineVirtualDevice -channel seconds -usage rotZ -axis 2;
defineVirtualDevice -channel minutes -usage rotZ -axis 1;
defineVirtualDevice -channel hours -usage rotZ -axis 0;
defineVirtualDevice -device virtualClock;
readTake -device virtualClock -take clock.mov;

//    Undefine the virtualClock
defineVirtualDevice -device virtualClock -undefine;

//    Create a body device.
defineVirtualDevice -create;
defineVirtualDevice -channel pelvis -usage posRot;
defineVirtualDevice -channel back -usage posRot;
defineVirtualDevice -channel head -usage posRot;
defineVirtualDevice -device body;

//    Explicitly order the axis of the device. The created device is
//    the same as the above body device.
defineVirtualDevice -create;
defineVirtualDevice -channel head -usage posRot -axis 12;
defineVirtualDevice -channel back -usage posRot -axis 6;
defineVirtualDevice -channel pelvis -usage posRot -axis 0;
defineVirtualDevice -device body;