snd_interface.c File Reference

Go to the source code of this file.

Functions
void	snd_notify_engine_ready (ALHeap *heap)
void	snd_legacy_sound_dispatch (u32 id)
	Unused Seems to be an early function that accepts a command to play any kind of audio asset,.
void	snd_bgm_clear_legacy_commands (BGMPlayer *player)
	Part of an unused system for inter-thread communication with a BGM player using commands.
void	snd_bgm_enqueue_legacy_command (u32 cmd)
	Unused Part of an unused system for inter-thread communication with a BGM player using commands.
void	snd_start_sound (s32 soundID, u8 volume, u8 pan)
void	snd_start_sound_with_shift (s32 soundID, u8 volume, u8 pan, s16 pitchShift)
void	snd_adjust_sound (s32 soundID, u8 volume, u8 pan)
void	snd_adjust_sound_with_shift (s32 soundID, u8 volume, u8 pan, s16 pitchShift)
void	snd_stop_sound (s32 soundID)
void	snd_reset (void)
void	snd_start_sound_raw (s32 soundID, s16 volume, s16 pitchShift, s32 pan)
AuResult	snd_load_ambient (s32 ambSoundID)
AuResult	snd_ambient_play (s32 index, s32 fadeInTime)
AuResult	snd_ambient_stop_quick (s32 index)
AuResult	snd_ambient_stop_slow (s32 index, s32 fadeOutTime)
AuResult	snd_ambient_pause (s32 index, s32 fadeOutTime)
AuResult	snd_ambient_resume (s32 index, s32 fadeInTime)
AuResult	snd_ambient_is_stopped (s32 index)
AuResult	snd_ambient_fade_out (s32 index, s32 arg1)
AuResult	snd_ambient_set_volume (s32 index, s32 time, s32 volume)
AuResult	snd_ambient_disable (s32 index)
AuResult	snd_ambient_enable (s32 index)
void	snd_ambient_radio_setup (s32 index)
AuResult	snd_ambient_radio_stop (s32 time)
AuResult	snd_ambient_radio_select (s32 index)
AuResult	snd_song_load (s32 songID, s32 playerIndex)
	return value may be either an AuResult error code OR a valid songName
AuResult	snd_song_request_play_default (s32 songName)
	Unused – snd_song_request_play but always uses BGM_VARIATION_0.
AuResult	snd_song_request_play (s32 songName, s32 variation)
	Called from bgm_control to start playing a particular song + variation.
AuResult	snd_song_stop (s32 songName)
void	snd_song_stop_all (void)
AuResult	snd_song_is_playing (s32 songName)
AuResult	snd_song_request_fade_in (s32 songName, s32 variation, s32 fadeInTime, s32 startVolume, s32 endVolume)
	Called from bgm_control to fade in a particular song + variation.
AuResult	snd_song_request_fade_in_default (s32 songName, s32 fadeInTime, s32 startVolume, s32 endVolume)
	Unused.
AuResult	snd_song_request_fade_out (s32 songName, s32 fadeTime, AuCallback callback)
AuResult	snd_song_push_stop (s32 songName)
AuResult	snd_song_request_pop (s32 songName)
AuResult	snd_song_request_snapshot (s32 songName)
AuResult	snd_song_request_push_fade_out (s32 songName, s32 fadeTime)
AuResult	snd_song_request_pause (s32 songName)
AuResult	snd_song_request_unpause (s32 songName)
AuResult	snd_song_set_volume_quiet (s32 songName)
AuResult	snd_song_set_volume_full (s32 songName)
AuResult	snd_song_set_linked_mode (s32 songName, b32 mode)
AuResult	snd_song_get_playing_info (s32 songName, BGMHeader **outFile, BGMPlayer **outPlayer)
AuResult	snd_song_set_playback_rate (s32 songName, f32 rate)
AuResult	snd_song_set_detune (s32 songName, s32 detune)
AuResult	snd_song_set_track_volumes (s32 songName, MusicTrackVols trackVolSet)
AuResult	snd_song_clear_track_volumes (s32 songName, MusicTrackVols trackVolSet)
AuResult	snd_song_set_track_vol_mute (s32 songName, s32 trackIdx)
AuResult	snd_song_set_track_vol_quiet (s32 songName, s32 trackIdx)
AuResult	snd_song_set_track_vol_full (s32 songName, s32 trackIdx)
void	snd_song_set_proximity_mix_far (s32 songName, s32 mix)
void	snd_song_set_proximity_mix_near (s32 songName, s32 mix)
void	snd_song_set_proximity_mix_full (s32 songName, s32 mix)
void	snd_song_poll_music_events (MusicEventTrigger **musicEvents, s32 *count)
void	snd_song_flush_music_events (void)
void	snd_song_trigger_music_event (s32 playerID, s32 trackIndex, s32 eventInfo)
void	snd_song_clear_music_events (void)
void	snd_register_callback (AuCallback func, s32 index)
void	snd_set_stereo (void)
void	snd_set_mono (void)
void	snd_set_bgm_volume (VolumeLevels volume)
void	snd_set_sfx_volume (VolumeLevels volume)
void	snd_set_sfx_reverb_type (s32 reverbType)
void	snd_enable_sfx (void)
void	snd_disable_sfx (void)

