ambience.c File Reference

Go to the source code of this file.

Data Structures
struct	AmbientSoundSettings

Enumerations
enum	AmbientSoundState { AMBIENT_SOUND_IDLE = 0 , AMBIENT_SOUND_FADE_OUT = 1 , AMBIENT_SOUND_FADE_IN = 2 }

Functions
void	reset_ambient_sounds (void)
void	update_ambient_sounds (void)
s32	play_ambient_sounds (s32 soundID, s32 fadeTime)

Variables
AmbientSoundSettings	DefaultAmbientSoundData
AmbientSoundSettings	AmbientSoundData

---

Data Structure Documentation

AmbientSoundSettings

struct AmbientSoundSettings

Data Fields
s16	flags
s16	fadeState
s32	fadeTime
s32	soundID
s32	unkC

Enumeration Type Documentation

AmbientSoundState

enum AmbientSoundState

Enumerator
AMBIENT_SOUND_IDLE
AMBIENT_SOUND_FADE_OUT
AMBIENT_SOUND_FADE_IN

Definition at line 12 of file ambience.c.

                               {
    AMBIENT_SOUND_IDLE        = 0,
    AMBIENT_SOUND_FADE_OUT    = 1,  // fade out old sounds
    AMBIENT_SOUND_FADE_IN     = 2   // fade in new sounds
} AmbientSoundState;

Function Documentation

reset_ambient_sounds()

void reset_ambient_sounds

(

void

)

Definition at line 28 of file ambience.c.

                                {
    AmbientSoundData = DefaultAmbientSoundData;
}

Referenced by load_engine_data().

update_ambient_sounds()

void update_ambient_sounds

(

void

)

Definition at line 32 of file ambience.c.

                                 {
    AmbientSoundSettings* ambientSoundState = &AmbientSoundData;
    s32 error;
 
    switch (ambientSoundState->fadeState) {
        case AMBIENT_SOUND_IDLE:
            break;
        case AMBIENT_SOUND_FADE_OUT:
            if (ambientSoundState->flags & 1) {
                if (ambientSoundState->fadeTime < 250) {
                    error = snd_ambient_stop_quick(0);
                } else {
                    error = snd_ambient_stop_slow(0, ambientSoundState->fadeTime);
                }
 
                if (error != AU_RESULT_OK) {
                    return;
                }
            }
            ambientSoundState->fadeState = AMBIENT_SOUND_FADE_IN;
            break;
        case AMBIENT_SOUND_FADE_IN:
            if (ambientSoundState->flags & 1) {
                if (snd_ambient_is_stopped(0) != AU_RESULT_OK) {
                    return;
                }
                ambientSoundState->flags &= ~1;
            }
            if (ambientSoundState->soundID < 0) {
                ambientSoundState->fadeState = AMBIENT_SOUND_IDLE;
            } else if (snd_load_ambient(ambientSoundState->soundID) == AU_RESULT_OK) {
                if (snd_ambient_play(0, 0) == AU_RESULT_OK) {
                    ambientSoundState->fadeState = AMBIENT_SOUND_IDLE;
                    ambientSoundState->flags |= 1;
                }
            }
            break;
    }
}

Referenced by step_game_loop().

play_ambient_sounds()

s32 play_ambient_sounds	(	s32	soundID,
		s32	fadeTime )

Definition at line 72 of file ambience.c.

                                                   {
    AmbientSoundSettings* state = &AmbientSoundData;
 
    if (!gGameStatusPtr->musicEnabled) {
        snd_ambient_stop_quick(state->soundID);
        state->flags &= ~1;
        return 1;
    }
 
    if (state->soundID == soundID) {
        return 2;
    }
 
    state->soundID = soundID;
    state->fadeTime = fadeTime;
    state->fadeState = AMBIENT_SOUND_FADE_OUT;
    return 1;
}

Variable Documentation

DefaultAmbientSoundData

AmbientSoundSettings DefaultAmbientSoundData

Initial value:

= {
    .flags = 0,
    .fadeState = 0,
    .fadeTime = 0,
    .soundID = -1,
    .unkC = -1
}

Definition at line 18 of file ambience.c.

                                               {
    .flags = 0,
    .fadeState = 0,
    .fadeTime = 0,
    .soundID = -1,
    .unkC = -1
};

Referenced by reset_ambient_sounds().

AmbientSoundData

AmbientSoundSettings AmbientSoundData

Definition at line 26 of file ambience.c.

Referenced by play_ambient_sounds(), reset_ambient_sounds(), and update_ambient_sounds().