SoundMgr::SetListenerTransformable

Defined in: C4Sound.h

Sets the listener's 3D transform.

Prototype

void SetListenerTransformable(const Transformable *transformable);

Parameters

transformable A pointer to the listener's 3D transform. This may be nullptr, in which case the transform is the identity.

Description

The SetListenerTransformable function sets the listener's 3D transform. This transform represents the position and orientation of the listener and is used to place sounds in 3D space. The transform pointed to by the transformable parameter must remain valid while being used by the Sound Manager—the transform is not copied.

The transform represents the transformation from the listener's local coordinate system to world space. The fourth column of the world transform represents the world-space position of the listener, and the third column (corresponding to the local z axis) represents the world-space direction in which the listener is facing. The first and second columns (corresponding to the local x and y axes) represent the right direction and down direction, respectively. This configuration is identical to the camera space used by the Camera class.