Variables
s32	PreventBGMPlayerUpdate = FALSE
	While TRUE, the audio thread skips BGM player updates.
u16	SoundEngineReady = 0
u16	AmbienceRadioChannel = 0
u8	TrackVols_JAN_Full []
u8	TrackVols_Unused1 []
u8	TrackVols_TIK_Shiver []
u8	TrackVols_Unused3 []
u8	TrackVols_KPA_Outside []
u8	TrackVols_KPA_1 []
u8	TrackVols_KPA_2 []
u8	TrackVols_KPA_3 []

Function Documentation

snd_notify_engine_ready()

void snd_notify_engine_ready

(

ALHeap *

heap

)

Definition at line 108 of file snd_interface.c.

                                           {
    SoundEngineReady = 1;
    PreventBGMPlayerUpdate = FALSE;
}

Referenced by au_engine_init().

snd_legacy_sound_dispatch()

void snd_legacy_sound_dispatch

(

u32

id

)

Unused Seems to be an early function that accepts a command to play any kind of audio asset,.

Definition at line 116 of file snd_interface.c.

                                       {
    u16 ready = SoundEngineReady;
    u32 type = id & 0xF;
 
    if (ready == 1) {
        switch (type) {
            case 2:
            case 3:
                break;
            case 4:
                snd_start_sound_with_shift(id >> 4, 0, 0, 0);
                break;
            case 1:
                if (type == 1) {
                    s32 filename = snd_song_load((id >> 4) & 0xFF, 0);
 
                    if (filename > ASCII_TO_U32('0', ' ', ' ', '\0')) {
                        snd_song_request_play(filename, (id >> 0xC) & 3);
                    }
                }
                break;
        }
    }
}

snd_bgm_clear_legacy_commands()

void snd_bgm_clear_legacy_commands

(

BGMPlayer *

player

)

Part of an unused system for inter-thread communication with a BGM player using commands.

Use functions in bgm_control to manipualte gMusicControlData instead.

Definition at line 143 of file snd_interface.c.

                                                      {
    s32 i;
 
    for (i = 0; i < ARRAY_COUNT(player->cmdBufData); i++) {
        player->cmdBufData[i] = 0;
    }
 
    player->cmdBufOverflows = 0;
    player->cmdBufWritePos = 0;
    player->cmdBufReadPos = 0;
    player->cmdBufPending = 0;
}

Referenced by au_bgm_player_init().

snd_bgm_enqueue_legacy_command()

void snd_bgm_enqueue_legacy_command

(

u32

cmd

)

Unused Part of an unused system for inter-thread communication with a BGM player using commands.

Use functions in bgm_control to manipualte gMusicControlData instead.

Definition at line 159 of file snd_interface.c.

                                             {
    BGMPlayer* player = NULL;
    u32 playerID = cmd & 0xF;
 
    if (playerID == 0) {
        return;
    } else if (playerID == 1) {
        player = gBGMPlayerA;
    } else if (playerID == 2) {
        player = gBGMPlayerB;
    }
 
    if (player != NULL) {
        u32 pos;
 
        if (player->cmdBufPending < ARRAY_COUNT(player->cmdBufData)) {
            pos = player->cmdBufWritePos;
 
            player->cmdBufData[pos] = cmd >> 4;
 
            pos++;
            if (pos >= 8) {
                pos = 0;
            }
            player->cmdBufWritePos = pos;
 
            player->cmdBufPending++;
        } else {
            pos = player->cmdBufOverflows + 1;
 
            if (pos > 99) {
                pos = 99;
            }
            player->cmdBufOverflows = pos;
        }
    }
}

snd_start_sound()

void snd_start_sound	(	s32	soundID,
		u8	volume,
		u8	pan )

Definition at line 197 of file snd_interface.c.

                                                     {
    SoundManager* soundManager = gSoundManager;
    s16 vol = volume << 8;
 
    if (vol != 0) {
        vol |= 0xFF;
    }
 
    if (pan > AU_PAN_MAX) {
        pan = AU_PAN_MAX;
    }
 
    au_sfx_enqueue_event(soundManager, soundID, vol, 0, pan);
}

snd_start_sound_with_shift()

void snd_start_sound_with_shift	(	s32	soundID,
		u8	volume,
		u8	pan,
		s16	pitchShift )

Definition at line 212 of file snd_interface.c.

                                                                                {
    SoundManager* soundManager = gSoundManager;
    s16 vol = volume << 8;
 
    if (vol != 0) {
        vol |= 0xFF;
    }
 
    if (pan > AU_PAN_MAX) {
        pan = AU_PAN_MAX;
    }
 
    if (pitchShift > 2 * AU_OCTAVE_CENTS) {
        pitchShift = 2 * AU_OCTAVE_CENTS;
    } else if (pitchShift < -2 * AU_OCTAVE_CENTS) {
        pitchShift = -2 * AU_OCTAVE_CENTS;
    }
 
    au_sfx_enqueue_event(soundManager, soundID, vol, pitchShift, pan);
}

Referenced by sfx_clear_env_sounds(), sfx_play_sound_looping(), sfx_play_sound_with_params(), and snd_legacy_sound_dispatch().

snd_adjust_sound()

void snd_adjust_sound	(	s32	soundID,
		u8	volume,
		u8	pan )

