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

概要

setInputDeviceMapping([absolute=boolean], [axis=string], [device=string], [offset=float], [relative=boolean], [scale=float], [view=boolean], [world=boolean])

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

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
ロング ネーム（ショート ネーム） 引数型 プロパティ
device(d) string create
マップするデバイスを指定します。
axis(ax) string createmultiuse
マップする軸を指定します。
scale(s) float create
軸のスケール値を指定します。
offset(o) float create
軸のオフセット値を指定します。
absolute(a) boolean create
絶対軸の値を報告します。
relative(r) boolean create
最後のサンプリング以降の軸値の変更を報告します。
view(v) boolean create
デバイスの座標をアクティブなカメラの座標に変換します。
world(w) boolean create
デバイスの座標をワールド空間座標に変換します。
: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

import maya.cmds as cmds

cmds.assignInputDevice( '"move -r XAxis YAxis ZAxis"', d='spaceball' )
cmds.setInputDeviceMapping( d='spaceball', ax=['XAxis', 'YAxis', 'ZAxis'], scale=0.01, r=True )

# 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.