s_sample.cpp

Go to the documentation of this file.

 
/*
All original material Copyright (C) 2002-2025 UFO: Alien Invasion.
 
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
 
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 
See the GNU General Public License for more details.
 
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
*/
 
#include "s_sample.h"
#include "s_main.h"     /* for MAX_SOUNDIDS */
#include "../../common/filesys.h"   /* for MAX_QPATH */
#include "../../common/common.h"    /* for many */
 
#define SAMPLE_HASH_SIZE 64
static s_sample_t* sampleHash[SAMPLE_HASH_SIZE];
 
/* an index into the sampleHash to retrieve samples by an ID/number */
#define SAMPLE_MAX_COUNT 1000
static s_sample_t* sampleIndex[SAMPLE_MAX_COUNT];
static int sampleIndexLast = 0;

s_sample_t* stdSoundPool[MAX_SOUNDIDS];

static s_sample_t* S_FindByName (const char* name)
{
    const unsigned hash = Com_HashKey(name, SAMPLE_HASH_SIZE);
 
    for (s_sample_t* sample = sampleHash[hash]; sample; sample = sample->hashNext)
        if (Q_streq(name, sample->name))
            return sample;
 
    return nullptr;
}
 
static Mix_Chunk* S_LoadSampleChunk (const char* sound)
{
    byte* buf;
    const char* soundExtensions[] = SAMPLE_TYPES;
    const char** extension = soundExtensions;
 
    if (!sound || sound[0] == '*')
        return nullptr;
 
    size_t len = strlen(sound);
    if (len + 4 >= MAX_QPATH) {
        Com_Printf("S_LoadSound: MAX_QPATH exceeded for: '%s'\n", sound);
        return nullptr;
    }
 
    while (*extension) {
        if ((len = FS_LoadFile(va("sound/%s.%s", sound, *extension++), &buf)) == -1)
            continue;
 
        SDL_RWops* rw = SDL_RWFromMem(buf, len);
        if (!rw){
            FS_FreeFile(buf);
            continue;
        }
 
        Mix_Chunk* chunk = Mix_LoadWAV_RW(rw, false);
        if (!chunk)
            Com_Printf("S_LoadSound: %s.\n", Mix_GetError());
 
        FS_FreeFile(buf);
 
        SDL_FreeRW(rw);
 
        if (chunk)
            return chunk;
    }
 
    Com_Printf("S_LoadSound: Could not find sound file: '%s'\n", sound);
    return nullptr;
}

int S_LoadSampleIdx (const char* soundFile)
{
    if (!s_env.initialized)
        return 0;
 
    char name[MAX_QPATH];
    Com_StripExtension(soundFile, name, sizeof(name));
 
    if (s_sample_t* const sample = S_FindByName(name))
        return sample->index;
 
    /* make sure the sound is loaded */
    Mix_Chunk* chunk = S_LoadSampleChunk(name);
    if (!chunk)
        return 0;       /* couldn't load the sound's data */
 
    const unsigned hash = Com_HashKey(name, SAMPLE_HASH_SIZE);
    s_sample_t* const sample = Mem_PoolAllocType(s_sample_t, cl_soundSysPool);
    sample->name = Mem_PoolStrDup(name, cl_soundSysPool, 0);
    sample->chunk = chunk;
    sample->hashNext = sampleHash[hash];
    sampleHash[hash] = sample;
    sampleIndex[++sampleIndexLast] = sample;
    sample->index = sampleIndexLast;
    return sample->index;
}
 
s_sample_t* S_GetSample (const int soundIdx)
{
    if (soundIdx > 0 && soundIdx <= sampleIndexLast)
        return sampleIndex[soundIdx];
    return nullptr;
}
 
void S_FreeSamples (void)
{
    for (int i = 0; i < SAMPLE_HASH_SIZE; i++)
        for (s_sample_t* sample = sampleHash[i]; sample; sample = sample->hashNext) {
            Mix_FreeChunk(sample->chunk);
            Mem_Free(sample->name);
        }
 
    for (int i = 0; i < SAMPLE_HASH_SIZE; i++) {
        s_sample_t* next;
        for (s_sample_t* sample = sampleHash[i]; sample; sample = next) {
            next = sample->hashNext;
            Mem_Free(sample);
        }
    }
 
    OBJZERO(sampleHash);
    OBJZERO(sampleIndex);
}

void S_PrecacheSamples (void)
{
    if (!s_env.initialized)
        return;
 
    /* load weapon sounds */
    for (int i = 0; i < csi.numODs; i++) { /* i = obj */
        const objDef_t* od = INVSH_GetItemByIDX(i);
        for (int j = 0; j < od->numWeapons; j++) {  /* j = weapon-entry per obj */
            for (int k = 0; k < od->numFiredefs[j]; k++) { /* k = firedef per weapon */
                const fireDef_t* fd = &od->fd[j][k];
                if (fd->fireSound != nullptr)
                    S_LoadSample(fd->fireSound);
                if (fd->impactSound != nullptr)
                    S_LoadSample(fd->impactSound);
                if (fd->hitBodySound != nullptr)
                    S_LoadSample(fd->hitBodySound);
                if (fd->bounceSound != nullptr)
                    S_LoadSample(fd->bounceSound);
            }
        }
    }
 
    /* precache the sound pool */
    stdSoundPool[SOUND_WATER_IN] = S_LoadSample("footsteps/water_in");
    stdSoundPool[SOUND_WATER_OUT] = S_LoadSample("footsteps/water_out");
    stdSoundPool[SOUND_WATER_MOVE] = S_LoadSample("footsteps/water_under");
}