Definition at line 233 of file snd_interface.c.

                                                      {
    SoundManager* soundManager = gSoundManager;
    s16 vol = volume << 8;
 
    if (vol != 0) {
        vol |= 0xFF;
    }
 
    if (pan > AU_PAN_MAX) {
        pan = AU_PAN_MAX;
    }
 
    au_sfx_enqueue_event(soundManager, soundID | SOUND_ID_ADJUST, vol, 0, pan);
}

snd_adjust_sound_with_shift()

void snd_adjust_sound_with_shift	(	s32	soundID,
		u8	volume,
		u8	pan,
		s16	pitchShift )

Definition at line 248 of file snd_interface.c.

                                                                                 {
    SoundManager* soundManager = gSoundManager;
    s16 vol = volume << 8;
 
    if (vol != 0) {
        vol |= 0xFF;
    }
 
    if (pan > AU_PAN_MAX) {
        pan = AU_PAN_MAX;
    }
 
    if (pitchShift > 2 * AU_OCTAVE_CENTS) {
        pitchShift = 2 * AU_OCTAVE_CENTS;
    } else if (pitchShift < -2 * AU_OCTAVE_CENTS) {
        pitchShift = -2 * AU_OCTAVE_CENTS;
    }
 
    au_sfx_enqueue_event(soundManager, soundID | SOUND_ID_ADJUST, vol, pitchShift, pan);
}

Referenced by sfx_adjust_env_sound_params(), and sfx_update_env_sound_params().

snd_stop_sound()

void snd_stop_sound

(

s32

soundID

)

Definition at line 269 of file snd_interface.c.

                                 {
    SoundManager* soundManager = gSoundManager;
 
    au_sfx_enqueue_event(soundManager, soundID | SOUND_ID_STOP, 0, 0, 0);
}

Referenced by action_update_sliding(), sfx_stop_env_sounds(), sfx_stop_sound(), and sfx_stop_tracking_env_sound_pos().

snd_reset()

void snd_reset

(

void

)

Definition at line 275 of file snd_interface.c.

                     {
    gSoundManager->resetPending = 1;
}

snd_start_sound_raw()

void snd_start_sound_raw	(	s32	soundID,
		s16	volume,
		s16	pitchShift,
		s32	pan )

Definition at line 279 of file snd_interface.c.

                                                                           {
    SoundManager* soundManager = gSoundManager;
 
    au_sfx_enqueue_event(soundManager, soundID, volume, pitchShift, pan);
}

snd_load_ambient()

AuResult snd_load_ambient

(

s32

ambSoundID

)

Definition at line 285 of file snd_interface.c.

                                          {
    return au_ambient_load(ambSoundID);
}

Referenced by update_ambient_sounds().

snd_ambient_play()

AuResult snd_ambient_play	(	s32	index,
		s32	fadeInTime )

Definition at line 289 of file snd_interface.c.

                                                     {
    AuResult status = au_mseq_check_player_index(index);
 
    if (status != AU_RESULT_OK) {
        return status;
    }
    return au_mseq_start(index, fadeInTime);
}

Referenced by snd_ambient_radio_setup(), and update_ambient_sounds().

snd_ambient_stop_quick()

AuResult snd_ambient_stop_quick

(

s32

index

)

Definition at line 298 of file snd_interface.c.

                                           {
    AuResult status = au_mseq_check_player_index(index);
 
    if (status == AU_RESULT_OK) {
        au_mseq_stop_quick(index);
    }
 
    return status;
}

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

snd_ambient_stop_slow()

AuResult snd_ambient_stop_slow	(	s32	index,
		s32	fadeOutTime )

Definition at line 308 of file snd_interface.c.

                                                           {
    AuResult status = au_mseq_check_player_index(index);
 
    if (status == AU_RESULT_OK) {
        au_mseq_stop_slow(index, fadeOutTime);
    }
 
    return status;
}

Referenced by snd_ambient_radio_stop(), and update_ambient_sounds().

snd_ambient_pause()

AuResult snd_ambient_pause	(	s32	index,
		s32	fadeOutTime )

Definition at line 318 of file snd_interface.c.

                                                       {
    AuResult status = au_mseq_check_player_index(index);
 
    if (status == AU_RESULT_OK) {
        au_mseq_pause(index, fadeOutTime);
    }
 
    return status;
}

Referenced by bgm_push_battle_song().

snd_ambient_resume()

AuResult snd_ambient_resume	(	s32	index,
		s32	fadeInTime )

Definition at line 328 of file snd_interface.c.

                                                       {
    AuResult status = au_mseq_check_player_index(index);
 
    if (status == AU_RESULT_OK) {
        au_mseq_resume(index, fadeInTime);
    }
 
    return status;
}

Referenced by bgm_pop_battle_song().

snd_ambient_is_stopped()

AuResult snd_ambient_is_stopped

(

s32

index

)

Definition at line 338 of file snd_interface.c.

                                           {
    AuResult status = au_mseq_check_player_index(index);
 
    if (status != AU_RESULT_OK) {
        return status;
    }
    return au_mseq_check_stopped(index);
}

Referenced by update_ambient_sounds().

snd_ambient_fade_out()

AuResult snd_ambient_fade_out	(	s32	index,
		s32	arg1 )

