Sound::SetSoundTransformable

Defined in: C4Sound.h

Sets a sound's 3D transform.

Prototype

void SetSoundTransformable(const Transformable *transformable);

Parameters

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

Description

The SetSoundTransformable function sets a sound's 3D transform. The 3D transform is necessary for proper 3D spatialization and must be set if the kSoundSpatialized flag is set (see Sound::SetSoundFlags). The transform pointed to by the transformable parameter must remain valid while the sound object refers to it—the transform is not copied.

The transform represents the transformation from the sound's local coordinate system to world space. The fourth column of the world transform represents the world-space position of the sound, and the first column (corresponding to the local x axis) represents the world-space direction of the sound.