DirectSound3DListener.GetOrientation

The DirectSound3DListener.GetOrientation method retrieves the listener's current orientation in vectors: a front vector and a top vector.

object.GetOrientation(orientFront As D3DVECTOR, _
    orientTop As D3DVECTOR)

Parameters

object

Object expression that resolves to a DirectSound3DListener object.

orientFront

A D3DVECTOR type that will contain the listener's front orientation vector.

orientTop

A D3DVECTOR type that will contain the listener's top orientation vector.

Error Codes

If the method fails, an error is raised and Err.Number may be set to DSERR_INVALIDPARAM.

Remarks

The front vector points in the direction of the listener's nose, and the top vector points out the top of the listener's head. By default, the front vector is (0,0,1.0) and the top vector is (0,1.0,0).

The values returned are not necessarily the same as those set by using the DirectSound3DListener.SetOrientation method. DirectSound adjusts orientation vectors so that they are at right angles and have a magnitude of less than or equal to 1.0.

See Also

DirectSound3DListener.SetOrientation