ジャンプ先: 概要. 戻り値. 関連. フラグ. MEL 例.

概要

setInputDeviceMapping [-absolute] [-axis string] [-device string] [-offset float] [-relative] [-scale float] [-view] [-world]

setInputDeviceMapping は、取り消し可能、照会不可能、および編集不可能です。

このコマンドは、指定したデバイス軸に作成されるすべてのアタッチメントのスケールとオフセットを設定します。マップされるデバイス軸に作成されるアタッチメントに、スケール値とオフセット値が適用されます。

このコマンドは、デバイスからの値にスケールを乗算し、この結果にオフセットを追加します。絶対マッピングでは、アタッチされたアトリビュートは結果の値を取得します。相対マッピングの場合、現在のデバイス値と前のデバイス値との差にスケールを乗算した結果に追加されるオフセットが最終的な値になります。

デバイス マッピングは、setAttrMapping コマンドによって定義されたマッピングが適用される前にデバイス データに適用されます。これは、一般的に、使用可能な範囲内に収まるようにデバイス入力をスケールするために使用します。たとえば、デバイス マッピングを使用すると、シーンの特定のセクション内で動作するようにスペースボールを調整することができます。

たとえば、絶対デバイス マッピングを使用してスペースボールを設定する場合、スペースボールを一方向に押し続けると、アタッチされたアトリビュートは定数値を取得します。相対マッピングを使用した場合は、スペースボールを一方向に押すと、アタッチされたアトリビュートは常に増加する(または常に減少する)値をジャンプし、オフセットと等しい一定の値を検出します。

相対フラグの処理方法は、このコマンドと setAttrMapping コマンドでは重大な違いがあります。(setAttrMapping コマンドでの相対値の計算方法については、setAttrMapping を参照してください。)一般的に、相対デバイス マッピング(このコマンド)と相対アタッチメント マッピング(setAttrMapping)の両方を同じ軸で一緒に使用することはできません。

戻り値

なし

関連

assignInputDevice, attachDeviceAttr, detachDeviceAttr, devicePanel, getInputDeviceRange, getModifiers, listDeviceAttachments, listInputDeviceAxes, listInputDeviceButtons, listInputDevices, recordAttr, setAttrMapping, unassignInputDevice

フラグ

absolute, axis, device, offset, relative, scale, view, world
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-absolute(-a) create
絶対軸の値を報告します。
-axis(-ax) string createmultiuse
マップする軸を指定します。
-device(-d) string create
マップするデバイスを指定します。
-offset(-o) float create
軸のオフセット値を指定します。
-relative(-r) create
最後のサンプリング以降の軸値の変更を報告します。
-scale(-s) float create
軸のスケール値を指定します。
-view(-v) create
デバイスの座標をアクティブなカメラの座標に変換します。
-world(-w) create
デバイスの座標をワールド空間座標に変換します。
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

MEL 例

assignInputDevice -d "spaceball" "move -r XAxis YAxis ZAxis";
setInputDeviceMapping -d "spaceball" -ax "XAxis" -ax "YAxis" -ax "ZAxis" -scale 0.01 -r;

// The first command will assign the move command to the spaceball.
// The second command will scale the three named axes by 0.01 and
// only return the changes in device position.