Definition at line 347 of file snd_interface.c.

                                                   {
    AuResult status = au_mseq_check_player_index(index);
 
    if (status == AU_RESULT_OK) {
        au_mseq_load_tracks_fade(index, arg1);
    }
 
    return status;
}

snd_ambient_set_volume()

AuResult snd_ambient_set_volume	(	s32	index,
		s32	time,
		s32	volume )

Definition at line 357 of file snd_interface.c.

                                                                 {
    AuResult status = au_mseq_check_player_index(index);
 
    if (status == AU_RESULT_OK) {
        au_mseq_set_volume(index, time, volume);
    }
 
    return status;
}

snd_ambient_disable()

AuResult snd_ambient_disable

(

s32

index

)

Definition at line 367 of file snd_interface.c.

                                        {
    AuResult status = au_mseq_check_player_index(index);
 
    if (status == AU_RESULT_OK) {
        au_mseq_set_disabled(index, TRUE);
    }
 
    return status;
}

Referenced by snd_ambient_radio_select().

snd_ambient_enable()

AuResult snd_ambient_enable

(

s32

index

)

Definition at line 377 of file snd_interface.c.

                                       {
    AuResult status  = au_mseq_check_player_index(index);
 
    if (status == AU_RESULT_OK) {
        au_mseq_set_disabled(index, FALSE);
    }
 
    return status;
}

Referenced by snd_ambient_radio_select().

snd_ambient_radio_setup()

void snd_ambient_radio_setup

(

s32

index

)

Definition at line 387 of file snd_interface.c.

                                        {
    s32 radioChannels = 4;
    u32 i;
 
    AmbienceRadioChannel = 0xFF;
 
    for (i = 0; i < radioChannels; i++) {
        if (snd_ambient_play(i, 0) != AU_RESULT_OK) {
            return;
        }
    }
 
    snd_ambient_radio_select(index);
}

snd_ambient_radio_stop()

AuResult snd_ambient_radio_stop

(

s32

time

)

Definition at line 402 of file snd_interface.c.

                                          {
    AuResult status = AU_RESULT_OK;
    s32 radioChannels = 4;
    u32 i;
 
    for (i = 0; i < radioChannels; i++) {
        if (i == AmbienceRadioChannel) {
            status = snd_ambient_stop_slow(i, time);
        } else {
            status = snd_ambient_stop_quick(i);
        }
        if (status != AU_RESULT_OK) {
            break;
        }
    }
    return status;
}

snd_ambient_radio_select()

AuResult snd_ambient_radio_select

(

s32

index

)

Definition at line 420 of file snd_interface.c.

                                             {
    AuResult status = AU_RESULT_OK;
    s32 radioChannels = 4;
 
    if (index != AmbienceRadioChannel) {
        u32 i;
 
        for (i = 0; i < radioChannels; i++) {
            if (i == index) {
                status = snd_ambient_enable(i);
            } else {
                status = snd_ambient_disable(i); // mute
            }
 
            if (status != AU_RESULT_OK) {
                break;
            }
        }
 
        if (status == AU_RESULT_OK) {
            AmbienceRadioChannel = index;
        }
    }
 
    return status;
}

Referenced by snd_ambient_radio_setup().

snd_song_load()

AuResult snd_song_load	(	s32	songID,
		s32	playerIndex )

return value may be either an AuResult error code OR a valid songName

Definition at line 447 of file snd_interface.c.

                                                    {
    BGMHeader* bgmFile;
    BGMPlayer* player;
 
    au_get_bgm_player_and_file(playerIndex, &bgmFile, &player);
 
    if (bgmFile != NULL) {
        return au_load_song_files(songID, bgmFile, player);
    } else {
        return AU_ERROR_NULL_SONG_NAME;
    }
}

Referenced by bgm_update_music_control(), and snd_legacy_sound_dispatch().

snd_song_request_play_default()

AuResult snd_song_request_play_default

(

s32

songName

)

Unused – snd_song_request_play but always uses BGM_VARIATION_0.

Definition at line 461 of file snd_interface.c.

                                                     {
    AuResult status;
    SongStartRequest s;
 
    PreventBGMPlayerUpdate = TRUE;
    s.songName = songName;
    s.duration = 0;
    s.startVolume = AU_MAX_VOLUME_8;
    s.finalVolume = AU_MAX_VOLUME_8;
    s.variation = BGM_VARIATION_0;
    s.unused_14 = 0;
    status = au_bgm_process_init_song(&s);
    PreventBGMPlayerUpdate = FALSE;
 
    return status;
}

snd_song_request_play()

AuResult snd_song_request_play	(	s32	songName,
		s32	variation )

Called from bgm_control to start playing a particular song + variation.

Definition at line 479 of file snd_interface.c.

                                                            {
    AuResult status;
    SongStartRequest s;
 
    PreventBGMPlayerUpdate = TRUE;
    s.songName = songName;
    s.duration = 0;
    s.startVolume = AU_MAX_VOLUME_8;
    s.finalVolume = AU_MAX_VOLUME_8;
    s.variation = variation;
    s.unused_14 = 0;
    status = au_bgm_process_init_song(&s);
    PreventBGMPlayerUpdate = FALSE;
 
    return status;
}

Referenced by bgm_update_music_control(), and snd_legacy_sound_dispatch().

