audiolib.h File Reference

#include "gfx/vec.h"
#include <string>

Go to the source code of this file.

Functions
bool	AUDInit ()
void	AUDDestroy ()
void	AUDListenerSize (const float size)
	Sets the size in which all sounds are going to be played. More...
void	AUDListener (const QVector &pos, const Vector &vel)
QVector	AUDListenerLocation ()
void	AUDRefreshSounds ()
	Checks if sounds are still playing. More...
void	AUDListenerOrientation (const Vector &i, const Vector &j, const Vector &k)
	Will the sound be played. More...
void	AUDListenerGain (const float gain)
float	AUDGetListenerGain ()
int	AUDCreateSoundWAV (const std::string &, const bool LOOP=false)
	creates a buffer if one doesn't already exists, and then creates a source More...
int	AUDCreateSoundMP3 (const std::string &, const bool LOOP=false)
	creates a buffer for an mp3 sound if one doesn't already exist, then creates a source More...
int	AUDCreateMusicWAV (const std::string &, const bool LOOP=false)
	creates a buffer if one doesn't already exists, and then creates a source More...
int	AUDCreateMusicMP3 (const std::string &, const bool LOOP=false)
	creates a buffer for an mp3 sound if one doesn't already exist, then creates a source More...
int	AUDCreateSound (int sound, const bool LOOP=false)
	copies other sound loaded through AUDCreateSound More...
int	AUDCreateSound (const std::string &, const bool LOOP=false)
	guesses the type of sound by extension More...
int	AUDCreateMusic (const std::string &, const bool LOOP=false)
	guesses the type of sound by extension More...
void	AUDStopAllSounds (int except_this_one=-1)
int	AUDHighestSoundPlaying ()
void	AUDDeleteSound (int sound, bool music=false)
	deletes a given sound More...
void	AUDAdjustSound (const int sound, const QVector &pos, const Vector &vel)
	Changes the velocity and/or position of a given sound. More...
