src/engine/eSound.h File Reference

#include "rSDL.h"
#include "defs.h"
#include "tString.h"
#include "tLinkedList.h"

Include dependency graph for eSound.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
class	eAudioPos
class	eWavData
class	eSoundPlayer
Functions
void	se_SoundInit ()
void	se_SoundExit ()
void	se_SoundLock ()
void	se_SoundUnlock ()
void	se_SoundPause (bool p)
void	se_SoundMenu ()

---

Function Documentation

void se_SoundExit

(

)

Definition at line 257 of file eSound.cpp.

References con, NULL, se_SoundLock(), se_SoundPause(), se_SoundUnlock(), sound_is_there, eWavData::UnloadAll(), and uses_sdl_mixer.

Referenced by se_SoundInit(), and se_SoundMenu().

                   {
#ifndef DEDICATED
    se_SoundLock();

    eWavData::UnloadAll();
    se_SoundPause(true);

    se_SoundUnlock();

    if (sound_is_there){
#ifdef DEBUG
        con << tOutput("$sound_disabling");
#endif
        //              se_SoundPause(false);
        //    for(int i=wavs.Len()-1;i>=0;i--)
        //wavs(i)->Exit();

#ifdef HAVE_LIBSDL_MIXER
        if ( music )
        {
            if( Mix_PlayingMusic() )
            {
                Mix_FadeOutMusic(100);
                SDL_Delay(100);
            }
            Mix_FreeMusic( music );
            music = NULL;
        }

        se_SoundPause(true);

        if ( uses_sdl_mixer )
            Mix_CloseAudio();
        else
#endif
            SDL_CloseAudio();

#ifdef DEBUG
        con << tOutput("$sound_disabling_done");
#endif
    }
    sound_is_there=false;
#endif
}

Here is the call graph for this function:

Here is the caller graph for this function:

void se_SoundInit

(

)

Definition at line 139 of file eSound.cpp.

References audio, buffer_shift, con, tDirectories::Data(), fill_audio(), tPath::GetReadPath(), NULL, se_SoundExit(), tOutput::SetTemplateParameter(), SOUND_HIGH, sound_is_there, SOUND_LOW, SOUND_MED, SOUND_OFF, sound_quality, st_FirstUse, st_SaveConfig(), and uses_sdl_mixer.

Referenced by se_SoundMenu().

{
#ifndef DEDICATED
    // save configuration file with sound disabled on first use so we don't try again
    bool needSave = false;
    static bool firstRun = true;
    if ( st_FirstUse )
    {
        needSave = true;
        int sound_quality_back = sound_quality;
        sound_quality = SOUND_OFF;
        st_SaveConfig();
        if ( firstRun )
            con << tOutput("$sound_firstinit");
        sound_quality=sound_quality_back;
    }

    if ( sound_quality != SOUND_OFF )
    {
#ifdef DEFAULT_SDL_AUDIODRIVER
        static bool init = se_SoundInitPrepare();
        if ( !init )
            return;
#endif
        if ( firstRun && !SDL_WasInit( SDL_INIT_AUDIO ) )
            return;
        firstRun = false;
    }

    if (!sound_is_there && sound_quality!=SOUND_OFF)
    {
        SDL_AudioSpec desired;

        switch (sound_quality)
        {
        case SOUND_LOW:
            desired.freq=11025; break;
        case SOUND_MED:
            desired.freq=22050; break;
        case SOUND_HIGH:
            desired.freq=44100; break;
        default:
            desired.freq=22050;
        }

        desired.format=AUDIO_S16SYS;
        desired.samples=128;
        while (desired.samples <= desired.freq >> (6-buffer_shift))
            desired.samples <<= 1;
        desired.channels = 2;
        desired.callback = fill_audio;
        desired.userdata = NULL;

#ifdef HAVE_LIBSDL_MIXER
        uses_sdl_mixer=true;

        // init using SDL_Mixer
        sound_is_there=(Mix_OpenAudio(desired.freq, desired.format, desired.channels, desired.samples)>=0);

        if ( sound_is_there )
        {
            // query actual sound info
            audio = desired;
            int channels;
            Mix_QuerySpec( &audio.freq, &audio.format, &channels );
            audio.channels = channels;

            // register callback
            Mix_SetPostMix( &fill_audio, NULL );

            const tPath& vpath = tDirectories::Data();
            tString musFile = vpath.GetReadPath( "music/fire.xm" );

            music = Mix_LoadMUS( musFile );

            if ( music )
                Mix_FadeInMusic( music, -1, 2000 );

        }
#else
        // just use SDL to init sound
        uses_sdl_mixer=false;
        sound_is_there=(SDL_OpenAudio(&desired,&audio)>=0);
#endif
        if (sound_is_there && (audio.format!=AUDIO_S16SYS || audio.channels!=2))
        {
            uses_sdl_mixer=false;
            se_SoundExit();
            // force emulation of 16 bit stereo; sadly, this cannot use SDL_Mixer :-(
            audio.format=AUDIO_S16SYS;
            audio.channels=2;
            sound_is_there=(SDL_OpenAudio(&audio,NULL)>=0);
            con << tOutput("$sound_error_no16bit");
        }
        if (!sound_is_there)
            con << tOutput("$sound_error_initfailed");
        else
        {
            //for(int i=wavs.Len()-1;i>=0;i--)
            //wavs(i)->Init();
#ifdef DEBUG
            tOutput o;
            o.SetTemplateParameter(1,audio.freq);
            o.SetTemplateParameter(2,audio.samples);
            o << "$sound_inited";
            con << o;
#endif
        }
    }

    // save sound settings, they appear to work
    if ( needSave )
    {
        st_SaveConfig();
    }
#endif
}

Here is the call graph for this function:

Here is the caller graph for this function:

void se_SoundLock

(

)

Definition at line 306 of file eSound.cpp.

Referenced by eSoundPlayer::MakeGlobal(), se_SoundExit(), and eWavData::Unload().

                   {
#ifndef DEDICATED
    if (!locks)
        SDL_LockAudio();
    locks++;
#endif
}

Here is the caller graph for this function:

void se_SoundMenu

(

)

Definition at line 856 of file eSound.cpp.

                   {
    //  se_SoundPause(true);
    //  se_SoundLock();
    int oldsettings=sound_quality;
    int oldshift=buffer_shift;
    Sound_menu.Enter();
    if (oldsettings!=sound_quality || oldshift!=buffer_shift){
        se_SoundExit();
        se_SoundInit();
    }
    //  se_SoundUnlock();
    //  se_SoundPause(false);
}

void se_SoundPause

(

bool

p

)

Definition at line 322 of file eSound.cpp.

Referenced by se_SoundExit().

                          {
#ifndef DEDICATED
    SDL_PauseAudio(p);
#endif
}

Here is the caller graph for this function:

void se_SoundUnlock

(

)

Definition at line 314 of file eSound.cpp.

Referenced by eSoundPlayer::MakeGlobal(), se_SoundExit(), and eWavData::Unload().

                     {
#ifndef DEDICATED
    locks--;
    if (!locks)
        SDL_UnlockAudio();
#endif
}

Here is the caller graph for this function:

---