ジャンプ先: 概要. 戻り値. フラグ. 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 create
チャンネルの軸番号を指定します。子はすべて、親の軸番号と親のチャンネルの幅で定義された軸番号を持ちます。このフラグが使用されない場合、チャンネルの順序で軸番号が定義されます。
-channel(-c) string create
-create の開始後、チャンネルがデバイス定義に追加されることがあります。チャンネル文字列は、デバイスに追加されているチャンネルの名前です。-channel フラグも、-usage フラグと場合により -axis フラグを付ける必要があります。
-clear(-cl) create
-clear オプション デバイスの定義を終了して、定義されたチャンネルを破棄します。
-create(-cr) create
仮想デバイスの定義を開始します。デバイスの定義中であれば、-create フラグはエラーを生成します。
-device(-d) string create
-device フラグはデバイスの定義を終了します。-create フラグと -device フラグ間のチャンネルすべてが指定したデバイスに追加されます。デバイスがすでに存在すれば、このコマンドはエラーになり、デバイスを別のデバイス名で再定義する必要があります。現在定義されているデバイスを確認するには、listInputDevices コマンドを使用します。-device フラグも -undefine と一緒に使用して仮想デバイスの定義を取り消します。
-parent(-p) string create
定義されるチャンネルの親チャンネルを指定します。チャンネルが存在しない場合、または互換性のないタイプの場合、このコマンドはエラーになります。
-undefine(-u) create
-device フラグで指定したデバイスの定義を取り消します。
-usage(-use) string create
-usage オプションは、すべての -channel フラグに必要です。定義されたチャンネルの使用タイプを記述します。使用タイプは次のとおりです。
unknown scalar
pos rot posRot quaternion posQuaternion
rotXYZ rotYZX rotZXY rotXZY rotYXZ rotZYX
posRotXYZ posRotYZX posRotZXY posRotXZY posRotXZY posRotZYX
posX posY posZ rotX rotY rotZ

: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : 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;