void	AUDStreamingSound (const int sound)
	Setup the sound as a streaming source (this means right now only that it doesn't do 3D positional stuff) More...
void	AUDSoundGain (int sound, float gain, bool music=false)
	Changes the gain of a loaded sound. More...
bool	AUDIsPlaying (const int sound)
	Is a loaded sound still playing. More...
void	AUDStopPlaying (const int sound)
	Stops a loaded sound. More...
void	AUDStartPlaying (const int sound)
	Plays a loaded sound. More...
void	AUDPlay (const int sound, const QVector &pos, const Vector &vel, const float gain)
	Queries if the sound should be culled. If not, plays. More...
void	AUDPausePlaying (const int sound)
	Pauses a loaded sound. More...
void	AUDChangeVolume (float volume)
	Changes the volume (generally 0 or between 1 and 1000) More...
float	AUDGetVolume ()
void	AUDChangeDoppler (float doppler)
	changes the scale used for doppler...generally between 0 for off or .01 and 10 More...
float	AUDGetCurrentPosition (const int sound)
	Gets the current playback position in seconds (precision is system&driver-dependant) More...
float	AUDGetDoppler ()
	Gets current doppler val. More...

Function Documentation

void AUDAdjustSound	(	const int	sound,
		const QVector &	pos,
		const Vector &	vel
	)

Changes the velocity and/or position of a given sound.

Definition at line 683 of file al_sound.cpp.

References f, VegaConfig::getVariable(), XMLSupport::parse_float(), v, and vs_config.

Referenced by AUDPlay(), AUDStartPlaying(), Beam::Draw(), GameUnit< UnitType >::Draw(), Mount::PhysicsAlignedFire(), soundContainer::playsound(), UniverseUtil::playSound(), GameUnit< UnitType >::ResolveForces(), Beam::UpdatePhysics(), and Unit::UpdatePhysics().

{
    static float ref_distance = XMLSupport::parse_float( vs_config->getVariable( "audio", "audio_ref_distance", "4000" ) );
    static float max_distance = XMLSupport::parse_float( vs_config->getVariable( "audio", "audio_max_distance", "1000000" ) );
    
#ifdef HAVE_AL
    if ( sound >= 0 && sound < (int) sounds.size() ) {
        float p[] = {
            scalepos *pos.i, scalepos*pos.j, scalepos*pos.k
        }
        ;
        float v[] = {scalevel *vel.i, scalevel*vel.j, scalevel*vel.k};
        sounds[sound].pos = pos.Cast();
        sounds[sound].vel = vel;
        if (usepositional && sounds[sound].source) {
            alSourcefv( sounds[sound].source, AL_POSITION, p );
            bool relative = (p[0] == 0 && p[1] == 0 && p[2] == 0);
            alSourcei( sounds[sound].source, AL_SOURCE_RELATIVE, relative );
            if (!relative) {
                // Set rolloff factrs
                alSourcef(sounds[sound].source, AL_MAX_DISTANCE, scalepos * max_distance);
                alSourcef(sounds[sound].source, AL_REFERENCE_DISTANCE, scalepos * ref_distance);
                alSourcef(sounds[sound].source, AL_ROLLOFF_FACTOR, 1.f);
            }
        }
        if (usedoppler && sounds[sound].source)
            alSourcefv( sounds[sound].source, AL_VELOCITY, v );
    }
#endif
}

void AUDChangeDoppler

(

float

doppler)

changes the scale used for doppler...generally between 0 for off or .01 and 10

Definition at line 102 of file al_init.cpp.

Referenced by decdop(), and incdop().

{
#ifdef HAVE_AL
    if (doppler <= 0)
        usedoppler = false;
    else
        usedoppler = true;
    scalevel = doppler;
#endif
}

void AUDChangeVolume

(

float

volume)

Changes the volume (generally 0 or between 1 and 1000)

Definition at line 81 of file al_init.cpp.

References volume.

Referenced by decvol(), and incvol().

{
#ifdef HAVE_AL
    if (volume == 0) {
        usepositional = false;
        return;
    } else {
        usepositional = true;
    }
    scalepos = 1./volume;
#endif
}

int AUDCreateMusic	(	const std::string &	,
		const bool	LOOP = false
	)

guesses the type of sound by extension

Definition at line 615 of file al_sound.cpp.

References AUDCreateMusicMP3(), and AUDCreateMusicWAV().

{
    if ( s.end()-1 >= s.begin() ) {
        if (*(s.end()-1) == 'v')
            return AUDCreateMusicWAV( s, LOOP );
        else
            return AUDCreateMusicMP3( s, LOOP );
    }
    return -1;
}

int AUDCreateMusicMP3	(	const std::string &	,
		const bool	LOOP = false
	)

creates a buffer for an mp3 sound if one doesn't already exist, then creates a source

Definition at line 599 of file al_sound.cpp.

References AUDCreateSoundMP3().

Referenced by AUDCreateMusic().

{
    return AUDCreateSoundMP3( s, true, LOOP );
}

int AUDCreateMusicWAV	(	const std::string &	,
		const bool	LOOP = false
	)

creates a buffer if one doesn't already exists, and then creates a source

Definition at line 545 of file al_sound.cpp.

References AUDCreateSoundWAV().

Referenced by AUDCreateMusic().

{
    return AUDCreateSoundWAV( s, true, LOOP );
}

int AUDCreateSound	(	int	sound,
		const bool	LOOP = false
	)

copies other sound loaded through AUDCreateSound

Definition at line 627 of file al_sound.cpp.

References AUDIsPlaying(), and AUDStopPlaying().

{
#ifdef HAVE_AL
    if ( AUDIsPlaying( sound ) )
        AUDStopPlaying( sound );
    if ( sound >= 0 && sound < (int) sounds.size() )
        return LoadSound( sounds[sound].buffer, LOOP, false );
#endif
    return -1;
}

int AUDCreateSound	(	const std::string &	,
		const bool	LOOP = false
	)

guesses the type of sound by extension

Definition at line 604 of file al_sound.cpp.

References AUDCreateSoundMP3(), and AUDCreateSoundWAV().

Referenced by AddMounts(), AddSounds(), Beam::Beam(), GameStarSystem::DoJumpingLeaveSightAndSound(), Mount::PhysicsAlignedFire(), Mount::ReplaceSound(), GameUnit< UnitType >::Thrust(), and GameUnit< UnitType >::TransferUnitToSystem().

{
    if ( s.end()-1 >= s.begin() ) {
        if (*(s.end()-1) == '3')
            return AUDCreateSoundMP3( s, LOOP );
        else
            return AUDCreateSoundWAV( s, LOOP );
    }
    return -1;
}

int AUDCreateSoundMP3	(	const std::string &	,
		const bool	LOOP = false
	)

creates a buffer for an mp3 sound if one doesn't already exist, then creates a source

Definition at line 594 of file al_sound.cpp.

References AUDCreateSoundMP3().

{
    return AUDCreateSoundMP3( s, false, LOOP );
}

int AUDCreateSoundWAV	(	const std::string &	,
		const bool	LOOP = false
	)

creates a buffer if one doesn't already exists, and then creates a source

Definition at line 540 of file al_sound.cpp.

References AUDCreateSoundWAV().

{
    return AUDCreateSoundWAV( s, false, LOOP );
}

void AUDDeleteSound	(	int	sound,
		bool	music = false
	)

deletes a given sound

Definition at line 639 of file al_sound.cpp.

References AUDIsPlaying(), AUDStopPlaying(), soundstodelete, and VSFileSystem::vs_fprintf().

Referenced by AUDDestroy(), AUDRefreshSounds(), Unit::ClearMounts(), BaseInterface::Room::Talk::Click(), Unit::Kill(), Music::Listen(), Mount::PhysicsAlignedFire(), UniverseUtil::playSound(), UniverseUtil::playSoundCockpit(), Beam::~Beam(), and soundContainer::~soundContainer().

{
#ifdef HAVE_AL
    if ( sound >= 0 && sound < (int) sounds.size() ) {
        if ( AUDIsPlaying( sound ) ) {
            if (!music) {
#ifdef SOUND_DEBUG
                printf( "AUDDeleteSound: Sound Playing enqueue soundstodelete %d %d\n",
                        sounds[sound].source,
                        sounds[sound].buffer );
#endif
                soundstodelete.push_back( sound );
                return;
            } else {
                AUDStopPlaying( sound );
            }
        }
#ifdef SOUND_DEBUG
        printf( "AUDDeleteSound: Sound Not Playing push back to unused src %d %d\n", sounds[sound].source, sounds[sound].buffer );
#endif
        if (sounds[sound].source) {
            unusedsrcs.push_back( sounds[sound].source );
            alSourcei( sounds[sound].source, AL_BUFFER, 0 );             //decrement the source refcount
            sounds[sound].source = (ALuint) 0;
        }
#ifdef SOUND_DEBUG
        if ( std::find( dirtysounds.begin(), dirtysounds.end(), sound ) == dirtysounds.end() ) {
#endif
        dirtysounds.push_back( sound );
#ifdef SOUND_DEBUG
    } else {
        VSFileSystem::vs_fprintf( stderr, "double delete of sound %d", sound );
        return;
    }
#endif
        //FIXME??
        //alDeleteSources(1,&sounds[sound].source);
        if (music)
            alDeleteBuffers( 1, &sounds[sound].buffer );
        sounds[sound].buffer = (ALuint) 0;
    }
#endif
}

void AUDDestroy

(

)

Definition at line 204 of file al_init.cpp.

References AUDDeleteSound(), AUDStopPlaying(), buffer, and i.

Referenced by cleanup().

{
#ifdef HAVE_AL
    //Go through and delete all loaded wavs
    unsigned int i;
    for (i = 0; i < sounds.size(); i++) {
        if (sounds[i].buffer != 0)
            AUDStopPlaying( i );
        AUDDeleteSound( i );
    }
    for (i = 0; i < unusedsrcs.size(); i++)
        alDeleteSources( 1, &unusedsrcs[i] );
    for (i = 0; i < buffers.size(); i++)
        alDeleteBuffers( 1, &buffers[i] );
    buffers.clear();
    if (context_id)
        alcDestroyContext( (ALCcontext*) context_id );
    if (dev)
        alcCloseDevice( dev );
#endif
}

float AUDGetCurrentPosition

(

const int

sound)

Gets the current playback position in seconds (precision is system&driver-dependant)

Definition at line 898 of file al_sound.cpp.

References AL_SEC_OFFSET, and float.

{
#ifdef HAVE_AL
    ALfloat rv;
    alGetSourcef( sound, AL_SEC_OFFSET, &rv );
    return float(rv);
#else
    return 0;
#endif
}

float AUDGetDoppler

(

)

Gets current doppler val.

Definition at line 112 of file al_init.cpp.

Referenced by decdop(), and incdop().

{
#ifdef HAVE_AL
    return scalevel;

#else
    return 1;
#endif
}

float AUDGetListenerGain

(

)

Definition at line 273 of file al_listen.cpp.

References Listener::gain, and mylistener.

Referenced by VolDown(), and VolUp().

{
#ifdef HAVE_AL
    return mylistener.gain;

#else
    return 0;
#endif
}

float AUDGetVolume

(

)

Definition at line 93 of file al_init.cpp.

Referenced by decvol(), and incvol().

{
#ifdef HAVE_AL
    return 1./scalepos;

#else
    return 1;
#endif
}

int AUDHighestSoundPlaying

(

)

Definition at line 738 of file al_sound.cpp.

References AUDIsPlaying().

Referenced by BaseInterface::BaseInterface().

{
    int retval     = -1;
#ifdef HAVE_AL
    unsigned int s = ::sounds.size();
    for (unsigned int i = 0; i < s; ++i)
        if (false == ::sounds[i].music && AUDIsPlaying( i ) && false == ::sounds[i].looping)
            retval = i;
#endif
    return retval;
}

bool AUDInit

(

)

Definition at line 132 of file al_init.cpp.

References game_data_t::audio_frequency_mode, g_game, VegaConfig::getVariable(), game_data_t::max_sound_sources, game_data_t::music_enabled, XMLSupport::parse_bool(), XMLSupport::parse_float(), XMLSupport::parse_int(), game_data_t::sound_enabled, and vs_config.

Referenced by main().

{
    g_game.sound_enabled = 
    g_game.music_enabled = false;
#ifdef HAVE_AL
    usedoppler    = XMLSupport::parse_bool( vs_config->getVariable( "audio", "Doppler", "false" ) );
    usepositional = XMLSupport::parse_bool( vs_config->getVariable( "audio", "Positional", "true" ) );
    double linuxadjust=1;
#ifndef _WIN32
#ifndef __APPLE__
    linuxadjust=1./3.;
#endif
#endif
    scalepos = 1.0f/(XMLSupport::parse_float( vs_config->getVariable( "audio", "Volume", "100" ) )
                  *linuxadjust
        );
    scalevel = XMLSupport::parse_float( vs_config->getVariable( "audio", "DopplerScale", "1" ) );
    //enabled = XMLSupport::parse_bool (vs_config->getVariable ("audio","enabled","true"));
    g_game.audio_frequency_mode = XMLSupport::parse_int( vs_config->getVariable( "audio", "frequency", "48000" ) );
    maxallowedsingle     = XMLSupport::parse_int( vs_config->getVariable( "audio", "MaxSingleSounds", "8" ) );
    g_game.max_sound_sources = 
    maxallowedtotal      = XMLSupport::parse_int( vs_config->getVariable( "audio", "MaxTotalSounds", "20" ) );
    bool sound_enabled = XMLSupport::parse_bool( vs_config->getVariable( "audio", "Sound", "true" ) );
    bool music_enabled = XMLSupport::parse_bool( vs_config->getVariable( "audio", "Music", "true" ) );
    if (!sound_enabled && !music_enabled)
        return false;
    int attrlist[] = {ALC_FREQUENCY, g_game.audio_frequency_mode, 0};
#ifdef _WIN32
    dev = alcOpenDevice(  (ALCchar*)"DirectSound3D" );
    // dev = alcOpenDevice(  (ALCubyte*)"DirectSound3D" ); pre update. New includes barf on ubyte. cannot convert parameter.
#else
#ifdef __APPLE__
    dev = alcOpenDevice( "sdl" );
    if (dev == NULL)
        dev = alcOpenDevice( NULL );
#else
    dev = alcOpenDevice( NULL );
#endif
#endif
    if (dev == NULL)
        return false;
    context_id = alcCreateContext( dev, attrlist );
    if (context_id == NULL) {
        alcCloseDevice( dev );
        return false;
    }
    alcMakeContextCurrent( (ALCcontext*) context_id );

    fixup_function_pointers();
    ALenum alGetEr = 0;
    ALuint cursrc;
    alGetError();
    alGenSources( 1, &cursrc );
    alGetEr = alGetError();
    while (alGetEr == 0) {
        unusedsrcs.push_back( cursrc );
        if (unusedsrcs.size() >= maxallowedtotal)
            break;
        alGenSources( 1, &cursrc );
        alGetEr = alGetError();
    }
    
    alDistanceModel(AL_INVERSE_DISTANCE_CLAMPED);
    
    g_game.sound_enabled = sound_enabled;
    g_game.music_enabled = music_enabled;
    
    return true;
#endif
    return false;
}

bool AUDIsPlaying

(

const int

sound)

Is a loaded sound still playing.

Definition at line 760 of file al_sound.cpp.

Referenced by GameUnit< UnitType >::ArmorDamageSound(), AUDCreateSound(), AUDDeleteSound(), AUDHighestSoundPlaying(), AUDPlay(), AUDRefreshSounds(), AUDStopAllSounds(), GameUnit< UnitType >::DealDamageToShield(), FireKeyboard::Execute(), GameUnit< UnitType >::HullDamageSound(), Music::Listen(), Mount::PhysicsAlignedFire(), Mount::PhysicsAlignedUnfire(), FireKeyboard::ProcessCommMessage(), FSM::Node::StopSound(), GameUnit< UnitType >::Thrust(), Beam::UpdatePhysics(), Unit::UpdatePhysics(), and UpdateTimeCompressionSounds().

{
#ifdef HAVE_AL
    if ( sound >= 0 && sound < (int) sounds.size() ) {
        if (!sounds[sound].source)
            return false;
        ALint state;
#if defined (_WIN32) || defined (__APPLE__)
        alGetSourcei( sounds[sound].source, AL_SOURCE_STATE, &state );         //Obtiene el estado de la fuente para windows
#else
        alGetSourceiv( sounds[sound].source, AL_SOURCE_STATE, &state );
#endif

        return state == AL_PLAYING;
    }
#endif
    return false;
}

void AUDListener	(	const QVector &	pos,
		const Vector &	vel
	)

Definition at line 210 of file al_listen.cpp.

References g_game, mylistener, Listener::pos, game_data_t::sound_enabled, and Listener::vel.

Referenced by Camera::UpdateCameraSounds(), and Camera::UpdateGFX().

{
#ifdef HAVE_AL
    mylistener.pos = pos.Cast();
    mylistener.vel = vel;
    if (g_game.sound_enabled) {
        if (usepositional)
            alListener3f( AL_POSITION, scalepos*pos.i, scalepos*pos.j, scalepos*pos.k );
        if (usedoppler)
            alListener3f( AL_VELOCITY, scalevel*vel.i, scalevel*vel.j, scalevel*vel.k );
    }
    //printf ("(%f,%f,%f) <%f %f %f>\n",pos.i,pos.j,pos.k,vel.i,vel.j,vel.k);
#endif
}

void AUDListenerGain

(

const float

gain)

Definition at line 259 of file al_listen.cpp.

References AUDSoundGain(), g_game, Listener::gain, i, mylistener, and game_data_t::sound_enabled.

Referenced by main(), VolDown(), and VolUp().

{
#ifdef HAVE_AL
    float gain = ggain;
    if (gain <= 0) gain = 1./16384;
    mylistener.gain = gain;
    for (unsigned int i = 0, ie = sounds.size(); i < ie; ++i)
        if (!sounds[i].music)
            AUDSoundGain( i, sounds[i].gain, false );
    if (g_game.sound_enabled)
        alListenerf( AL_GAIN, 1.0 );
#endif
}

QVector AUDListenerLocation

(

)

Definition at line 60 of file al_listen.cpp.

References mylistener, Listener::pos, and QVector.

Referenced by EstimateGain(), and Mount::PhysicsAlignedFire().

{
    return mylistener.pos.Cast();
}

void AUDListenerOrientation	(	const Vector &	i,
		const Vector &	j,
		const Vector &	k
	)

Will the sound be played.

Definition at line 232 of file al_listen.cpp.

References g_game, mylistener, Listener::p, Listener::q, q, Listener::r, and game_data_t::sound_enabled.

Referenced by Camera::UpdateCameraSounds(), and Camera::UpdateGFX().

{
#ifdef HAVE_AL
    mylistener.p = p;
    mylistener.q = q;
    mylistener.r = r;
    ALfloat orient[] = {r.i, r.j, r.k, q.i, q.j, q.k};
    //printf ("R%f,%f,%f>Q<%f %f %f>",r.i,r.j,r.k,q.i,q.j,q.k);
    if (g_game.sound_enabled)
        alListenerfv( AL_ORIENTATION, orient );
#endif
}

void AUDListenerSize

(

const float

size)

Sets the size in which all sounds are going to be played.

Definition at line 225 of file al_listen.cpp.

References mylistener, and Listener::rsize.

Referenced by createObjects().

{
#ifdef HAVE_AL
    mylistener.rsize = rSize*rSize;
#endif
}

void AUDPausePlaying

(

const int

sound)

Pauses a loaded sound.

Definition at line 909 of file al_sound.cpp.

{
#ifdef HAVE_AL
    if ( sound >= 0 && sound < (int) sounds.size() ) {
        //alSourcePlay( sounds[sound].source() );
    }
#endif
}

void AUDPlay	(	const int	sound,
		const QVector &	pos,
		const Vector &	vel,
		const float	gain
	)

Queries if the sound should be culled. If not, plays.

Definition at line 862 of file al_sound.cpp.

References AUDAddWatchedPlayed(), AUDAdjustSound(), AUDIsPlaying(), AUDQueryAudability(), AUDReclaimSource(), AUDSoundGain(), AUDStopPlaying(), QVector, starSystemOK(), and VSFileSystem::vs_dprintf().

Referenced by abletodock(), GameUnit< UnitType >::ArmorDamageSound(), Beam::Collide(), GameUnit< UnitType >::DealDamageToShield(), GameStarSystem::DoJumpingLeaveSightAndSound(), FireKeyboard::Execute(), GameUnit< UnitType >::Explode(), GameUnit< UnitType >::HullDamageSound(), Mount::PhysicsAlignedFire(), soundContainer::playsound(), FireKeyboard::ProcessCommMessage(), GameCockpit::ScrollVDU(), GameUnit< UnitType >::Thrust(), GameUnit< UnitType >::TransferUnitToSystem(), and GameCockpit::VDUSwitch().

{
#ifdef HAVE_AL
    char tmp;
    if (sound < 0)
        return;
    if (sounds[sound].buffer == 0)
        return;
    if (!starSystemOK() && !sounds[sound].music)
        return;
    if ( AUDIsPlaying( sound ) )
        AUDStopPlaying( sound );
    if ( ( tmp = AUDQueryAudability( sound, pos.Cast(), vel, gain ) ) != 0 ) {
        if ( AUDReclaimSource( sound, pos == QVector( 0, 0, 0 ) ) ) {
            AUDAdjustSound( sound, pos, vel );
            AUDSoundGain( sound, gain, sounds[sound].music );
            if (tmp != 2) {
                VSFileSystem::vs_dprintf(3, "AUDPlay sound %d %d\n", 
                    sounds[sound].source, sounds[sound].buffer );
                AUDAddWatchedPlayed( sound, pos.Cast() );
            } else {
                VSFileSystem::vs_dprintf(3, "AUDPlay stole sound %d %d\n", 
                    sounds[sound].source, sounds[sound].buffer );
                alSourceStop( sounds[sound].source );
            }
            alSourcePlay( sounds[sound].source );
        }
    }
#endif
}

void AUDRefreshSounds

(

)

Checks if sounds are still playing.

Definition at line 174 of file al_listen.cpp.

References AUDDeleteSound(), AUDIsPlaying(), hashsize, i, j, k, playingbuffers, soundstodelete, and totalplaying.

Referenced by StarSystem::Update().

{
#ifdef HAVE_AL
    static unsigned int i = 0;
    if (i >= hashsize) {
        i = 0;
    } else {
        for (unsigned int j = 0; j < playingbuffers[i].size(); j++)
            if ( !AUDIsPlaying( playingbuffers[i][j].soundname ) ) {
                totalplaying--;
                if (sounds[playingbuffers[i][j].soundname].source != (ALuint) 0) {
                    unusedsrcs.push_back( sounds[playingbuffers[i][j].soundname].source );
                    alSourcei( sounds[playingbuffers[i][j].soundname].source, AL_BUFFER, 0 );
                    sounds[playingbuffers[i][j].soundname].source = (ALuint) 0;
                }
                ApproxSoundVec::iterator k = playingbuffers[i].begin();
                k += j;
                playingbuffers[i].erase( k );
                j--;
            }
        ++i;
    }
    static unsigned int j = 0;
    if ( j >= soundstodelete.size() ) {
        j = 0;
    } else {
        int tmp = soundstodelete[j];
        if ( !AUDIsPlaying( tmp ) ) {
            soundstodelete.erase( soundstodelete.begin()+j );
            AUDDeleteSound( tmp, false );
        }
        ++j;
    }
#endif
}

void AUDSoundGain	(	int	sound,
		float	gain,
		bool	music = false
	)

Changes the gain of a loaded sound.

Definition at line 245 of file al_listen.cpp.

References Listener::gain, and mylistener.

Referenced by AUDListenerGain(), AUDPlay(), AUDStartPlaying(), Beam::Draw(), Music::Listen(), and Mount::PhysicsAlignedFire().

{
#ifdef HAVE_AL
    if ( sound >= 0 && sound < (int) sounds.size() ) {
        sounds[sound].music = music;
        float val = gain*(music ? 1.0f : mylistener.gain);
        if (sounds[sound].source)
            alSourcef( sounds[sound].source, AL_GAIN, val <= 1./16384 ? 0 : val );
        sounds[sound].gain = gain;
        //alSourcefv(sounds[sound].source,AL_VELOCITY,v);
    }
#endif
}

void AUDStartPlaying

(

const int

sound)

Plays a loaded sound.

Definition at line 841 of file al_sound.cpp.

References AUDAdjustSound(), AUDReclaimSource(), AUDSoundGain(), QVector, and starSystemOK().

Referenced by BaseInterface::Room::Talk::Click(), Beam::Init(), Music::Listen(), UniverseUtil::playSound(), UniverseUtil::playSoundCockpit(), and Unit::UpdatePhysics().

{
#ifdef SOUND_DEBUG
    printf( "AUDStartPlaying(%d)", sound );
#endif

#ifdef HAVE_AL
    if ( sound >= 0 && sound < (int) sounds.size() ) {
        if ( sounds[sound].music || starSystemOK() )
            if ( AUDReclaimSource( sound, sounds[sound].pos == QVector( 0, 0, 0 ) ) ) {
#ifdef SOUND_DEBUG
                printf( "AUDStartPlaying sound %d source:%d buffer:%d\n", sound, sounds[sound].source, sounds[sound].buffer );
#endif
                AUDAdjustSound( sound, sounds[sound].pos, sounds[sound].vel );
                AUDSoundGain( sound, sounds[sound].gain, sounds[sound].music );
                alSourcePlay( sounds[sound].source );
            }
    }
#endif
}

void AUDStopAllSounds

(

int

except_this_one = -1)

Definition at line 750 of file al_sound.cpp.

References AUDIsPlaying(), and AUDStopPlaying().

Referenced by BaseComputer::actionDone(), base_main_loop(), UniverseUtil::StopAllSounds(), and GameUnit< UnitType >::TransferUnitToSystem().

{
#ifdef HAVE_AL
    unsigned int s = ::sounds.size();
    for (unsigned int i = 0; i < s; ++i)
        if ( (int) i != except_this_one && false == ::sounds[i].music && AUDIsPlaying( i ) )
            AUDStopPlaying( i );
#endif
}

void AUDStopPlaying

(

const int

sound)

Stops a loaded sound.

Definition at line 779 of file al_sound.cpp.

Referenced by GameUnit< UnitType >::ArmorDamageSound(), AUDCreateSound(), AUDDeleteSound(), AUDDestroy(), AUDPlay(), AUDStopAllSounds(), GameUnit< UnitType >::DealDamageToShield(), DestroyMount(), GameUnit< UnitType >::HullDamageSound(), Unit::Kill(), Mount::PhysicsAlignedFire(), Mount::PhysicsAlignedUnfire(), FSM::Node::StopSound(), GameUnit< UnitType >::Thrust(), Beam::UpdatePhysics(), Unit::UpdatePhysics(), UpdateTimeCompressionSounds(), and soundContainer::~soundContainer().

{
#ifdef HAVE_AL
    if ( sound >= 0 && sound < (int) sounds.size() ) {
#ifdef SOUND_DEBUG
        printf( "AUDStopPlaying sound %d source(releasing): %d buffer:%d\n", sound, sounds[sound].source, sounds[sound].buffer );
#endif
        if (sounds[sound].source != 0) {
            alSourceStop( sounds[sound].source );
            unusedsrcs.push_back( sounds[sound].source );
            alSourcei( sounds[sound].source, AL_BUFFER, 0 );             //decrement refcount
        }
        sounds[sound].source = (ALuint) 0;
    }
#endif
}

void AUDStreamingSound

(

const int

sound)

Setup the sound as a streaming source (this means right now only that it doesn't do 3D positional stuff)

Definition at line 714 of file al_sound.cpp.

References Audio::alSource3f().

Referenced by Music::Listen().

{
#ifdef HAVE_AL
    if (sound >= 0 && sound < (int) sounds.size() && sounds[sound].source) {
        alSource3f( sounds[sound].source, AL_POSITION, 0.0, 0.0, 0.0 );
        alSource3f( sounds[sound].source, AL_VELOCITY, 0.0, 0.0, 0.0 );
        alSource3f( sounds[sound].source, AL_DIRECTION, 0.0, 0.0, 0.0 );
        alSourcef( sounds[sound].source, AL_ROLLOFF_FACTOR, 0.0 );
        alSourcei( sounds[sound].source, AL_SOURCE_RELATIVE, AL_TRUE );
    }
#endif
}