Platform SDK: DirectX

DirectSound3DListener.SetOrientation

DirectSound3DListener.SetOrientation メソッドは、前方ベクトルと上方ベクトルの 2 つのベクトルにより、リスナーの方向を設定する。

object.SetOrientation(xFront As Single, _
    yFront As Single, _
    zFront As Single, _
    xTop As Single, _
    yTop As Single, _
    zTop As Single, _
    applyFlag As CONST_DS3DAPPLYFLAGS)

パラメータ

object
DirectSound3DListener オブジェクトを表すオブジェクト式。
xFrontyFrontzFront
前方ベクトルの座標を示す値。
xTopyTopzTop
上方ベクトルの座標を示す値。
applyFlag
設定が適用されるタイミングを示す値。この値は、CONST_DS3DAPPLYFLAGS 列挙の定数のいずれかでなければならない。

エラー コード

失敗すればエラーが発生し、Err.NumberDSERR_INVALIDPARAM が設定される。

注意

前方ベクトルはリスナーの鼻の方向、上方ベクトルはリスナーの頭頂部の方向を指す。デフォルトでは、前方ベクトルは (0,0,1.0)、上方ベクトルは (0,1.0,0) である。

上方ベクトルは前方ベクトルに対して直角でなければならない。必要に応じて、DirectSound は前方ベクトルを設定した後で上方ベクトルを調整する。

参照

DirectSound3DListener.GetOrientation