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