snd_song_stop()

AuResult snd_song_stop

(

s32

songName

)

Definition at line 496 of file snd_interface.c.

                                     {
    return au_bgm_stop_song(songName);
}

Referenced by _bgm_set_song(), bgm_fade_in_song(), and bgm_update_music_control().

snd_song_stop_all()

void snd_song_stop_all

(

void

)

Definition at line 500 of file snd_interface.c.

                             {
    au_bgm_stop_all();
}

snd_song_is_playing()

AuResult snd_song_is_playing

(

s32

songName

)

Definition at line 504 of file snd_interface.c.

                                           {
    return au_bgm_is_song_playing(songName);
}

Referenced by bgm_is_any_song_playing(), and bgm_update_music_control().

snd_song_request_fade_in()

AuResult snd_song_request_fade_in	(	s32	songName,
		s32	variation,
		s32	fadeInTime,
		s32	startVolume,
		s32	endVolume )

Called from bgm_control to fade in a particular song + variation.

Definition at line 509 of file snd_interface.c.

                                                                                                               {
    AuResult status;
    SongStartRequest s;
 
    PreventBGMPlayerUpdate = TRUE;
    s.songName = songName;
    s.duration = fadeInTime;
    s.startVolume = startVolume;
    s.finalVolume = endVolume;
    s.variation = variation;
    s.unused_14 = 0;
    status = au_bgm_process_init_song(&s);
    PreventBGMPlayerUpdate = FALSE;
 
    return status;
}

Referenced by bgm_update_music_control().

snd_song_request_fade_in_default()

AuResult snd_song_request_fade_in_default	(	s32	songName,
		s32	fadeInTime,
		s32	startVolume,
		s32	endVolume )

Unused.

Definition at line 527 of file snd_interface.c.

                                                                                                        {
    AuResult status;
    SongStartRequest s;
 
    PreventBGMPlayerUpdate = TRUE;
    s.songName = songName;
    s.duration = fadeInTime;
    s.startVolume = startVolume;
    s.finalVolume = endVolume;
    s.variation = 0;
    s.unused_14 = 0;
    status = au_bgm_process_init_song(&s);
    PreventBGMPlayerUpdate = FALSE;
 
    return status;
}

snd_song_request_fade_out()

AuResult snd_song_request_fade_out	(	s32	songName,
		s32	fadeTime,
		AuCallback	callback )

Definition at line 544 of file snd_interface.c.

                                                                                    {
    SongFadeOutRequest s;
 
    s.songName = songName;
    s.duration = fadeTime;
    s.unused_08 = 0;
    s.finalVolume = 0;
    s.doneCallback = callback;
    s.onPush = FALSE;
 
    return au_bgm_process_fade_out(&s);
}

Referenced by bgm_update_music_control().

snd_song_push_stop()

AuResult snd_song_push_stop

(

s32

songName

)

Definition at line 557 of file snd_interface.c.

                                          {
    SongSuspendRequest s;
 
    s.songName = songName;
    s.duration = 0;
    s.startVolume = 0;
    s.finalVolume = 0;
    s.index = BGM_SNAPSHOT_0;
    s.pauseMode = FALSE;
 
    return au_bgm_process_suspend(&s, FALSE); // force stop
}

Referenced by bgm_update_music_control().

snd_song_request_pop()

AuResult snd_song_request_pop

(

s32

songName

)

Definition at line 570 of file snd_interface.c.

                                            {
    AuResult status;
    SongResumeRequest s;
 
    PreventBGMPlayerUpdate = TRUE;
    s.songName = songName;
    s.duration = 2000;
    s.startVolume = 1;
    s.finalVolume = AU_MAX_VOLUME_8;
    s.index = BGM_SNAPSHOT_0;
    s.pauseMode = FALSE;
    status = au_bgm_process_resume(&s);
    PreventBGMPlayerUpdate = FALSE;
 
    return status;
}

Referenced by bgm_update_music_control().

snd_song_request_snapshot()

AuResult snd_song_request_snapshot

(

s32

songName

)

Definition at line 587 of file snd_interface.c.

                                                 {
    SongSuspendRequest s;
 
    s.songName = songName;
    s.duration = 0;
    s.startVolume = 0;
    s.finalVolume = 0;
    s.index = BGM_SNAPSHOT_0;
    s.pauseMode = FALSE;
 
    return au_bgm_process_suspend(&s, TRUE); // no stop
}

Referenced by _bgm_set_song().

snd_song_request_push_fade_out()

AuResult snd_song_request_push_fade_out	(	s32	songName,
		s32	fadeTime )

Definition at line 600 of file snd_interface.c.

                                                                    {
    SongFadeOutRequest s;
 
    s.songName = songName;
    s.duration = fadeTime;
    s.unused_08 = 0;
    s.finalVolume = 0;
    s.doneCallback = NULL;
    s.onPush = TRUE;
 
    return au_bgm_process_fade_out(&s);
}

Referenced by bgm_update_music_control().

snd_song_request_pause()

AuResult snd_song_request_pause

(

s32

songName

)

Definition at line 613 of file snd_interface.c.

                                              {
    SongSuspendRequest s;
 
    s.songName = songName;
    s.duration = 0;
    s.startVolume = 0;
    s.finalVolume = 0;
    s.index = BGM_SNAPSHOT_0;
    s.pauseMode = TRUE;
 
    return au_bgm_process_suspend(&s, FALSE); // force stop
}

