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