#include "../client.h"

Classes
struct	samplepair_s

struct	sfxcache_s

struct	sfx_s

struct	playsound_s

struct	channel_s

struct	wavinfo_t

Macros
#define	SOUND_FULLVOLUME 80

#define	SOUND_LOOPATTENUATE 0.003

#define	MAX_CHANNELS 32

#define	S_MAX_RAW_SAMPLES 8192

#define	S_Malloc(x) Z_TagMalloc(x, TAG_SOUND)

#define	S_CopyString(x) Z_TagCopyString(x, TAG_SOUND)

Typedefs
typedef struct samplepair_s	samplepair_t

typedef struct sfxcache_s	sfxcache_t

typedef struct sfx_s	sfx_t

typedef struct playsound_s	playsound_t

typedef struct channel_s	channel_t

Functions
sfx_t *	S_SfxForHandle (qhandle_t hSfx)

sfxcache_t *	S_LoadSound (sfx_t *s)

channel_t *	S_PickChannel (int entnum, int entchannel)

void	S_IssuePlaysound (playsound_t *ps)

void	S_BuildSoundList (int *sounds)

Variables
qboolean	s_active

channel_t	channels [MAX_CHANNELS]

int	s_numchannels

int	paintedtime

playsound_t	s_pendingplays

vec3_t	listener_origin

vec3_t	listener_forward

vec3_t	listener_right

vec3_t	listener_up

int	listener_entnum

samplepair_t	s_rawsamples [S_MAX_RAW_SAMPLES]

int	s_rawend

wavinfo_t	s_info

cvar_t *	s_volume

cvar_t *	s_ambient

cvar_t *	s_show

Macro Definition Documentation

◆ MAX_CHANNELS

#define MAX_CHANNELS 32

Definition at line 141 of file sound.h.

◆ S_CopyString

#define S_CopyString ( x ) Z_TagCopyString(x, TAG_SOUND)

Definition at line 169 of file sound.h.

◆ S_Malloc

#define S_Malloc ( x ) Z_TagMalloc(x, TAG_SOUND)

Definition at line 168 of file sound.h.

◆ S_MAX_RAW_SAMPLES

#define S_MAX_RAW_SAMPLES 8192

Definition at line 154 of file sound.h.

◆ SOUND_FULLVOLUME

#define SOUND_FULLVOLUME 80

Definition at line 135 of file sound.h.

◆ SOUND_LOOPATTENUATE

#define SOUND_LOOPATTENUATE 0.003

Definition at line 137 of file sound.h.

Typedef Documentation

◆ channel_t

typedef struct channel_s channel_t

◆ playsound_t

typedef struct playsound_s playsound_t

◆ samplepair_t

typedef struct samplepair_s samplepair_t

◆ sfx_t

typedef struct sfx_s sfx_t

◆ sfxcache_t

typedef struct sfxcache_s sfxcache_t

Function Documentation

◆ S_BuildSoundList()

void S_BuildSoundList ( int * sounds )

Definition at line 969 of file main.c.

 {
     int         i;
     int         num;
     entity_state_t  *ent;
  
     for (i = 0; i < cl.frame.numEntities; i++) {
         num = (cl.frame.firstEntity + i) & PARSE_ENTITIES_MASK;
         ent = &cl.entityStates[num];
         if (s_ambient->integer == 2 && !ent->modelindex) {
             sounds[i] = 0;
         } else if (s_ambient->integer == 3 && ent->number != listener_entnum) {
             sounds[i] = 0;
         } else {
             sounds[i] = ent->sound;
         }
     }
 }

Referenced by AL_AddLoopSounds().

◆ S_IssuePlaysound()

void S_IssuePlaysound ( playsound_t * ps )

