IDirectSound3DListener8::SetOrientation
SetOrientation メソッドは、リスナーの頭部の向きを設定します。
HRESULT
SetOrientation(
D3DVALUE xFront,
D3DVALUE yFront,
D3DVALUE zFront,
D3DVALUE xTop,
D3DVALUE yTop,
D3DVALUE zTop,
DWORD dwApply
);
パラメータ
- xFront
前方ベクトルの x 座標を指定する値です。D3DVALUE は、float として定義されています。 - yFront
前方ベクトルの y 座標を指定する値です。D3DVALUE は、float として定義されています。 - zFront
前方ベクトルの z 座標を指定する値です。D3DVALUE は、float として定義されています。 - xTop
上方ベクトルの x 座標を指定する値です。 - yTop
上方ベクトルの y 座標を指定する値です。 - zTop
上方ベクトルの z 座標を指定する値です。 - dwApply
設定を適用するタイミングを指定する値です。次の値のいずれかでなければなりません。
戻り値
成功した場合は、DS_OK を返します。失敗した場合は、DSERR_INVALIDPARAM を返します。
解説
前方ベクトルはリスナーの鼻の方向、上方ベクトルはリスナーの頭頂部から上の方向を指します。デフォルトでは、前方ベクトルは (0,0,1.0)、上方ベクトルは (0,1.0,0) です。
上方ベクトルは、前方ベクトルに対して直角でなければなりません。前方ベクトルの設定後、必要に応じて上方ベクトルが調整されます。
要件
ヘッダー: DSound.h 宣言
ライブラリ: Dsound3d.dll 内容