IDirectSound3DListener8::SetVelocity
SetVelocity メソッドは、リスナーの速度を設定します。
HRESULT
SetVelocity(
D3DVALUE x, y, and z,
D3DVALUE y,
D3DVALUE z,
DWORD dwApply
);
パラメータ
- x, y, and z
リスナーの速度ベクトルの x 座標を指定する値です。浮動小数点のオーバーフローを防ぐために、この値が調整される場合があります。D3DVALUE は、float として定義されています。 - y
リスナーの速度ベクトルの y 座標を指定する値です。浮動小数点のオーバーフローを防ぐために、この値が調整される場合があります。D3DVALUE は、float として定義されています。 - z
リスナーの速度ベクトルの z 座標を指定する値です。浮動小数点のオーバーフローを防ぐために、この値が調整される場合があります。D3DVALUE は、float として定義されています。 - dwApply
設定を適用するタイミングを指定する値です。次の値のいずれかでなければなりません。
戻り値
成功した場合は、DS_OK を返します。失敗した場合は、DSERR_INVALIDPARAM を返します。
解説
速度はドップラー効果のみに使用されます。実際にリスナーを移動することはありません。リスナーの位置を変更するには、SetPosition メソッドを使用します。デフォルトの速度は (0,0,0) です。
デフォルトの計測単位はメートル/秒ですが、SetDistanceFactor メソッドを呼び出して変更することができます。
要件
ヘッダー: DSound.h 宣言
ライブラリ: Dsound3d.dll 内容