fixed bug with engine sounds (for TE_ effects) and local sounds (menu, etc) being...
[divverent/darkplaces.git] / snd_main.c
1 /*
2 Copyright (C) 1996-1997 Id Software, Inc.
3
4 This program is free software; you can redistribute it and/or
5 modify it under the terms of the GNU General Public License
6 as published by the Free Software Foundation; either version 2
7 of the License, or (at your option) any later version.
8
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
12
13 See the GNU General Public License for more details.
14
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
18
19 */
20 // snd_main.c -- main control for any streaming sound output device
21
22 #include "quakedef.h"
23
24 #include "snd_main.h"
25 #include "snd_ogg.h"
26
27
28 void S_Play(void);
29 void S_PlayVol(void);
30 void S_Play2(void);
31 void S_SoundList(void);
32 void S_Update_();
33
34 void S_ClearBuffer (void);
35
36
37 // =======================================================================
38 // Internal sound data & structures
39 // =======================================================================
40
41 channel_t channels[MAX_CHANNELS];
42 unsigned int total_channels;
43
44 int snd_blocked = 0;
45 cvar_t snd_initialized = { CVAR_READONLY, "snd_initialized", "0"};
46 cvar_t snd_streaming = { CVAR_SAVE, "snd_streaming", "1"};
47
48 volatile dma_t *shm = 0;
49 volatile dma_t sn;
50
51 vec3_t listener_origin;
52 matrix4x4_t listener_matrix;
53 vec_t sound_nominal_clip_dist=1000.0;
54 mempool_t *snd_mempool;
55
56 // sample PAIRS
57 int soundtime;
58 int paintedtime;
59
60
61 // Linked list of known sfx
62 sfx_t *known_sfx = NULL;
63
64 qboolean sound_started = false;
65 qboolean sound_spatialized = false;
66
67 // Fake dma is a synchronous faking of the DMA progress used for
68 // isolating performance in the renderer.
69 qboolean fakedma = false;
70
71 cvar_t bgmvolume = {CVAR_SAVE, "bgmvolume", "1"};
72 cvar_t volume = {CVAR_SAVE, "volume", "0.7"};
73 cvar_t snd_staticvolume = {CVAR_SAVE, "snd_staticvolume", "1"};
74
75 cvar_t nosound = {0, "nosound", "0"};
76 cvar_t snd_precache = {0, "snd_precache", "1"};
77 cvar_t bgmbuffer = {0, "bgmbuffer", "4096"};
78 cvar_t ambient_level = {0, "ambient_level", "0.3"};
79 cvar_t ambient_fade = {0, "ambient_fade", "100"};
80 cvar_t snd_noextraupdate = {0, "snd_noextraupdate", "0"};
81 cvar_t snd_show = {0, "snd_show", "0"};
82 cvar_t _snd_mixahead = {CVAR_SAVE, "_snd_mixahead", "0.1"};
83 cvar_t snd_swapstereo = {CVAR_SAVE, "snd_swapstereo", "0"};
84
85
86 // ====================================================================
87 // User-setable variables
88 // ====================================================================
89
90 void S_SoundInfo_f(void)
91 {
92         if (!sound_started || !shm)
93         {
94                 Con_Print("sound system not started\n");
95                 return;
96         }
97
98         Con_Printf("%5d stereo\n", shm->format.channels - 1);
99         Con_Printf("%5d samples\n", shm->samples);
100         Con_Printf("%5d samplepos\n", shm->samplepos);
101         Con_Printf("%5d samplebits\n", shm->format.width * 8);
102         Con_Printf("%5d speed\n", shm->format.speed);
103         Con_Printf("%p dma buffer\n", shm->buffer);
104         Con_Printf("%5u total_channels\n", total_channels);
105 }
106
107
108 void S_Startup(void)
109 {
110         if (!snd_initialized.integer)
111                 return;
112
113         shm = &sn;
114         memset((void *)shm, 0, sizeof(*shm));
115
116         // create a piece of DMA memory
117         if (fakedma)
118         {
119                 shm->format.width = 2;
120                 shm->format.speed = 22050;
121                 shm->format.channels = 2;
122                 shm->samples = 32768;
123                 shm->samplepos = 0;
124                 shm->buffer = Mem_Alloc(snd_mempool, shm->format.channels * shm->samples * shm->format.width);
125         }
126         else
127         {
128                 if (!SNDDMA_Init())
129                 {
130                         Con_Print("S_Startup: SNDDMA_Init failed.\n");
131                         shm = NULL;
132                         sound_started = false;
133                         sound_spatialized = false;
134                         return;
135                 }
136         }
137
138         sound_started = true;
139
140         Con_DPrintf("Sound sampling rate: %i\n", shm->format.speed);
141
142         S_StopAllSounds ();
143 }
144
145 void S_Shutdown(void)
146 {
147         if (!sound_started)
148                 return;
149
150         if (fakedma)
151                 Mem_Free(shm->buffer);
152         else
153                 SNDDMA_Shutdown();
154
155         shm = NULL;
156         sound_started = false;
157         sound_spatialized = false;
158 }
159
160 void S_Restart_f(void)
161 {
162         S_Shutdown();
163         S_Startup();
164 }
165
166 /*
167 ================
168 S_Init
169 ================
170 */
171 void S_Init(void)
172 {
173         Con_DPrint("\nSound Initialization\n");
174
175         Cvar_RegisterVariable(&volume);
176         Cvar_RegisterVariable(&bgmvolume);
177         Cvar_RegisterVariable(&snd_staticvolume);
178
179 // COMMANDLINEOPTION: Sound: -nosound disables sound (including CD audio)
180         if (COM_CheckParm("-nosound") || COM_CheckParm("-safe"))
181                 return;
182
183         snd_mempool = Mem_AllocPool("sound", 0, NULL);
184
185 // COMMANDLINEOPTION: Sound: -simsound runs sound mixing but with no output
186         if (COM_CheckParm("-simsound"))
187                 fakedma = true;
188
189         Cmd_AddCommand("play", S_Play);
190         Cmd_AddCommand("play2", S_Play2);
191         Cmd_AddCommand("playvol", S_PlayVol);
192         Cmd_AddCommand("stopsound", S_StopAllSounds);
193         Cmd_AddCommand("soundlist", S_SoundList);
194         Cmd_AddCommand("soundinfo", S_SoundInfo_f);
195         Cmd_AddCommand("snd_restart", S_Restart_f);
196
197         Cvar_RegisterVariable(&nosound);
198         Cvar_RegisterVariable(&snd_precache);
199         Cvar_RegisterVariable(&snd_initialized);
200         Cvar_RegisterVariable(&snd_streaming);
201         Cvar_RegisterVariable(&bgmbuffer);
202         Cvar_RegisterVariable(&ambient_level);
203         Cvar_RegisterVariable(&ambient_fade);
204         Cvar_RegisterVariable(&snd_noextraupdate);
205         Cvar_RegisterVariable(&snd_show);
206         Cvar_RegisterVariable(&_snd_mixahead);
207         Cvar_RegisterVariable(&snd_swapstereo); // for people with backwards sound wiring
208
209         Cvar_SetValueQuick(&snd_initialized, true);
210
211         known_sfx = NULL;
212
213         total_channels = MAX_DYNAMIC_CHANNELS + NUM_AMBIENTS;   // no statics
214         memset(channels, 0, MAX_CHANNELS * sizeof(channel_t));
215
216         OGG_OpenLibrary ();
217 }
218
219
220 // =======================================================================
221 // Load a sound
222 // =======================================================================
223
224 /*
225 ==================
226 S_FindName
227
228 ==================
229 */
230 sfx_t *S_FindName (const char *name)
231 {
232         sfx_t *sfx;
233
234         if (!snd_initialized.integer)
235                 return NULL;
236
237         // Add the default sound directory to the path
238         if (strlen (name) >= sizeof (sfx->name))
239                 Host_Error ("S_FindName: sound name too long (%s)", name);
240
241         // Look for this sound in the list of known sfx
242         for (sfx = known_sfx; sfx != NULL; sfx = sfx->next)
243                 if(!strcmp (sfx->name, name))
244                         return sfx;
245
246         // Add a sfx_t struct for this sound
247         sfx = Mem_Alloc (snd_mempool, sizeof (*sfx));
248         memset (sfx, 0, sizeof(*sfx));
249         strlcpy (sfx->name, name, sizeof (sfx->name));
250         sfx->next = known_sfx;
251         known_sfx = sfx;
252
253         return sfx;
254 }
255
256
257 /*
258 ==================
259 S_FreeSfx
260
261 ==================
262 */
263 void S_FreeSfx (sfx_t *sfx)
264 {
265         // Never free a locked sfx
266         if (sfx->locks > 0)
267                 return;
268
269         Con_DPrintf ("S_FreeSfx: freeing %s\n", sfx->name);
270
271         // Remove it from the list of known sfx
272         if (sfx == known_sfx)
273                 known_sfx = known_sfx->next;
274         else
275         {
276                 sfx_t *prev_sfx;
277
278                 for (prev_sfx = known_sfx; prev_sfx != NULL; prev_sfx = prev_sfx->next)
279                         if (prev_sfx->next == sfx)
280                         {
281                                 prev_sfx->next = sfx->next;
282                                 break;
283                         }
284                 if (prev_sfx == NULL)
285                         Sys_Error ("S_FreeSfx: Can't find SFX %s in the list!\n", sfx->name);
286         }
287
288         // Free it
289         Mem_FreePool (&sfx->mempool);
290         Mem_Free (sfx);
291 }
292
293
294 /*
295 ==================
296 S_ServerSounds
297
298 ==================
299 */
300 void S_ServerSounds (char serversound [][MAX_QPATH], unsigned int numsounds)
301 {
302         sfx_t *sfx;
303         unsigned int i;
304
305         // Start the ambient sounds and make them loop
306         channels[AMBIENT_WATER].sfx = S_PrecacheSound ("sound/ambience/water1.wav", false, true);
307         channels[AMBIENT_SKY].sfx = S_PrecacheSound ("sound/ambience/wind2.wav", false, true);
308         for (i = 0; i < NUM_AMBIENTS; i++)
309                 channels[i].flags |= CHANNELFLAG_FORCELOOP;
310
311         // Remove 1 lock from all sfx with the SFXFLAG_SERVERSOUND flag, and remove the flag
312         for (sfx = known_sfx; sfx != NULL; sfx = sfx->next)
313                 if (sfx->flags & SFXFLAG_SERVERSOUND)
314                 {
315                         sfx->locks--;
316                         sfx->flags &= ~SFXFLAG_SERVERSOUND;
317                 }
318
319         // Add 1 lock and the SFXFLAG_SERVERSOUND flag to each sfx in "serversound"
320         for (i = 1; i < numsounds; i++)
321         {
322                 sfx = S_FindName (serversound[i]);
323                 if (sfx != NULL && !(sfx->flags & SFXFLAG_SERVERSOUND))
324                 {
325                         sfx->locks++;
326                         sfx->flags |= SFXFLAG_SERVERSOUND;
327                 }
328         }
329
330         // Free all unlocked sfx
331         sfx = known_sfx;
332         while (sfx != NULL)
333         {
334                 sfx_t* crtsfx;
335
336                 // We may lose the "next" pointer after S_FreeSfx
337                 crtsfx = sfx;
338                 sfx = sfx->next;
339
340                 S_FreeSfx (crtsfx);
341         }
342 }
343
344
345 /*
346 ==================
347 S_PrecacheSound
348
349 ==================
350 */
351 sfx_t *S_PrecacheSound (const char *name, qboolean complain, qboolean lock)
352 {
353         sfx_t *sfx;
354
355         if (!snd_initialized.integer)
356                 return NULL;
357
358         sfx = S_FindName (name);
359         if (sfx == NULL)
360                 return NULL;
361
362         if (lock && !(sfx->flags & SFXFLAG_PERMANENT))
363         {
364                 sfx->flags |= SFXFLAG_PERMANENT;
365                 sfx->locks++;
366         }
367
368         if (!nosound.integer && snd_precache.integer)
369                 S_LoadSound(sfx, complain);
370
371         return sfx;
372 }
373
374 /*
375 ==================
376 S_UnlockSfx
377
378 Remove a lock from a SFX and freed it if possible
379 ==================
380 */
381 void S_UnlockSfx (sfx_t *sfx)
382 {
383         sfx->locks--;
384         S_FreeSfx (sfx);
385 }
386
387
388 //=============================================================================
389
390 /*
391 =================
392 SND_PickChannel
393
394 Picks a channel based on priorities, empty slots, number of channels
395 =================
396 */
397 channel_t *SND_PickChannel(int entnum, int entchannel)
398 {
399         int ch_idx;
400         int first_to_die;
401         int life_left;
402         channel_t* ch;
403
404 // Check for replacement sound, or find the best one to replace
405         first_to_die = -1;
406         life_left = 0x7fffffff;
407         for (ch_idx=NUM_AMBIENTS ; ch_idx < NUM_AMBIENTS + MAX_DYNAMIC_CHANNELS ; ch_idx++)
408         {
409                 ch = &channels[ch_idx];
410                 if (entchannel != 0             // channel 0 never overrides
411                 && ch->entnum == entnum
412                 && (ch->entchannel == entchannel || entchannel == -1) )
413                 {       // always override sound from same entity
414                         first_to_die = ch_idx;
415                         break;
416                 }
417
418                 // don't let monster sounds override player sounds
419                 if (ch->entnum == cl.viewentity && entnum != cl.viewentity && ch->sfx)
420                         continue;
421
422                 // don't override looped sounds
423                 if ((ch->flags & CHANNELFLAG_FORCELOOP) != 0 ||
424                         (ch->sfx != NULL && ch->sfx->loopstart >= 0))
425                         continue;
426
427                 if (ch->end - paintedtime < life_left)
428                 {
429                         life_left = ch->end - paintedtime;
430                         first_to_die = ch_idx;
431                 }
432         }
433
434         if (first_to_die == -1)
435                 return NULL;
436
437         S_StopChannel (first_to_die);
438
439         return &channels[first_to_die];
440 }
441
442 /*
443 =================
444 SND_Spatialize
445
446 Spatializes a channel
447 =================
448 */
449 void SND_Spatialize(channel_t *ch, qboolean isstatic)
450 {
451         vec_t dist, scale, pan;
452         vec3_t source_vec;
453
454         // anything coming from the view entity will always be full volume
455         // LordHavoc: make sounds with ATTN_NONE have no spatialization
456         if (ch->entnum == cl.viewentity || ch->dist_mult == 0)
457         {
458                 ch->leftvol = ch->master_vol;
459                 ch->rightvol = ch->master_vol;
460         }
461         else
462         {
463                 // update sound origin if we know about the entity
464                 if (ch->entnum > 0 && cls.state == ca_connected && cl_entities[ch->entnum].state_current.active)
465                 {
466                         //Con_Printf("-- entnum %i origin %f %f %f neworigin %f %f %f\n", ch->entnum, ch->origin[0], ch->origin[1], ch->origin[2], cl_entities[ch->entnum].state_current.origin[0], cl_entities[ch->entnum].state_current.origin[1], cl_entities[ch->entnum].state_current.origin[2]);
467                         VectorCopy(cl_entities[ch->entnum].state_current.origin, ch->origin);
468                         if (cl_entities[ch->entnum].state_current.modelindex && cl.model_precache[cl_entities[ch->entnum].state_current.modelindex] && cl.model_precache[cl_entities[ch->entnum].state_current.modelindex]->soundfromcenter)
469                                 VectorMAMAM(1.0f, ch->origin, 0.5f, cl.model_precache[cl_entities[ch->entnum].state_current.modelindex]->normalmins, 0.5f, cl.model_precache[cl_entities[ch->entnum].state_current.modelindex]->normalmaxs, ch->origin);
470                 }
471
472                 // calculate stereo seperation and distance attenuation
473                 Matrix4x4_Transform(&listener_matrix, ch->origin, source_vec);
474                 dist = VectorNormalizeLength(source_vec);
475                 // distance
476                 scale = ch->master_vol * (1.0 - (dist * ch->dist_mult));
477                 // panning
478                 pan = scale * source_vec[1];
479                 // calculate the volumes
480                 ch->leftvol = (int) (scale + pan);
481                 ch->rightvol = (int) (scale - pan);
482         }
483
484         // Adjust volume of static sounds
485         if (isstatic)
486         {
487                 ch->leftvol *= snd_staticvolume.value;
488                 ch->rightvol *= snd_staticvolume.value;
489         }
490
491         // clamp volumes
492         ch->leftvol = bound(0, ch->leftvol, 255);
493         ch->rightvol = bound(0, ch->rightvol, 255);
494 }
495
496
497 // =======================================================================
498 // Start a sound effect
499 // =======================================================================
500
501 void S_PlaySfxOnChannel (sfx_t *sfx, channel_t *target_chan, unsigned int flags, vec3_t origin, float fvol, float attenuation, qboolean isstatic)
502 {
503         // Initialize the channel
504         memset (target_chan, 0, sizeof (*target_chan));
505         VectorCopy (origin, target_chan->origin);
506         target_chan->master_vol = fvol * 255;
507         target_chan->sfx = sfx;
508         target_chan->end = paintedtime + sfx->total_length;
509         target_chan->lastptime = paintedtime;
510         target_chan->flags = flags;
511
512         // If it's a static sound
513         if (isstatic)
514         {
515                 if (sfx->loopstart == -1)
516                         Con_DPrintf("Quake compatibility warning: Static sound \"%s\" is not looped\n", sfx->name);
517                 target_chan->dist_mult = attenuation / (64.0f * sound_nominal_clip_dist);
518         }
519         else
520                 target_chan->dist_mult = attenuation / sound_nominal_clip_dist;
521
522         // Lock the SFX during play
523         sfx->locks++;
524 }
525
526
527 int S_StartSound (int entnum, int entchannel, sfx_t *sfx, vec3_t origin, float fvol, float attenuation)
528 {
529         channel_t *target_chan, *check;
530         int             ch_idx;
531         size_t  skip;
532
533         if (!sound_started || !sfx || nosound.integer)
534                 return -1;
535
536         // Pick a channel to play on
537         target_chan = SND_PickChannel(entnum, entchannel);
538         if (!target_chan)
539                 return -1;
540
541         if (!S_LoadSound (sfx, true))
542                 return -1;              // couldn't load the sound's data
543
544         S_PlaySfxOnChannel (sfx, target_chan, CHANNELFLAG_NONE, origin, fvol, attenuation, false);
545         target_chan->entnum = entnum;
546         target_chan->entchannel = entchannel;
547
548         SND_Spatialize(target_chan, false);
549
550         // if an identical sound has also been started this frame, offset the pos
551         // a bit to keep it from just making the first one louder
552         check = &channels[NUM_AMBIENTS];
553         for (ch_idx=NUM_AMBIENTS ; ch_idx < NUM_AMBIENTS + MAX_DYNAMIC_CHANNELS ; ch_idx++, check++)
554         {
555                 if (check == target_chan)
556                         continue;
557                 if (check->sfx == sfx && !check->pos)
558                 {
559                         skip = 0.1 * sfx->format.speed;
560                         if (skip > sfx->total_length)
561                                 skip = sfx->total_length;
562                         if (skip > 0)
563                                 skip = rand() % skip;
564                         target_chan->pos += skip;
565                         target_chan->end -= skip;
566                         break;
567                 }
568         }
569
570         return (target_chan - channels);
571 }
572
573 void S_StopChannel (unsigned int channel_ind)
574 {
575         channel_t *ch;
576
577         if (channel_ind >= total_channels)
578                 return;
579
580         ch = &channels[channel_ind];
581         if (ch->sfx != NULL)
582         {
583                 sfx_t *sfx = ch->sfx;
584
585                 if (sfx->fetcher != NULL)
586                 {
587                         snd_fetcher_end_t fetcher_end = sfx->fetcher->end;
588                         if (fetcher_end != NULL)
589                                 fetcher_end (ch);
590                 }
591
592                 // Remove the lock it holds
593                 S_UnlockSfx (sfx);
594
595                 ch->sfx = NULL;
596         }
597         ch->end = 0;
598 }
599
600
601 qboolean S_SetChannelFlag (unsigned int ch_ind, unsigned int flag, qboolean value)
602 {
603         if (ch_ind >= total_channels)
604                 return false;
605
606         if (flag != CHANNELFLAG_FORCELOOP &&
607                 flag != CHANNELFLAG_PAUSED &&
608                 flag != CHANNELFLAG_FULLVOLUME)
609                 return false;
610
611         if (value)
612                 channels[ch_ind].flags |= flag;
613         else
614                 channels[ch_ind].flags &= ~flag;
615
616         return true;
617 }
618
619 void S_StopSound(int entnum, int entchannel)
620 {
621         unsigned int i;
622
623         for (i = 0; i < MAX_DYNAMIC_CHANNELS; i++)
624                 if (channels[i].entnum == entnum && channels[i].entchannel == entchannel)
625                 {
626                         S_StopChannel (i);
627                         return;
628                 }
629 }
630
631 void S_StopAllSounds (void)
632 {
633         unsigned int i;
634
635         for (i = 0; i < total_channels; i++)
636                 S_StopChannel (i);
637
638         total_channels = MAX_DYNAMIC_CHANNELS + NUM_AMBIENTS;   // no statics
639         memset(channels, 0, MAX_CHANNELS * sizeof(channel_t));
640
641         S_ClearBuffer ();
642 }
643
644 void S_PauseGameSounds (qboolean toggle)
645 {
646         unsigned int i;
647
648         for (i = 0; i < total_channels; i++)
649         {
650                 channel_t *ch;
651
652                 ch = &channels[i];
653                 if (ch->sfx != NULL && ! (ch->flags & CHANNELFLAG_LOCALSOUND))
654                         S_SetChannelFlag (i, CHANNELFLAG_PAUSED, toggle);
655         }
656 }
657
658 void S_SetChannelVolume (unsigned int ch_ind, float fvol)
659 {
660         channels[ch_ind].master_vol = fvol * 255;
661 }
662
663
664 void S_ClearBuffer(void)
665 {
666         int     clear;
667         unsigned char *pbuf;
668
669         if (!sound_started || !shm)
670                 return;
671
672         if (shm->format.width == 1)
673                 clear = 0x80;   // 8 bit sound (unsigned)
674         else
675                 clear = 0;              // 16 bit sound (signed)
676
677         pbuf = S_LockBuffer();
678         if (pbuf != NULL)
679         {
680                 int setsize = shm->samples * shm->format.width;
681
682                 while (setsize--)
683                         *pbuf++ = clear;
684
685                 // on i586/i686 optimized versions of glibc, glibc *wrongly* IMO,
686                 // reads the memory area before writing to it causing a seg fault
687                 // since the memory is PROT_WRITE only and not PROT_READ|PROT_WRITE
688                 //memset(shm->buffer, clear, shm->samples * shm->format.width);
689
690                 S_UnlockBuffer ();
691         }
692 }
693
694
695 /*
696 =================
697 S_StaticSound
698 =================
699 */
700 void S_StaticSound (sfx_t *sfx, vec3_t origin, float fvol, float attenuation)
701 {
702         channel_t       *target_chan;
703
704         if (!sfx)
705                 return;
706
707         if (total_channels == MAX_CHANNELS)
708         {
709                 Con_Print("total_channels == MAX_CHANNELS\n");
710                 return;
711         }
712
713         if (!S_LoadSound (sfx, true))
714                 return;
715
716         target_chan = &channels[total_channels++];
717         S_PlaySfxOnChannel (sfx, target_chan, CHANNELFLAG_FORCELOOP, origin, fvol, attenuation, true);
718
719         SND_Spatialize (target_chan, true);
720 }
721
722
723 //=============================================================================
724
725 /*
726 ===================
727 S_UpdateAmbientSounds
728
729 ===================
730 */
731 void S_UpdateAmbientSounds (void)
732 {
733         float           vol;
734         int                     ambient_channel;
735         channel_t       *chan;
736         qbyte           ambientlevels[NUM_AMBIENTS];
737
738         // Mute ambient sounds until proven otherwise
739         for (ambient_channel = 0 ; ambient_channel < NUM_AMBIENTS;ambient_channel++)
740                 channels[ambient_channel].master_vol = 0;
741
742         if (ambient_level.value <= 0 || !cl.worldmodel || !cl.worldmodel->brush.AmbientSoundLevelsForPoint)
743                 return;
744
745         cl.worldmodel->brush.AmbientSoundLevelsForPoint(cl.worldmodel, listener_origin, ambientlevels, sizeof(ambientlevels));
746
747         // Calc ambient sound levels
748         for (ambient_channel = 0 ; ambient_channel< NUM_AMBIENTS ; ambient_channel++)
749         {
750                 chan = &channels[ambient_channel];
751                 if (chan->sfx == NULL || (chan->sfx->flags & SFXFLAG_FILEMISSING))
752                         continue;
753
754                 vol = ambient_level.value * ambientlevels[ambient_channel];
755                 if (vol < 8)
756                         vol = 0;
757
758                 // Don't adjust volume too fast
759                 if (chan->master_vol < vol)
760                 {
761                         chan->master_vol += host_realframetime * ambient_fade.value;
762                         if (chan->master_vol > vol)
763                                 chan->master_vol = vol;
764                 }
765                 else if (chan->master_vol > vol)
766                 {
767                         chan->master_vol -= host_realframetime * ambient_fade.value;
768                         if (chan->master_vol < vol)
769                                 chan->master_vol = vol;
770                 }
771
772                 chan->leftvol = chan->rightvol = chan->master_vol;
773         }
774 }
775
776
777 /*
778 ============
779 S_Update
780
781 Called once each time through the main loop
782 ============
783 */
784 void S_Update(const matrix4x4_t *listenermatrix)
785 {
786         unsigned int i, j, total;
787         channel_t *ch, *combine;
788
789         if (!snd_initialized.integer || (snd_blocked > 0))
790                 return;
791
792         Matrix4x4_Invert_Simple(&listener_matrix, listenermatrix);
793         Matrix4x4_OriginFromMatrix(listenermatrix, listener_origin);
794
795         // update general area ambient sound sources
796         S_UpdateAmbientSounds ();
797
798         combine = NULL;
799
800         // update spatialization for static and dynamic sounds
801         ch = channels+NUM_AMBIENTS;
802         for (i=NUM_AMBIENTS ; i<total_channels; i++, ch++)
803         {
804                 if (!ch->sfx)
805                         continue;
806                 SND_Spatialize(ch, i >= MAX_DYNAMIC_CHANNELS + NUM_AMBIENTS);         // respatialize channel
807                 if (!ch->leftvol && !ch->rightvol)
808                         continue;
809
810                 // try to combine static sounds with a previous channel of the same
811                 // sound effect so we don't mix five torches every frame
812                 if (i > MAX_DYNAMIC_CHANNELS + NUM_AMBIENTS)
813                 {
814                         // see if it can just use the last one
815                         if (combine && combine->sfx == ch->sfx)
816                         {
817                                 combine->leftvol += ch->leftvol;
818                                 combine->rightvol += ch->rightvol;
819                                 ch->leftvol = ch->rightvol = 0;
820                                 continue;
821                         }
822                         // search for one
823                         combine = channels+MAX_DYNAMIC_CHANNELS + NUM_AMBIENTS;
824                         for (j=MAX_DYNAMIC_CHANNELS + NUM_AMBIENTS ; j<i; j++, combine++)
825                                 if (combine->sfx == ch->sfx)
826                                         break;
827
828                         if (j == total_channels)
829                                 combine = NULL;
830                         else
831                         {
832                                 if (combine != ch)
833                                 {
834                                         combine->leftvol += ch->leftvol;
835                                         combine->rightvol += ch->rightvol;
836                                         ch->leftvol = ch->rightvol = 0;
837                                 }
838                                 continue;
839                         }
840                 }
841         }
842
843         sound_spatialized = true;
844
845         // debugging output
846         if (snd_show.integer)
847         {
848                 total = 0;
849                 ch = channels;
850                 for (i=0 ; i<total_channels; i++, ch++)
851                         if (ch->sfx && (ch->leftvol || ch->rightvol) )
852                                 total++;
853
854                 Con_Printf("----(%u)----\n", total);
855         }
856
857         S_Update_();
858 }
859
860 void GetSoundtime(void)
861 {
862         int             samplepos;
863         static  int             buffers;
864         static  int             oldsamplepos;
865         int             fullsamples;
866
867         fullsamples = shm->samples / shm->format.channels;
868
869         // it is possible to miscount buffers if it has wrapped twice between
870         // calls to S_Update.  Oh well.
871         samplepos = SNDDMA_GetDMAPos();
872
873         if (samplepos < oldsamplepos)
874         {
875                 buffers++;                                      // buffer wrapped
876
877                 if (paintedtime > 0x40000000)
878                 {       // time to chop things off to avoid 32 bit limits
879                         buffers = 0;
880                         paintedtime = fullsamples;
881                         S_StopAllSounds ();
882                 }
883         }
884         oldsamplepos = samplepos;
885
886         soundtime = buffers * fullsamples + samplepos / shm->format.channels;
887 }
888
889 void S_ExtraUpdate (void)
890 {
891         if (snd_noextraupdate.integer || !sound_spatialized)
892                 return;
893
894         S_Update_();
895 }
896
897 void S_Update_(void)
898 {
899         unsigned        endtime;
900         int                             samps;
901
902         if (!sound_started || (snd_blocked > 0))
903                 return;
904
905         // Updates DMA time
906         GetSoundtime();
907
908         // check to make sure that we haven't overshot
909         if (paintedtime < soundtime)
910                 paintedtime = soundtime;
911
912         // mix ahead of current position
913         endtime = soundtime + _snd_mixahead.value * shm->format.speed;
914         samps = shm->samples >> (shm->format.channels - 1);
915         if (endtime > (unsigned int)(soundtime + samps))
916                 endtime = soundtime + samps;
917
918         S_PaintChannels (endtime);
919
920         SNDDMA_Submit ();
921 }
922
923 /*
924 ===============================================================================
925
926 console functions
927
928 ===============================================================================
929 */
930
931 static void S_Play_Common(float fvol, float attenuation)
932 {
933         int     i, ch_ind;
934         char name[256];
935         sfx_t   *sfx;
936
937         i = 1;
938         while (i<Cmd_Argc())
939         {
940                 strlcpy(name, Cmd_Argv(i), sizeof(name));
941                 if (!strrchr(name, '.'))
942                         strlcat(name, ".wav", sizeof(name));
943                 i++;
944                 sfx = S_PrecacheSound (name, true, false);
945                 // add a lock and the serversound flag to the sfx so it will be kept
946                 // until level change
947                 if (sfx && !(sfx->flags & SFXFLAG_SERVERSOUND))
948                 {
949                         sfx->flags |= SFXFLAG_SERVERSOUND;
950                         sfx->locks++;
951                 }
952
953
954                 // If we need to get the volume from the command line
955                 if (fvol == -1.0f)
956                 {
957                         fvol = atof(Cmd_Argv(i));
958                         i++;
959                 }
960
961                 ch_ind = S_StartSound(-1, 0, sfx, listener_origin, fvol, attenuation);
962
963                 // Free the sfx if the file didn't exist
964                 if (ch_ind < 0)
965                         S_FreeSfx (sfx);
966                 else
967                         channels[ch_ind].flags |= CHANNELFLAG_LOCALSOUND;
968         }
969 }
970
971 void S_Play(void)
972 {
973         S_Play_Common (1.0f, 1.0f);
974 }
975
976 void S_Play2(void)
977 {
978         S_Play_Common (1.0f, 0.0f);
979 }
980
981 void S_PlayVol(void)
982 {
983         S_Play_Common (-1.0f, 0.0f);
984 }
985
986 void S_SoundList(void)
987 {
988         unsigned int i;
989         sfx_t   *sfx;
990         int             size, total;
991
992         total = 0;
993         for (sfx = known_sfx, i = 0; sfx != NULL; sfx = sfx->next, i++)
994         {
995                 if (sfx->fetcher != NULL)
996                 {
997                         size = sfx->mempool->totalsize;
998                         total += size;
999                         Con_Printf ("%c%c(%2db, %6s) %8i : %s\n",
1000                                                 (sfx->loopstart >= 0) ? 'L' : ' ',
1001                                                 (sfx->flags & SFXFLAG_STREAMED) ? 'S' : ' ',
1002                                                 sfx->format.width * 8,
1003                                                 (sfx->format.channels == 1) ? "mono" : "stereo",
1004                                                 size,
1005                                                 sfx->name);
1006                 }
1007         }
1008         Con_Printf("Total resident: %i\n", total);
1009 }
1010
1011
1012 qboolean S_LocalSound (const char *sound)
1013 {
1014         sfx_t   *sfx;
1015         int             ch_ind;
1016
1017         if (!snd_initialized.integer || nosound.integer)
1018                 return true;
1019
1020         sfx = S_PrecacheSound (sound, true, true);
1021         if (!sfx)
1022         {
1023                 Con_Printf("S_LocalSound: can't precache %s\n", sound);
1024                 return false;
1025         }
1026
1027         ch_ind = S_StartSound (cl.viewentity, 0, sfx, vec3_origin, 1, 1);
1028         if (ch_ind < 0)
1029                 return false;
1030
1031         channels[ch_ind].flags |= CHANNELFLAG_LOCALSOUND;
1032         return true;
1033 }