snd_song_request_unpause()

AuResult snd_song_request_unpause

(

s32

songName

)

Definition at line 626 of file snd_interface.c.

                                                {
    SongResumeRequest s;
 
    s.songName = songName;
    s.duration = 0;
    s.startVolume = 0;
    s.finalVolume = 0;
    s.index = BGM_SNAPSHOT_0;
    s.pauseMode = TRUE;
 
    return au_bgm_process_resume(&s);
}

snd_song_set_volume_quiet()

AuResult snd_song_set_volume_quiet

(

s32

songName

)

Definition at line 639 of file snd_interface.c.

                                                 {
    SongStartRequest s;
 
    s.songName = songName;
    s.duration = 500;
    s.finalVolume = 0.25001 * AU_MAX_VOLUME_16;
 
    return au_bgm_adjust_volume(&s);
}

snd_song_set_volume_full()

AuResult snd_song_set_volume_full

(

s32

songName

)

Definition at line 649 of file snd_interface.c.

                                                {
    SongStartRequest s;
 
    s.songName = songName;
    s.duration = 500;
    s.finalVolume = AU_MAX_VOLUME_16;
 
    return au_bgm_adjust_volume(&s);
}

snd_song_set_linked_mode()

AuResult snd_song_set_linked_mode	(	s32	songName,
		b32	mode )

Definition at line 659 of file snd_interface.c.

                                                          {
    SongSwapLinkedRequest s;
 
    s.songName = songName;
    s.enabled = mode;
 
    return au_bgm_set_linked_tracks(&s);
}

Referenced by bgm_set_linked_mode().

snd_song_get_playing_info()

AuResult snd_song_get_playing_info	(	s32	songName,
		BGMHeader **	outFile,
		BGMPlayer **	outPlayer )

Definition at line 669 of file snd_interface.c.

                                                                                             {
    AuResult status = AU_RESULT_OK;
    BGMHeader* bgmFile;
 
    bgmFile = gSoundGlobals->dataBGM[0];
    if (songName == bgmFile->name) {
        *outPlayer = gBGMPlayerA;
        *outFile = bgmFile;
    } else {
        bgmFile = gSoundGlobals->dataBGM[1];
        if (songName == bgmFile->name) {
            *outPlayer = gBGMPlayerB;
            *outFile = bgmFile;
        } else {
            status = AU_ERROR_1;
        }
    }
    return status;
}

Referenced by snd_song_clear_track_volumes(), snd_song_set_detune(), snd_song_set_playback_rate(), and snd_song_set_track_volumes().

snd_song_set_playback_rate()

AuResult snd_song_set_playback_rate	(	s32	songName,
		f32	rate )

Definition at line 689 of file snd_interface.c.

                                                            {
    BGMPlayer* bgmPlayer;
    BGMHeader* bgmFile;
    AuResult status;
 
    status = snd_song_get_playing_info(songName, &bgmFile, &bgmPlayer);
 
    if (status == AU_RESULT_OK) {
        au_bgm_set_playback_rate(bgmPlayer, rate);
    }
 
    return status;
}

snd_song_set_detune()

AuResult snd_song_set_detune	(	s32	songName,
		s32	detune )

Definition at line 703 of file snd_interface.c.

                                                       {
    BGMPlayer* bgmPlayer;
    BGMHeader* bgmFile;
    AuResult status;
 
    status = snd_song_get_playing_info(songName, &bgmFile, &bgmPlayer);
 
    if (status == AU_RESULT_OK) {
        au_bgm_player_set_detune(bgmPlayer, detune);
    }
 
    return status;
}

snd_song_set_track_volumes()

AuResult snd_song_set_track_volumes	(	s32	songName,
		MusicTrackVols	trackVolSet )

Definition at line 717 of file snd_interface.c.

                                                                              {
    BGMPlayer* bgmPlayer;
    BGMHeader* bgmFile;
    AuResult status;
 
    status = snd_song_get_playing_info(songName, &bgmFile, &bgmPlayer);
 
    if (status == AU_RESULT_OK) {
        u8* trackVols = snd_song_get_track_volumes_set(trackVolSet);
 
        if (trackVols != NULL) {
            au_bgm_set_track_volumes(bgmPlayer, trackVols, TRUE);
        } else {
            status = AU_ERROR_11;
        }
    }
 
    return status;
}

Referenced by bgm_set_track_volumes().

snd_song_clear_track_volumes()

AuResult snd_song_clear_track_volumes	(	s32	songName,
		MusicTrackVols	trackVolSet )

Definition at line 737 of file snd_interface.c.

                                                                                {
    BGMPlayer* bgmPlayer;
    BGMHeader* bgmFile;
    AuResult status;
 
    status = snd_song_get_playing_info(songName, &bgmFile, &bgmPlayer);
 
    if (status == AU_RESULT_OK) {
        u8* trackVols = snd_song_get_track_volumes_set(trackVolSet);
 
        if (trackVols != NULL) {
            au_bgm_set_track_volumes(bgmPlayer, trackVols, FALSE);
        } else {
            status = AU_ERROR_11;
        }
    }
 
    return status;
}

