SoLoud

3d Audio

By default SoLoud's coordinate system is right handed (OpenGL). If you wish SoLoud to use left handed (Direct3d) coordinate system instead, initialize SoLoud with the LEFT_HANDED_3D flag.

Note that most of the 3d audio calls are not thread safe, and it is best not to call them from several threads at the same time. The good side is that the 3d audio calls won't disturb the audio thread mutex, and will thus be much more performant.

Soloud.update3dAudio()

Update the 3d parameters for the 3d voices. No positional effect occurs unless this function is called periodically.


gSoloud.set3dSourceVelocity(h, -1, 0, 0); // go west
gSoloud.update3dAudio(); // apply change to voices

Soloud.play3d()

play3d() is the 3d version of the play() call.


handle play3d(AudioSource &aSound, 
              float aPosX, 
              float aPosY, 
              float aPosZ, 
              float aVelX = 0.0f, 
              float aVelY = 0.0f, 
              float aVelZ = 0.0f, 
              float aVolume = 1.0f, 
              bool aPaused = 0, 
              unsigned int aBus = 0);

Instead of panning like with the "2d" version of the call, the 3d version requires 3d position and optionally velocity vector. Like its 2d version, this one tries to launch the sound as soon as possible, which means the start of the next audio buffer.

The play3d can also add the "distance delay" to the sound, if enabled.


int h = gSoloud.play3d(west, -10, 0, 0);
gSoloud.set3dSourceVelocity(h, -1, 0, 0); // go west

Soloud.play3dClocked()

play3dClocked() is the 3d version of the playClocked() call.


handle play3d(time aSoundTime,
              AudioSource &aSound, 
              float aPosX, 
              float aPosY, 
              float aPosZ, 
              float aVelX = 0.0f, 
              float aVelY = 0.0f, 
              float aVelZ = 0.0f, 
              float aVolume = 1.0f,                   
              unsigned int aBus = 0);

Instead of panning like with the "2d" version of the call, the 3d version requires 3d position and optionally velocity vector. Like its 2d version, this one delays the start of the sound based on the aSoundTime parameter, so that firing off sounds rapidly won't cause the sounds to "clump" together at the start of the next sound buffer.

The play3dClocked can also add the "distance delay" to the sound, if enabled.


// trigger boom at specific coords
gSoloud.play3dClocked(physicstime, boom, bx, by, bz);

Soloud.set3dSoundSpeed(), Soloud.get3dSoundSpeed()

You can set and get the current value of the speed of sound width the get3dSoundSpeed() and set3dSoundSpeed() functions. The speed of sound is used to calculate doppler effects in addition to the distance delay.

Since SoLoud has no knowledge of the scale of your coordinates, you may need to adjust the speed of sound for these effects to work correctly. The default value is 343, which assumes that your world coordinates are in meters (where 1 unit is 1 meter), and that the environment is dry air at around 20 degrees Celsius.


int speed = gSoloud.get3dSoundSpeed(); // Get the current speed of sound
gSoloud.set3dSoundSpeed(speed / 2); // Halve it

Soloud.set3dListenerParameters()

You can set the position, at-vector, up-vector and velocity parameters of the 3d audio listener with one call using the set3dListenerParameters.


void set3dListenerParameters(float aPosX, 
                             float aPosY, 
                             float aPosZ, 
                             float aAtX, 
                             float aAtY, 
                             float aAtZ, 
                             float aUpX, 
                             float aUpY, 
                             float aUpZ, 
                             float aVelocityX, 
                             float aVelocityY, 
                             float aVelocityZ)