/
mixer.c
925 lines (824 loc) · 22.3 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
/*
MIXERLIB: An audio mixer library based on the SDL library
Copyright (C) 1997-1999 Sam Lantinga
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Sam Lantinga
5635-34 Springhouse Dr.
Pleasanton, CA 94588 (USA)
slouken@devolution.com
*/
25
26
/* $Id$ */
27
28
29
30
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
31
32
#include "SDL_mutex.h"
#include "SDL_endian.h"
33
#include "SDL_timer.h"
34
35
#include "SDL_mixer.h"
36
37
38
39
40
41
42
43
44
45
46
47
static int audio_opened = 0;
static SDL_AudioSpec mixer;
static SDL_mutex *mixer_lock;
static struct _Mix_Channel {
Mix_Chunk *chunk;
int playing;
int paused;
Uint8 *samples;
int volume;
int looping;
48
int tag;
49
Uint32 expire;
50
Uint32 start_time;
51
52
Mix_Fading fading;
int fade_volume;
53
Uint32 fade_length;
54
Uint32 ticks_fade;
55
} *mix_channel = NULL;
56
static int num_channels;
57
static int reserved_channels = 0;
58
59
60
61
/* Support for hooking into the mixer callback system */
static void (*mix_postmix)(void *udata, Uint8 *stream, int len) = NULL;
62
static void *mix_postmix_data = NULL;
63
64
65
66
/* rcg07062001 callback to alert when channels are done playing. */
static void (*channel_done_callback)(int channel) = NULL;
67
68
69
70
/* Music function declarations */
extern int open_music(SDL_AudioSpec *mixer);
extern void close_music(void);
71
/* Support for user defined music functions, plus the default one */
72
extern int volatile music_active;
73
74
extern void music_mixer(void *udata, Uint8 *stream, int len);
static void (*mix_music)(void *udata, Uint8 *stream, int len) = music_mixer;
75
static void *music_data = NULL;
76
77
78
79
80
/* Mixing function */
static void mix_channels(void *udata, Uint8 *stream, int len)
{
int i, mixable, volume;
81
Uint32 sdl_ticks;
82
83
/* Mix the music (must be done before the channels are added) */
84
if ( music_active || (mix_music != music_mixer) ) {
85
86
87
mix_music(music_data, stream, len);
}
88
89
/* Grab the channels we need to mix */
SDL_mutexP(mixer_lock);
90
91
sdl_ticks = SDL_GetTicks();
for ( i=0; i<num_channels; ++i ) {
92
93
if( ! mix_channel[i].paused ) {
if ( mix_channel[i].expire > 0 && mix_channel[i].expire < sdl_ticks ) {
94
/* Expiration delay for that channel is reached */
95
96
97
98
99
100
101
102
103
104
mix_channel[i].playing = 0;
mix_channel[i].fading = MIX_NO_FADING;
mix_channel[i].expire = 0;
} else if ( mix_channel[i].fading != MIX_NO_FADING ) {
Uint32 ticks = sdl_ticks - mix_channel[i].ticks_fade;
if( ticks > mix_channel[i].fade_length ) {
if( mix_channel[i].fading == MIX_FADING_OUT ) {
mix_channel[i].playing = 0;
mix_channel[i].expire = 0;
Mix_Volume(i, mix_channel[i].fading); /* Restore the volume */
105
}
106
mix_channel[i].fading = MIX_NO_FADING;
107
} else {
108
109
110
if( mix_channel[i].fading == MIX_FADING_OUT ) {
Mix_Volume(i, (mix_channel[i].fade_volume * (mix_channel[i].fade_length-ticks))
/ mix_channel[i].fade_length );
111
} else {
112
Mix_Volume(i, (mix_channel[i].fade_volume * ticks) / mix_channel[i].fade_length );
113
}
114
115
}
}
116
117
118
if ( mix_channel[i].playing > 0 ) {
volume = (mix_channel[i].volume*mix_channel[i].chunk->volume) / MIX_MAX_VOLUME;
mixable = mix_channel[i].playing;
119
120
121
if ( mixable > len ) {
mixable = len;
}
122
123
124
SDL_MixAudio(stream,mix_channel[i].samples,mixable,volume);
mix_channel[i].samples += mixable;
mix_channel[i].playing -= mixable;
125
126
/* If looping the sample and we are at its end, make sure
we will still return a full buffer */
127
while ( mix_channel[i].looping && mixable < len ) {
128
int remaining = len - mixable;
129
int alen = mix_channel[i].chunk->alen;
130
131
132
if (remaining > alen) {
remaining = alen;
}
133
134
135
136
SDL_MixAudio(stream+mixable, mix_channel[i].chunk->abuf, remaining, volume);
--mix_channel[i].looping;
mix_channel[i].samples = mix_channel[i].chunk->abuf + remaining;
mix_channel[i].playing = mix_channel[i].chunk->alen - remaining;
137
138
mixable += remaining;
}
139
140
141
142
if ( ! mix_channel[i].playing && mix_channel[i].looping ) {
if ( --mix_channel[i].looping ) {
mix_channel[i].samples = mix_channel[i].chunk->abuf;
mix_channel[i].playing = mix_channel[i].chunk->alen;
143
}
144
}
145
146
147
148
149
/* rcg06072001 Alert app if channel is done playing. */
if ( (!mix_channel[i].playing) && (channel_done_callback) ) {
channel_done_callback(i);
}
150
151
152
}
}
}
153
154
155
if ( mix_postmix ) {
mix_postmix(mix_postmix_data, stream, len);
}
156
157
158
159
160
161
162
163
164
165
166
SDL_mutexV(mixer_lock);
}
static void PrintFormat(char *title, SDL_AudioSpec *fmt)
{
printf("%s: %d bit %s audio (%s) at %u Hz\n", title, (fmt->format&0xFF),
(fmt->format&0x8000) ? "signed" : "unsigned",
(fmt->channels > 1) ? "stereo" : "mono", fmt->freq);
}
/* Open the mixer with a certain desired audio format */
167
int Mix_OpenAudio(int frequency, Uint16 format, int nchannels, int chunksize)
168
169
170
171
172
173
174
175
176
177
178
179
180
{
int i;
SDL_AudioSpec desired;
/* If the mixer is already opened, increment open count */
if ( audio_opened ) {
++audio_opened;
return(0);
}
/* Set the desired format and frequency */
desired.freq = frequency;
desired.format = format;
181
desired.channels = nchannels;
182
183
184
185
186
187
188
189
190
191
192
193
194
195
desired.samples = chunksize;
desired.callback = mix_channels;
desired.userdata = NULL;
/* Accept nearly any audio format */
if ( SDL_OpenAudio(&desired, &mixer) < 0 ) {
return(-1);
}
#if 0
PrintFormat("Audio device", &mixer);
#endif
/* Create the channel lock mutex */
mixer_lock = SDL_CreateMutex();
196
#ifndef macintosh /* Hmm.. what implications does this have? */
197
198
199
200
201
if ( mixer_lock == NULL ) {
SDL_CloseAudio();
SDL_SetError("Unable to create mixer lock");
return(-1);
}
202
#endif
203
204
205
206
207
208
209
/* Initialize the music players */
if ( open_music(&mixer) < 0 ) {
SDL_CloseAudio();
SDL_DestroyMutex(mixer_lock);
return(-1);
}
210
211
num_channels = MIX_CHANNELS;
212
mix_channel = (struct _Mix_Channel *) malloc(num_channels * sizeof(struct _Mix_Channel));
213
214
/* Clear out the audio channels */
215
for ( i=0; i<num_channels; ++i ) {
216
217
218
219
220
221
mix_channel[i].chunk = NULL;
mix_channel[i].playing = 0;
mix_channel[i].looping = 0;
mix_channel[i].volume = SDL_MIX_MAXVOLUME;
mix_channel[i].tag = -1;
mix_channel[i].expire = 0;
222
223
224
225
226
227
228
}
Mix_VolumeMusic(SDL_MIX_MAXVOLUME);
audio_opened = 1;
SDL_PauseAudio(0);
return(0);
}
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
/* Dynamically change the number of channels managed by the mixer.
If decreasing the number of channels, the upper channels are
stopped.
*/
int Mix_AllocateChannels(int numchans)
{
if ( numchans<0 || numchans==num_channels )
return(num_channels);
if ( numchans < num_channels ) {
/* Stop the affected channels */
int i;
for(i=numchans; i < num_channels; i++) {
Mix_HaltChannel(i);
}
}
SDL_mutexP(mixer_lock);
246
mix_channel = (struct _Mix_Channel *) realloc(mix_channel, numchans * sizeof(struct _Mix_Channel));
247
248
249
250
if ( numchans > num_channels ) {
/* Initialize the new channels */
int i;
for(i=num_channels; i < numchans; i++) {
251
252
253
254
255
256
mix_channel[i].chunk = NULL;
mix_channel[i].playing = 0;
mix_channel[i].looping = 0;
mix_channel[i].volume = SDL_MIX_MAXVOLUME;
mix_channel[i].tag = -1;
mix_channel[i].expire = 0;
257
258
259
260
261
262
263
}
}
num_channels = numchans;
SDL_mutexV(mixer_lock);
return(num_channels);
}
264
265
266
267
268
269
270
271
272
273
/* Return the actual mixer parameters */
int Mix_QuerySpec(int *frequency, Uint16 *format, int *channels)
{
if ( audio_opened ) {
if ( frequency ) {
*frequency = mixer.freq;
}
if ( format ) {
*format = mixer.format;
}
274
if ( channels ) {
275
276
277
278
279
280
*channels = mixer.channels;
}
}
return(audio_opened);
}
281
282
283
284
285
286
287
288
289
290
291
/*
* !!! FIXME: Ideally, we want a Mix_LoadSample_RW(), which will handle the
* generic setup, then call the correct file format loader.
*/
#ifdef VOC_SAMPLES
SDL_AudioSpec *Mix_LoadVOC_RW (SDL_RWops *src, int freesrc,
SDL_AudioSpec *spec, Uint8 **audio_buf, Uint32 *audio_len);
#endif
292
293
294
295
296
297
/* Load a wave file */
Mix_Chunk *Mix_LoadWAV_RW(SDL_RWops *src, int freesrc)
{
Mix_Chunk *chunk;
SDL_AudioSpec wavespec;
SDL_AudioCVT wavecvt;
298
int samplesize;
299
300
301
302
303
304
305
/* rcg06012001 Make sure src is valid */
if ( ! src ) {
SDL_SetError("Mix_LoadWAV_RW with NULL SDL_RWops");
return(NULL);
}
306
307
308
/* Make sure audio has been opened */
if ( ! audio_opened ) {
SDL_SetError("Audio device hasn't been opened");
309
if ( freesrc && src ) {
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
SDL_RWclose(src);
}
return(NULL);
}
/* Allocate the chunk memory */
chunk = (Mix_Chunk *)malloc(sizeof(Mix_Chunk));
if ( chunk == NULL ) {
SDL_SetError("Out of memory");
if ( freesrc ) {
SDL_RWclose(src);
}
return(NULL);
}
325
326
327
328
329
/* rcg06012001 Handle Creative Labs .VOC format chunks. */
#ifdef VOC_SAMPLES
if ( Mix_LoadVOC_RW(src, 0,
&wavespec, (Uint8 **)&chunk->abuf, &chunk->alen) == NULL ) {
#endif
330
331
332
333
334
335
/* Load the WAV file into the chunk */
if ( SDL_LoadWAV_RW(src, freesrc,
&wavespec, (Uint8 **)&chunk->abuf, &chunk->alen) == NULL ) {
free(chunk);
return(NULL);
}
336
337
338
339
340
#ifdef VOC_SAMPLES
}
#endif
341
342
343
344
345
346
347
348
349
350
351
352
353
#if 0
PrintFormat("Audio device", &mixer);
PrintFormat("-- Wave file", &wavespec);
#endif
/* Build the audio converter and create conversion buffers */
if ( SDL_BuildAudioCVT(&wavecvt,
wavespec.format, wavespec.channels, wavespec.freq,
mixer.format, mixer.channels, mixer.freq) < 0 ) {
SDL_FreeWAV(chunk->abuf);
free(chunk);
return(NULL);
}
354
355
samplesize = ((wavespec.format & 0xFF)/8)*wavespec.channels;
wavecvt.len = chunk->alen & ~(samplesize-1);
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
wavecvt.buf = (Uint8 *)malloc(wavecvt.len*wavecvt.len_mult);
if ( wavecvt.buf == NULL ) {
SDL_SetError("Out of memory");
SDL_FreeWAV(chunk->abuf);
free(chunk);
return(NULL);
}
memcpy(wavecvt.buf, chunk->abuf, chunk->alen);
SDL_FreeWAV(chunk->abuf);
/* Run the audio converter */
if ( SDL_ConvertAudio(&wavecvt) < 0 ) {
free(wavecvt.buf);
free(chunk);
return(NULL);
}
372
chunk->allocated = 1;
373
374
375
376
377
378
chunk->abuf = wavecvt.buf;
chunk->alen = wavecvt.len_cvt;
chunk->volume = MIX_MAX_VOLUME;
return(chunk);
}
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
/* Load a wave file of the mixer format from a memory buffer */
Mix_Chunk *Mix_QuickLoad_WAV(Uint8 *mem)
{
Mix_Chunk *chunk;
Uint8 magic[4];
/* Make sure audio has been opened */
if ( ! audio_opened ) {
SDL_SetError("Audio device hasn't been opened");
return(NULL);
}
/* Allocate the chunk memory */
chunk = (Mix_Chunk *)malloc(sizeof(Mix_Chunk));
if ( chunk == NULL ) {
SDL_SetError("Out of memory");
return(NULL);
}
/* Essentially just skip to the audio data (no error checking - fast) */
chunk->allocated = 0;
mem += 12; /* WAV header */
do {
memcpy(magic, mem, 4);
mem += 4;
chunk->alen = ((mem[3]<<24)|(mem[2]<<16)|(mem[1]<<8)|(mem[0]));
mem += 4;
chunk->abuf = mem;
mem += chunk->alen;
} while ( memcmp(magic, "data", 4) != 0 );
chunk->volume = MIX_MAX_VOLUME;
return(chunk);
}
414
415
416
417
418
419
420
421
/* Free an audio chunk previously loaded */
void Mix_FreeChunk(Mix_Chunk *chunk)
{
int i;
/* Caution -- if the chunk is playing, the mixer will crash */
if ( chunk ) {
/* Guarantee that this chunk isn't playing */
422
423
424
425
426
427
if ( mix_channel ) {
SDL_mutexP(mixer_lock);
for ( i=0; i<num_channels; ++i ) {
if ( chunk == mix_channel[i].chunk ) {
mix_channel[i].playing = 0;
}
428
}
429
SDL_mutexV(mixer_lock);
430
431
432
}
/* Actually free the chunk */
433
434
435
if ( chunk->allocated ) {
free(chunk->abuf);
}
436
437
438
439
free(chunk);
}
}
440
441
442
443
444
445
446
447
448
449
450
451
452
/* Set a function that is called after all mixing is performed.
This can be used to provide real-time visual display of the audio stream
or add a custom mixer filter for the stream data.
*/
void Mix_SetPostMix(void (*mix_func)
(void *udata, Uint8 *stream, int len), void *arg)
{
SDL_LockAudio();
mix_postmix_data = arg;
mix_postmix = mix_func;
SDL_UnlockAudio();
}
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
/* Add your own music player or mixer function.
If 'mix_func' is NULL, the default music player is re-enabled.
*/
void Mix_HookMusic(void (*mix_func)(void *udata, Uint8 *stream, int len),
void *arg)
{
SDL_LockAudio();
if ( mix_func != NULL ) {
music_data = arg;
mix_music = mix_func;
} else {
music_data = NULL;
mix_music = music_mixer;
}
SDL_UnlockAudio();
}
void *Mix_GetMusicHookData(void)
{
return(music_data);
}
475
476
477
478
479
480
481
482
void Mix_ChannelFinished(void (*channel_finished)(int channel))
{
SDL_LockAudio();
channel_done_callback = channel_finished;
SDL_UnlockAudio();
}
483
484
485
486
487
488
/* Reserve the first channels (0 -> n-1) for the application, i.e. don't allocate
them dynamically to the next sample if requested with a -1 value below.
Returns the number of reserved channels.
*/
int Mix_ReserveChannels(int num)
{
489
490
if (num > num_channels)
num = num_channels;
491
492
493
494
495
496
reserved_channels = num;
return num;
}
/* Play an audio chunk on a specific channel.
If the specified channel is -1, play on the first free channel.
497
498
'ticks' is the number of milliseconds at most to play the sample, or -1
if there is no limit.
499
500
Returns which channel was used to play the sound.
*/
501
int Mix_PlayChannelTimed(int which, Mix_Chunk *chunk, int loops, int ticks)
502
503
504
505
506
507
508
509
510
511
512
513
514
{
int i;
/* Don't play null pointers :-) */
if ( chunk == NULL ) {
return(-1);
}
/* Lock the mixer while modifying the playing channels */
SDL_mutexP(mixer_lock);
{
/* If which is -1, play on the first free channel */
if ( which == -1 ) {
515
for ( i=reserved_channels; i<num_channels; ++i ) {
516
if ( mix_channel[i].playing <= 0 )
517
518
break;
}
519
if ( i == num_channels ) {
520
521
522
523
524
525
526
527
which = -1;
} else {
which = i;
}
}
/* Queue up the audio data for this channel */
if ( which >= 0 ) {
528
Uint32 sdl_ticks = SDL_GetTicks();
529
530
531
532
533
534
535
536
mix_channel[which].samples = chunk->abuf;
mix_channel[which].playing = chunk->alen;
mix_channel[which].looping = loops;
mix_channel[which].chunk = chunk;
mix_channel[which].paused = 0;
mix_channel[which].fading = MIX_NO_FADING;
mix_channel[which].start_time = sdl_ticks;
mix_channel[which].expire = (ticks>0) ? (sdl_ticks + ticks) : 0;
537
538
539
540
541
542
543
544
}
}
SDL_mutexV(mixer_lock);
/* Return the channel on which the sound is being played */
return(which);
}
545
546
547
548
549
550
551
552
553
554
555
556
/* Change the expiration delay for a channel */
int Mix_ExpireChannel(int which, int ticks)
{
int status = 0;
if ( which == -1 ) {
int i;
for ( i=0; i < num_channels; ++ i ) {
status += Mix_ExpireChannel(i, ticks);
}
} else if ( which < num_channels ) {
SDL_mutexP(mixer_lock);
557
mix_channel[which].expire = (ticks>0) ? (SDL_GetTicks() + ticks) : 0;
558
559
560
561
562
563
SDL_mutexV(mixer_lock);
++ status;
}
return(status);
}
564
/* Fade in a sound on a channel, over ms milliseconds */
565
int Mix_FadeInChannelTimed(int which, Mix_Chunk *chunk, int loops, int ms, int ticks)
566
567
568
569
570
571
572
573
574
575
576
577
578
{
int i;
/* Don't play null pointers :-) */
if ( chunk == NULL ) {
return(-1);
}
/* Lock the mixer while modifying the playing channels */
SDL_mutexP(mixer_lock);
{
/* If which is -1, play on the first free channel */
if ( which == -1 ) {
579
for ( i=reserved_channels; i<num_channels; ++i ) {
580
if ( mix_channel[i].playing <= 0 )
581
582
break;
}
583
if ( i == num_channels ) {
584
585
586
587
588
589
590
591
which = -1;
} else {
which = i;
}
}
/* Queue up the audio data for this channel */
if ( which >= 0 ) {
592
Uint32 sdl_ticks = SDL_GetTicks();
593
594
595
596
597
598
599
600
601
602
603
mix_channel[which].samples = chunk->abuf;
mix_channel[which].playing = chunk->alen;
mix_channel[which].looping = loops;
mix_channel[which].chunk = chunk;
mix_channel[which].paused = 0;
mix_channel[which].fading = MIX_FADING_IN;
mix_channel[which].fade_volume = mix_channel[which].volume;
mix_channel[which].volume = 0;
mix_channel[which].fade_length = (Uint32)ms;
mix_channel[which].start_time = mix_channel[which].ticks_fade = sdl_ticks;
mix_channel[which].expire = (ticks > 0) ? (sdl_ticks+ticks) : 0;
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
}
}
SDL_mutexV(mixer_lock);
/* Return the channel on which the sound is being played */
return(which);
}
/* Set volume of a particular channel */
int Mix_Volume(int which, int volume)
{
int i;
int prev_volume;
if ( which == -1 ) {
prev_volume = 0;
620
for ( i=0; i<num_channels; ++i ) {
621
622
prev_volume += Mix_Volume(i, volume);
}
623
prev_volume /= num_channels;
624
} else {
625
prev_volume = mix_channel[which].volume;
626
627
if ( volume < 0 ) {
volume = 0;
628
}
629
630
631
if ( volume > SDL_MIX_MAXVOLUME ) {
volume = SDL_MIX_MAXVOLUME;
}
632
mix_channel[which].volume = volume;
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
}
return(prev_volume);
}
/* Set volume of a particular chunk */
int Mix_VolumeChunk(Mix_Chunk *chunk, int volume)
{
int prev_volume;
prev_volume = chunk->volume;
if ( volume >= 0 ) {
if ( volume > MIX_MAX_VOLUME ) {
volume = MIX_MAX_VOLUME;
}
chunk->volume = volume;
}
return(prev_volume);
}
/* Halt playing of a particular channel */
int Mix_HaltChannel(int which)
{
int i;
if ( which == -1 ) {
657
for ( i=0; i<num_channels; ++i ) {
658
659
660
661
Mix_HaltChannel(i);
}
} else {
SDL_mutexP(mixer_lock);
662
663
664
665
666
mix_channel[which].playing = 0;
mix_channel[which].expire = 0;
if(mix_channel[which].fading != MIX_NO_FADING) /* Restore volume */
mix_channel[which].volume = mix_channel[which].fade_volume;
mix_channel[which].fading = MIX_NO_FADING;
667
668
669
670
671
SDL_mutexV(mixer_lock);
}
return(0);
}
672
673
674
675
676
677
/* Halt playing of a particular group of channels */
int Mix_HaltGroup(int tag)
{
int i;
for ( i=0; i<num_channels; ++i ) {
678
if( mix_channel[i].tag == tag ) {
679
680
681
682
683
684
Mix_HaltChannel(i);
}
}
return(0);
}
685
686
687
688
689
690
/* Fade out a channel and then stop it automatically */
int Mix_FadeOutChannel(int which, int ms)
{
int status;
status = 0;
691
692
693
if ( audio_opened ) {
if ( which == -1 ) {
int i;
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
for ( i=0; i<num_channels; ++i ) {
status += Mix_FadeOutChannel(i, ms);
}
} else {
SDL_mutexP(mixer_lock);
if ( mix_channel[which].playing &&
(mix_channel[which].volume > 0) &&
(mix_channel[which].fading != MIX_FADING_OUT) ) {
mix_channel[which].fading = MIX_FADING_OUT;
mix_channel[which].fade_volume = mix_channel[which].volume;
mix_channel[which].fade_length = ms;
mix_channel[which].ticks_fade = SDL_GetTicks();
++status;
}
SDL_mutexV(mixer_lock);
711
712
713
714
715
}
}
return(status);
}
716
717
718
719
720
721
/* Halt playing of a particular group of channels */
int Mix_FadeOutGroup(int tag, int ms)
{
int i;
int status = 0;
for ( i=0; i<num_channels; ++i ) {
722
if( mix_channel[i].tag == tag ) {
723
724
725
726
727
728
status += Mix_FadeOutChannel(i,ms);
}
}
return(status);
}
729
730
Mix_Fading Mix_FadingChannel(int which)
{
731
return mix_channel[which].fading;
732
733
}
734
/* Check the status of a specific channel.
735
If the specified mix_channel is -1, check all mix_channels.
736
737
738
739
740
741
742
743
744
*/
int Mix_Playing(int which)
{
int status;
status = 0;
if ( which == -1 ) {
int i;
745
for ( i=0; i<num_channels; ++i ) {
746
if ( mix_channel[i].playing > 0 ) {
747
748
749
750
++status;
}
}
} else {
751
if ( mix_channel[which].playing > 0 ) {
752
753
754
755
756
757
++status;
}
}
return(status);
}
758
759
760
761
762
763
764
765
766
767
768
769
/* rcg06072001 Get the chunk associated with a channel. */
Mix_Chunk *Mix_GetChunk(int channel)
{
Mix_Chunk *retval = NULL;
if ((channel >= 0) && (channel < num_channels)) {
retval = mix_channel[channel].chunk;
}
return(retval);
}
770
771
772
773
774
775
776
777
778
/* Close the mixer, halting all playing audio */
void Mix_CloseAudio(void)
{
if ( audio_opened ) {
if ( audio_opened == 1 ) {
close_music();
Mix_HaltChannel(-1);
SDL_CloseAudio();
SDL_DestroyMutex(mixer_lock);
779
780
free(mix_channel);
mix_channel = NULL;
781
782
783
784
785
786
787
788
}
--audio_opened;
}
}
/* Pause a particular channel (or all) */
void Mix_Pause(int which)
{
789
Uint32 sdl_ticks = SDL_GetTicks();
790
791
792
if ( which == -1 ) {
int i;
793
for ( i=0; i<num_channels; ++i ) {
794
795
if ( mix_channel[i].playing > 0 ) {
mix_channel[i].paused = sdl_ticks;
796
797
798
}
}
} else {
799
800
if ( mix_channel[which].playing > 0 ) {
mix_channel[which].paused = sdl_ticks;
801
802
803
804
805
806
807
}
}
}
/* Resume a paused channel */
void Mix_Resume(int which)
{
808
Uint32 sdl_ticks = SDL_GetTicks();
809
810
811
if ( which == -1 ) {
int i;
812
SDL_mutexP(mixer_lock);
813
for ( i=0; i<num_channels; ++i ) {
814
815
816
817
if ( mix_channel[i].playing > 0 ) {
if(mix_channel[i].expire > 0)
mix_channel[i].expire += sdl_ticks - mix_channel[i].paused;
mix_channel[i].paused = 0;
818
819
}
}
820
SDL_mutexV(mixer_lock);
821
} else {
822
SDL_mutexP(mixer_lock);
823
824
825
826
if ( mix_channel[which].playing > 0 ) {
if(mix_channel[which].expire > 0)
mix_channel[which].expire += sdl_ticks - mix_channel[which].paused;
mix_channel[which].paused = 0;
827
}
828
SDL_mutexV(mixer_lock);
829
830
}
}
831
832
833
int Mix_Paused(int which)
{
834
if ( which > num_channels )
835
return(0);
836
837
838
839
if ( which < 0 ) {
int status = 0;
int i;
for( i=0; i < num_channels; ++i ) {
840
if ( mix_channel[i].paused ) {
841
842
843
844
845
++ status;
}
}
return(status);
} else {
846
return(mix_channel[which].paused != 0);
847
}
848
849
}
850
851
852
853
854
855
856
/* Change the group of a channel */
int Mix_GroupChannel(int which, int tag)
{
if ( which < 0 || which > num_channels )
return(0);
SDL_mutexP(mixer_lock);
857
mix_channel[which].tag = tag;
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
SDL_mutexV(mixer_lock);
return(1);
}
/* Assign several consecutive channels to a group */
int Mix_GroupChannels(int from, int to, int tag)
{
int status = 0;
for( ; from <= to; ++ from ) {
status += Mix_GroupChannel(from, tag);
}
return(status);
}
/* Finds the first available channel in a group of channels */
int Mix_GroupAvailable(int tag)
{
int i;
for( i=0; i < num_channels; i ++ ) {
877
878
if ( ((tag == -1) || (tag == mix_channel[i].tag)) &&
(mix_channel[i].playing <= 0) )
879
880
881
882
883
884
885
886
887
888
return i;
}
return(-1);
}
int Mix_GroupCount(int tag)
{
int count = 0;
int i;
for( i=0; i < num_channels; i ++ ) {
889
if ( mix_channel[i].tag==tag || tag==-1 )
890
891
892
893
++ count;
}
return(count);
}
894
895
896
897
898
899
900
901
/* Finds the "oldest" sample playing in a group of channels */
int Mix_GroupOldest(int tag)
{
int chan = -1;
Uint32 mintime = SDL_GetTicks();
int i;
for( i=0; i < num_channels; i ++ ) {
902
903
904
if ( (mix_channel[i].tag==tag || tag==-1) && mix_channel[i].playing > 0
&& mix_channel[i].start_time <= mintime ) {
mintime = mix_channel[i].start_time;
905
906
907
908
909
910
911
912
913
914
915
916
917
chan = i;
}
}
return(chan);
}
/* Finds the "most recent" (i.e. last) sample playing in a group of channels */
int Mix_GroupNewer(int tag)
{
int chan = -1;
Uint32 maxtime = 0;
int i;
for( i=0; i < num_channels; i ++ ) {
918
919
920
if ( (mix_channel[i].tag==tag || tag==-1) && mix_channel[i].playing > 0
&& mix_channel[i].start_time >= maxtime ) {
maxtime = mix_channel[i].start_time;
921
922
923
924
925
chan = i;
}
}
return(chan);
}