Referenced by bgm_clear_track_volumes().

snd_song_set_track_vol_mute()

AuResult snd_song_set_track_vol_mute	(	s32	songName,
		s32	trackIdx )

Definition at line 808 of file snd_interface.c.

                                                                 {
    return snd_song_change_track_volume(songName, trackIdx, 0);
}

snd_song_set_track_vol_quiet()

AuResult snd_song_set_track_vol_quiet	(	s32	songName,
		s32	trackIdx )

Definition at line 812 of file snd_interface.c.

                                                                  {
    return snd_song_change_track_volume(songName, trackIdx, AU_MAX_VOLUME_8 / 2);
}

snd_song_set_track_vol_full()

AuResult snd_song_set_track_vol_full	(	s32	songName,
		s32	trackIdx )

Definition at line 816 of file snd_interface.c.

                                                                 {
    return snd_song_change_track_volume(songName, trackIdx, AU_MAX_VOLUME_8);
}

snd_song_set_proximity_mix_far()

void snd_song_set_proximity_mix_far	(	s32	songName,
		s32	mix )

Definition at line 820 of file snd_interface.c.

                                                           {
    au_bgm_set_proximity_mix(songName, (u8)mix);
}

Referenced by bgm_adjust_proximity().

snd_song_set_proximity_mix_near()

void snd_song_set_proximity_mix_near	(	s32	songName,
		s32	mix )

Definition at line 824 of file snd_interface.c.

                                                            {
    au_bgm_set_proximity_mix(songName, (u8)mix | ((s32)(0.69f * AU_MAX_VOLUME_8) << 24));
}

Referenced by bgm_adjust_proximity().

snd_song_set_proximity_mix_full()

void snd_song_set_proximity_mix_full	(	s32	songName,
		s32	mix )

Definition at line 828 of file snd_interface.c.

                                                            {
    au_bgm_set_proximity_mix(songName, (u8)mix | (AU_MAX_VOLUME_8 << 24));
}

Referenced by bgm_adjust_proximity().

snd_song_poll_music_events()

void snd_song_poll_music_events	(	MusicEventTrigger **	musicEvents,
		s32 *	count )

Definition at line 832 of file snd_interface.c.

                                                                             {
    AuGlobals* globals = gSoundGlobals;
 
    *musicEvents = globals->musicEventQueue;
    *count = globals->musicEventQueueCount;
}

snd_song_flush_music_events()

void snd_song_flush_music_events

(

void

)

Definition at line 839 of file snd_interface.c.

                                       {
    gSoundGlobals->flushMusicEventQueue = TRUE;
}

snd_song_trigger_music_event()

void snd_song_trigger_music_event	(	s32	playerID,
		s32	trackIndex,
		s32	eventInfo )

Definition at line 843 of file snd_interface.c.

                                                                               {
    AuGlobals* globals = gSoundGlobals;
 
    if (globals->musicEventQueueCount < MUS_QUEUE_SIZE) {
        *globals->musicEventQueuePos++ = ((playerID << 28) + ((trackIndex & 0xF) << 24) + eventInfo);
        globals->musicEventQueueCount++;
    }
}

Referenced by au_BGMCmd_FD_EventTrigger().

snd_song_clear_music_events()

void snd_song_clear_music_events

(

void

)

Definition at line 852 of file snd_interface.c.

                                       {
    AuGlobals* globals = gSoundGlobals;
    s32* buf = globals->musicEventQueue;
    s32 i = 15;
 
    do {
        *buf++ = 0;
    } while (i-- != 0);
 
    globals->musicEventQueueCount = 0;
    globals->flushMusicEventQueue = FALSE;
    globals->musicEventQueuePos = globals->musicEventQueue;
}

Referenced by au_engine_init(), and au_update_clients_for_video_frame().

snd_register_callback()

void snd_register_callback	(	AuCallback	func,
		s32	index )

Definition at line 868 of file snd_interface.c.

                                                       {
    gSoundGlobals->audioThreadCallbacks[index] = func;
}

snd_set_stereo()

void snd_set_stereo

(

void

)

Definition at line 872 of file snd_interface.c.

                          {
    au_set_stereo_enabled(TRUE);
    au_sync_channel_delay_enabled(0);
}

Referenced by filemenu_main_handle_input(), and state_step_startup().

snd_set_mono()

void snd_set_mono

(

void

)

Definition at line 877 of file snd_interface.c.

                        {
    au_set_stereo_enabled(FALSE);
    au_sync_channel_delay_enabled(1);
}

Referenced by filemenu_main_handle_input(), and state_step_startup().

snd_set_bgm_volume()

void snd_set_bgm_volume

(

VolumeLevels

volume

)

Definition at line 882 of file snd_interface.c.

                                             {
    au_set_bus_volume_level(AUDIO_TYPE_BGM, volume);
}

Referenced by bgm_reset_sequence_players(), and bgm_update_volume().

snd_set_sfx_volume()

void snd_set_sfx_volume

(

VolumeLevels

volume

)

Definition at line 886 of file snd_interface.c.

                                             {
    au_set_bus_volume_level(AUDIO_TYPE_SFX, volume);
}

snd_set_sfx_reverb_type()

void snd_set_sfx_reverb_type

