ジャンプ先: 概要. 戻り値. フラグ. 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 フラグに必要です。定義されたチャネルの使用タイプを記述します。使用タイプは次のとおりです。
unknownscalar
posrot posRotquaternionposQuaternion
rotXYZrotYZXrotZXY rotXZYrotYXZrotZYX
posRotXYZposRotYZXposRotZXY posRotXZYposRotXZYposRotZYX
posXposYposZrotX rotYrotZ

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

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;