Definition at line 759 of file main.c.

 {
     channel_t   *ch;
     sfxcache_t  *sc;
  
 #ifdef _DEBUG
     if (s_show->integer)
         Com_Printf("Issue %i\n", ps->begin);
 #endif
     // pick a channel to play on
     ch = S_PickChannel(ps->entnum, ps->entchannel);
     if (!ch) {
         S_FreePlaysound(ps);
         return;
     }
  
     sc = S_LoadSound(ps->sfx);
     if (!sc) {
         Com_Printf("S_IssuePlaysound: couldn't load %s\n", ps->sfx->name);
         S_FreePlaysound(ps);
         return;
     }
  
     // spatialize
     if (ps->attenuation == ATTN_STATIC)
         ch->dist_mult = ps->attenuation * 0.001;
     else
         ch->dist_mult = ps->attenuation * 0.0005;
     ch->master_vol = ps->volume;
     ch->entnum = ps->entnum;
     ch->entchannel = ps->entchannel;
     ch->sfx = ps->sfx;
     VectorCopy(ps->origin, ch->origin);
     ch->fixed_origin = ps->fixed_origin;
  
 #if USE_OPENAL
     if (s_started == SS_OAL)
         AL_PlayChannel(ch);
 #endif
  
 #if USE_SNDDMA
     if (s_started == SS_DMA)
         S_Spatialize(ch);
 #endif
  
     ch->pos = 0;
     ch->end = paintedtime + sc->length;
  
     // free the playsound
     S_FreePlaysound(ps);
 }

Referenced by AL_IssuePlaysounds(), and S_PaintChannels().

◆ S_LoadSound()

sfxcache_t* S_LoadSound ( sfx_t * s )

Definition at line 288 of file mem.c.

 {
     byte        *data;
     sfxcache_t  *sc;
     ssize_t     len;
     char        *name;
  
     if (s->name[0] == '*')
         return NULL;
  
 // see if still in memory
     sc = s->cache;
     if (sc)
         return sc;
  
 // don't retry after error
     if (s->error)
         return NULL;
  
 // load it in
     if (s->truename)
         name = s->truename;
     else
         name = s->name;
  
     len = FS_LoadFile(name, (void **)&data);
     if (!data) {
         s->error = len;
         return NULL;
     }
  
     memset(&s_info, 0, sizeof(s_info));
     s_info.name = name;
  
     iff_data = data;
     iff_end = data + len;
     if (!GetWavinfo()) {
         s->error = Q_ERR_INVALID_FORMAT;
         goto fail;
     }
  
 #if USE_OPENAL
     if (s_started == SS_OAL)
         sc = AL_UploadSfx(s);
 #endif
  
 #if USE_SNDDMA
     if (s_started == SS_DMA)
         sc = ResampleSfx(s);
 #endif
  
 fail:
     FS_FreeFile(data);
     return sc;
 }

Referenced by S_EndRegistration(), S_IssuePlaysound(), S_PaintChannels(), S_RegisterSexedSound(), S_RegisterSound(), and S_StartSound().

◆ S_PickChannel()

channel_t* S_PickChannel	(	int	entnum,
		int	entchannel
	)

Definition at line 579 of file main.c.

 {
     int         ch_idx;
     int         first_to_die;
     int         life_left;
     channel_t   *ch;
  
     if (entchannel < 0)
         Com_Error(ERR_DROP, "S_PickChannel: entchannel < 0");
  
 // Check for replacement sound, or find the best one to replace
     first_to_die = -1;
     life_left = 0x7fffffff;
     for (ch_idx = 0; ch_idx < s_numchannels; ch_idx++) {
         ch = &channels[ch_idx];
         // channel 0 never overrides unless out of channels
         if (ch->entnum == entnum && ch->entchannel == entchannel && entchannel != 0) {
             if (entchannel == 256 && ch->sfx) {
                 return NULL; // channel 256 never overrides
             }
             // always override sound from same entity
             first_to_die = ch_idx;
             break;
         }
  
         // don't let monster sounds override player sounds
         if (ch->entnum == listener_entnum && entnum != listener_entnum && ch->sfx)
             continue;
  
         if (ch->end - paintedtime < life_left) {
             life_left = ch->end - paintedtime;
             first_to_die = ch_idx;
         }
     }
  
     if (first_to_die == -1)
         return NULL;
  
     ch = &channels[first_to_die];
 #if USE_OPENAL
     if (s_started == SS_OAL && ch->sfx)
         AL_StopChannel(ch);
 #endif
     memset(ch, 0, sizeof(*ch));
  
     return ch;
 }

Referenced by AL_AddLoopSounds(), and S_IssuePlaysound().

◆ S_SfxForHandle()

sfx_t* S_SfxForHandle ( qhandle_t hSfx )

Definition at line 312 of file main.c.

 {
     if (!hSfx) {
         return NULL;
     }
  
     if (hSfx < 1 || hSfx > num_sfx) {
         Com_Error(ERR_DROP, "S_SfxForHandle: %d out of range", hSfx);
     }
  
     return &known_sfx[hSfx - 1];
 }