(

s32

reverbType

)

Definition at line 890 of file snd_interface.c.

                                             {
    au_set_reverb_type(AUDIO_TYPE_SFX, reverbType);
}

Referenced by sfx_set_reverb_mode().

snd_enable_sfx()

void snd_enable_sfx

(

void

)

Definition at line 894 of file snd_interface.c.

                          {
    au_sfx_set_state(gSoundManager, SND_MANAGER_STATE_ENABLED);
}

Referenced by state_step_demo().

snd_disable_sfx()

void snd_disable_sfx

(

void

)

Definition at line 898 of file snd_interface.c.

                           {
    au_sfx_set_state(gSoundManager, SND_MANAGER_STATE_DISABLED);
}

Referenced by state_init_demo().

Variable Documentation

PreventBGMPlayerUpdate

s32 PreventBGMPlayerUpdate = FALSE

While TRUE, the audio thread skips BGM player updates.

Used by the game thread to lock out BGM updates while modifying player state, to prevent race conditions.

Definition at line 10 of file snd_interface.c.

Referenced by au_update_clients_for_audio_frame(), snd_notify_engine_ready(), snd_song_request_fade_in(), snd_song_request_fade_in_default(), snd_song_request_play(), snd_song_request_play_default(), and snd_song_request_pop().

SoundEngineReady

u16 SoundEngineReady = 0

Definition at line 12 of file snd_interface.c.

Referenced by snd_legacy_sound_dispatch(), and snd_notify_engine_ready().

AmbienceRadioChannel

u16 AmbienceRadioChannel = 0

Definition at line 13 of file snd_interface.c.

Referenced by snd_ambient_radio_select(), snd_ambient_radio_setup(), and snd_ambient_radio_stop().

TrackVols_JAN_Full

u8 TrackVols_JAN_Full[]

Initial value:

= {
    2, 94,
    3, 80,
    4, 100,
    5, 84,
    0
}

Definition at line 19 of file snd_interface.c.

                          {
    2, 94,
    3, 80,
    4, 100,
    5, 84,
    0
};

TrackVols_Unused1

u8 TrackVols_Unused1[]

Initial value:

= {
    2, 100,
    3, 110,
    4, 90,
    0
}

Definition at line 26 of file snd_interface.c.

                         {
    2, 100,
    3, 110,
    4, 90,
    0
};

TrackVols_TIK_Shiver

u8 TrackVols_TIK_Shiver[]

Initial value:

= {
    2, 95,
    0
}

Definition at line 32 of file snd_interface.c.

                            {
    2, 95,
    0
};

TrackVols_Unused3

u8 TrackVols_Unused3[]

Initial value:

= {
    5, 70,
    6, 90,
    7, 90,
    8, 100,
    0
}

Definition at line 36 of file snd_interface.c.

                         {
    5, 70,
    6, 90,
    7, 90,
    8, 100,
    0
};

TrackVols_KPA_Outside

u8 TrackVols_KPA_Outside[]

Initial value:

= {
    5, 0,
    6, 0,
    7, 0,
    8, 0,
    9, 0,
    10, 0,
    11, 0,
    12, 0,
    13, 0,
    14, 0,
    15, 0,
    16, 0,
    0
}

Definition at line 44 of file snd_interface.c.

                             {
    5, 0,
    6, 0,
    7, 0,
    8, 0,
    9, 0,
    10, 0,
    11, 0,
    12, 0,
    13, 0,
    14, 0,
    15, 0,
    16, 0,
    0
};

TrackVols_KPA_1

u8 TrackVols_KPA_1[]

Initial value:

= {
    5, 100,
    6, 102,
    7, 88,
    8, 110,
    9, 0,
    10, 0,
    11, 0,
    12, 0,
    13, 0,
    14, 0,
    15, 0,
    16, 0,
    0
}

Definition at line 60 of file snd_interface.c.

                       {
    5, 100,
    6, 102,
    7, 88,
    8, 110,
    9, 0,
    10, 0,
    11, 0,
    12, 0,
    13, 0,
    14, 0,
    15, 0,
    16, 0,
    0
};

TrackVols_KPA_2

u8 TrackVols_KPA_2[]

Initial value:

= {
    5, 100,
    6, 102,
    7, 88,
    8, 110,
    9, 126,
    10, 88,
    11, 100,
    12, 0,
    13, 0,
    14, 0,
    15, 0,
    16, 0,
    0
}

Definition at line 76 of file snd_interface.c.

                       {
    5, 100,
    6, 102,
    7, 88,
    8, 110,
    9, 126,
    10, 88,
    11, 100,
    12, 0,
    13, 0,
    14, 0,
    15, 0,
    16, 0,
    0
};

TrackVols_KPA_3

u8 TrackVols_KPA_3[]

Initial value:

= {
    5, 100,
    6, 102,
    7, 88,
    8, 110,
    9, 126,
    10, 88,
    11, 100,
    12, 100,
    13, 106,
    14, 100,
    15, 100,
    16, 110,
    0
}

Definition at line 92 of file snd_interface.c.

                       {
    5, 100,
    6, 102,
    7, 88,
    8, 110,
    9, 126,
    10, 88,
    11, 100,
    12, 100,
    13, 106,
    14, 100,
    15, 100,
    16, 110,
    0
};