/
mixer.c
1566 lines (1379 loc) · 43.2 KB
1
/*
2
SDL_mixer: An audio mixer library based on the SDL library
3
Copyright (C) 1997-2017 Sam Lantinga <slouken@libsdl.org>
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.
Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not
claim that you wrote the original software. If you use this software
in a product, an acknowledgment in the product documentation would be
appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be
misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.
20
21
*/
22
/* $Id$ */
23
24
25
26
27
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
28
#include "SDL.h"
29
30
#include "SDL_mixer.h"
31
#include "mixer.h"
32
33
#include "load_aiff.h"
#include "load_voc.h"
34
#include "load_mp3.h"
35
#include "load_ogg.h"
36
#include "load_flac.h"
37
#include "dynamic_flac.h"
38
#include "dynamic_fluidsynth.h"
39
#include "dynamic_modplug.h"
40
41
42
#include "dynamic_mod.h"
#include "dynamic_mp3.h"
#include "dynamic_ogg.h"
43
44
45
46
#define __MIX_INTERNAL_EFFECT__
#include "effects_internal.h"
47
/* Magic numbers for various audio file formats */
48
49
50
51
52
53
#define RIFF 0x46464952 /* "RIFF" */
#define WAVE 0x45564157 /* "WAVE" */
#define FORM 0x4d524f46 /* "FORM" */
#define OGGS 0x5367674f /* "OggS" */
#define CREA 0x61657243 /* "Crea" */
#define FLAC 0x43614C66 /* "fLaC" */
54
55
56
static int audio_opened = 0;
static SDL_AudioSpec mixer;
57
static SDL_AudioDeviceID audio_device;
58
59
60
typedef struct _Mix_effectinfo
{
61
62
63
64
Mix_EffectFunc_t callback;
Mix_EffectDone_t done_callback;
void *udata;
struct _Mix_effectinfo *next;
65
66
} effect_info;
67
static struct _Mix_Channel {
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
Mix_Chunk *chunk;
int playing;
int paused;
Uint8 *samples;
int volume;
int looping;
int tag;
Uint32 expire;
Uint32 start_time;
Mix_Fading fading;
int fade_volume;
int fade_volume_reset;
Uint32 fade_length;
Uint32 ticks_fade;
effect_info *effects;
83
} *mix_channel = NULL;
84
85
86
static effect_info *posteffects = NULL;
87
static int num_channels;
88
static int reserved_channels = 0;
89
90
91
92
/* Support for hooking into the mixer callback system */
static void (*mix_postmix)(void *udata, Uint8 *stream, int len) = NULL;
93
static void *mix_postmix_data = NULL;
94
95
96
97
/* rcg07062001 callback to alert when channels are done playing. */
static void (*channel_done_callback)(int channel) = NULL;
98
99
100
101
/* Music function declarations */
extern int open_music(SDL_AudioSpec *mixer);
extern void close_music(void);
102
/* Support for user defined music functions, plus the default one */
103
extern int volatile music_active;
104
105
extern void music_mixer(void *udata, Uint8 *stream, int len);
static void (*mix_music)(void *udata, Uint8 *stream, int len) = music_mixer;
106
static void *music_data = NULL;
107
108
109
110
111
/* rcg06042009 report available decoders at runtime. */
static const char **chunk_decoders = NULL;
static int num_decoders = 0;
112
113
114
115
116
/* Semicolon-separated SoundFont paths */
#ifdef MID_MUSIC
extern char* soundfont_paths;
#endif
117
int Mix_GetNumChunkDecoders(void)
118
{
119
return(num_decoders);
120
121
122
123
}
const char *Mix_GetChunkDecoder(int index)
{
124
125
126
127
if ((index < 0) || (index >= num_decoders)) {
return NULL;
}
return(chunk_decoders[index]);
128
129
130
131
}
static void add_chunk_decoder(const char *decoder)
{
132
void *ptr = SDL_realloc((void *)chunk_decoders, (num_decoders + 1) * sizeof (const char *));
133
134
135
136
137
if (ptr == NULL) {
return; /* oh well, go on without it. */
}
chunk_decoders = (const char **) ptr;
chunk_decoders[num_decoders++] = decoder;
138
}
139
140
141
142
/* rcg06192001 get linked library's version. */
const SDL_version *Mix_Linked_Version(void)
{
143
144
145
static SDL_version linked_version;
SDL_MIXER_VERSION(&linked_version);
return(&linked_version);
146
147
}
148
149
150
151
static int initialized = 0;
int Mix_Init(int flags)
{
152
int result = 0;
153
154
if (flags & MIX_INIT_FLUIDSYNTH) {
155
#ifdef USE_FLUIDSYNTH_MIDI
156
157
158
if ((initialized & MIX_INIT_FLUIDSYNTH) || Mix_InitFluidSynth() == 0) {
result |= MIX_INIT_FLUIDSYNTH;
}
159
#else
160
Mix_SetError("Mixer not built with FluidSynth support");
161
#endif
162
163
}
if (flags & MIX_INIT_FLAC) {
164
#ifdef FLAC_MUSIC
165
166
167
if ((initialized & MIX_INIT_FLAC) || Mix_InitFLAC() == 0) {
result |= MIX_INIT_FLAC;
}
168
#else
169
Mix_SetError("Mixer not built with FLAC support");
170
171
172
173
174
175
176
177
178
#endif
}
if (flags & MIX_INIT_MODPLUG) {
#ifdef MODPLUG_MUSIC
if ((initialized & MIX_INIT_MODPLUG) || Mix_InitModPlug() == 0) {
result |= MIX_INIT_MODPLUG;
}
#else
Mix_SetError("Mixer not built with MOD modplug support");
179
#endif
180
181
}
if (flags & MIX_INIT_MOD) {
182
#ifdef MOD_MUSIC
183
184
185
if ((initialized & MIX_INIT_MOD) || Mix_InitMOD() == 0) {
result |= MIX_INIT_MOD;
}
186
#else
187
Mix_SetError("Mixer not built with MOD mikmod support");
188
#endif
189
190
}
if (flags & MIX_INIT_MP3) {
191
#ifdef MP3_MUSIC
192
193
194
if ((initialized & MIX_INIT_MP3) || Mix_InitMP3() == 0) {
result |= MIX_INIT_MP3;
}
195
196
#elif defined(MP3_MAD_MUSIC)
result |= MIX_INIT_MP3;
197
#else
198
Mix_SetError("Mixer not built with MP3 support");
199
#endif
200
201
}
if (flags & MIX_INIT_OGG) {
202
#ifdef OGG_MUSIC
203
204
205
if ((initialized & MIX_INIT_OGG) || Mix_InitOgg() == 0) {
result |= MIX_INIT_OGG;
}
206
#else
207
Mix_SetError("Mixer not built with Ogg Vorbis support");
208
#endif
209
210
}
initialized |= result;
211
212
return (result);
213
214
215
216
}
void Mix_Quit()
{
217
#ifdef USE_FLUIDSYNTH_MIDI
218
219
220
if (initialized & MIX_INIT_FLUIDSYNTH) {
Mix_QuitFluidSynth();
}
221
#endif
222
#ifdef FLAC_MUSIC
223
224
225
if (initialized & MIX_INIT_FLAC) {
Mix_QuitFLAC();
}
226
#endif
227
228
229
230
231
#ifdef MODPLUG_MUSIC
if (initialized & MIX_INIT_MODPLUG) {
Mix_QuitModPlug();
}
#endif
232
#ifdef MOD_MUSIC
233
234
235
if (initialized & MIX_INIT_MOD) {
Mix_QuitMOD();
}
236
237
#endif
#ifdef MP3_MUSIC
238
239
240
if (initialized & MIX_INIT_MP3) {
Mix_QuitMP3();
}
241
242
#endif
#ifdef OGG_MUSIC
243
244
245
if (initialized & MIX_INIT_OGG) {
Mix_QuitOgg();
}
246
#endif
247
#ifdef MID_MUSIC
248
249
if (soundfont_paths) {
SDL_free(soundfont_paths);
250
soundfont_paths = NULL;
251
}
252
#endif
253
initialized = 0;
254
255
}
256
static int _Mix_remove_all_effects(int channel, effect_info **e);
257
258
259
/*
* rcg06122001 Cleanup effect callbacks.
260
* MAKE SURE Mix_LockAudio() is called before this (or you're in the
261
262
263
* audio callback).
*/
static void _Mix_channel_done_playing(int channel)
264
{
265
266
267
268
269
270
271
272
273
if (channel_done_callback) {
channel_done_callback(channel);
}
/*
* Call internal function directly, to avoid locking audio from
* inside audio callback.
*/
_Mix_remove_all_effects(channel, &mix_channel[channel].effects);
274
275
276
277
278
}
static void *Mix_DoEffects(int chan, void *snd, int len)
{
279
280
281
282
283
284
285
286
287
288
289
int posteffect = (chan == MIX_CHANNEL_POST);
effect_info *e = ((posteffect) ? posteffects : mix_channel[chan].effects);
void *buf = snd;
if (e != NULL) { /* are there any registered effects? */
/* if this is the postmix, we can just overwrite the original. */
if (!posteffect) {
buf = SDL_malloc(len);
if (buf == NULL) {
return(snd);
}
290
SDL_memcpy(buf, snd, len);
291
292
293
294
295
296
297
298
299
300
301
}
for (; e != NULL; e = e->next) {
if (e->callback != NULL) {
e->callback(chan, buf, len, e->udata);
}
}
}
/* be sure to SDL_free() the return value if != snd ... */
return(buf);
302
303
304
}
305
306
307
/* Mixing function */
static void mix_channels(void *udata, Uint8 *stream, int len)
{
308
309
310
Uint8 *mix_input;
int i, mixable, volume = SDL_MIX_MAXVOLUME;
Uint32 sdl_ticks;
311
312
#if SDL_VERSION_ATLEAST(1, 3, 0)
313
/* Need to initialize the stream in SDL 1.3+ */
314
SDL_memset(stream, mixer.silence, len);
315
#endif
316
317
318
319
320
321
322
323
324
/* Mix the music (must be done before the channels are added) */
if ( music_active || (mix_music != music_mixer) ) {
mix_music(music_data, stream, len);
}
/* Mix any playing channels... */
sdl_ticks = SDL_GetTicks();
for ( i=0; i<num_channels; ++i ) {
325
if ( !mix_channel[i].paused ) {
326
327
328
329
330
331
332
333
334
if ( mix_channel[i].expire > 0 && mix_channel[i].expire < sdl_ticks ) {
/* Expiration delay for that channel is reached */
mix_channel[i].playing = 0;
mix_channel[i].looping = 0;
mix_channel[i].fading = MIX_NO_FADING;
mix_channel[i].expire = 0;
_Mix_channel_done_playing(i);
} else if ( mix_channel[i].fading != MIX_NO_FADING ) {
Uint32 ticks = sdl_ticks - mix_channel[i].ticks_fade;
335
if ( ticks >= mix_channel[i].fade_length ) {
336
337
338
339
340
341
342
343
344
Mix_Volume(i, mix_channel[i].fade_volume_reset); /* Restore the volume */
if( mix_channel[i].fading == MIX_FADING_OUT ) {
mix_channel[i].playing = 0;
mix_channel[i].looping = 0;
mix_channel[i].expire = 0;
_Mix_channel_done_playing(i);
}
mix_channel[i].fading = MIX_NO_FADING;
} else {
345
if ( mix_channel[i].fading == MIX_FADING_OUT ) {
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
Mix_Volume(i, (mix_channel[i].fade_volume * (mix_channel[i].fade_length-ticks))
/ mix_channel[i].fade_length );
} else {
Mix_Volume(i, (mix_channel[i].fade_volume * ticks) / mix_channel[i].fade_length );
}
}
}
if ( mix_channel[i].playing > 0 ) {
int index = 0;
int remaining = len;
while (mix_channel[i].playing > 0 && index < len) {
remaining = len - index;
volume = (mix_channel[i].volume*mix_channel[i].chunk->volume) / MIX_MAX_VOLUME;
mixable = mix_channel[i].playing;
if ( mixable > remaining ) {
mixable = remaining;
}
mix_input = Mix_DoEffects(i, mix_channel[i].samples, mixable);
365
SDL_MixAudioFormat(stream+index,mix_input,mixer.format,mixable,volume);
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
if (mix_input != mix_channel[i].samples)
SDL_free(mix_input);
mix_channel[i].samples += mixable;
mix_channel[i].playing -= mixable;
index += mixable;
/* rcg06072001 Alert app if channel is done playing. */
if (!mix_channel[i].playing && !mix_channel[i].looping) {
_Mix_channel_done_playing(i);
}
}
/* If looping the sample and we are at its end, make sure
we will still return a full buffer */
while ( mix_channel[i].looping && index < len ) {
int alen = mix_channel[i].chunk->alen;
remaining = len - index;
if (remaining > alen) {
remaining = alen;
}
mix_input = Mix_DoEffects(i, mix_channel[i].chunk->abuf, remaining);
389
SDL_MixAudioFormat(stream+index, mix_input, mixer.format, remaining, volume);
390
391
392
if (mix_input != mix_channel[i].chunk->abuf)
SDL_free(mix_input);
393
394
395
if (mix_channel[i].looping > 0) {
--mix_channel[i].looping;
}
396
397
398
399
400
mix_channel[i].samples = mix_channel[i].chunk->abuf + remaining;
mix_channel[i].playing = mix_channel[i].chunk->alen - remaining;
index += remaining;
}
if ( ! mix_channel[i].playing && mix_channel[i].looping ) {
401
402
403
if (mix_channel[i].looping > 0) {
--mix_channel[i].looping;
}
404
405
406
407
408
409
410
411
412
413
414
415
416
mix_channel[i].samples = mix_channel[i].chunk->abuf;
mix_channel[i].playing = mix_channel[i].chunk->alen;
}
}
}
}
/* rcg06122001 run posteffects... */
Mix_DoEffects(MIX_CHANNEL_POST, stream, len);
if ( mix_postmix ) {
mix_postmix(mix_postmix_data, stream, len);
}
417
418
}
419
#if 0
420
421
static void PrintFormat(char *title, SDL_AudioSpec *fmt)
{
422
423
424
425
printf("%s: %d bit %s audio (%s) at %u Hz\n", title, (fmt->format&0xFF),
(fmt->format&0x8000) ? "signed" : "unsigned",
(fmt->channels > 2) ? "surround" :
(fmt->channels > 1) ? "stereo" : "mono", fmt->freq);
426
}
427
#endif
428
429
/* Open the mixer with a certain desired audio format */
430
431
int Mix_OpenAudioDevice(int frequency, Uint16 format, int nchannels, int chunksize,
const char* device, int allowed_changes)
432
{
433
434
435
int i;
SDL_AudioSpec desired;
436
437
438
439
440
441
442
443
444
/* This used to call SDL_OpenAudio(), which initializes the audio
subsystem if necessary. Since SDL_OpenAudioDevice() doesn't,
we have to handle this case here. */
if (!SDL_WasInit(SDL_INIT_AUDIO)) {
if (SDL_InitSubSystem(SDL_INIT_AUDIO) < 0) {
return -1;
}
}
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
/* If the mixer is already opened, increment open count */
if ( audio_opened ) {
if ( format == mixer.format && nchannels == mixer.channels ) {
++audio_opened;
return(0);
}
while ( audio_opened ) {
Mix_CloseAudio();
}
}
/* Set the desired format and frequency */
desired.freq = frequency;
desired.format = format;
desired.channels = nchannels;
desired.samples = chunksize;
desired.callback = mix_channels;
desired.userdata = NULL;
/* Accept nearly any audio format */
465
if ( (audio_device = SDL_OpenAudioDevice(device, 0, &desired, &mixer, allowed_changes)) == 0 ) {
466
467
return(-1);
}
468
#if 0
469
PrintFormat("Audio device", &mixer);
470
471
#endif
472
473
/* Initialize the music players */
if ( open_music(&mixer) < 0 ) {
474
SDL_CloseAudioDevice(audio_device);
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
return(-1);
}
num_channels = MIX_CHANNELS;
mix_channel = (struct _Mix_Channel *) SDL_malloc(num_channels * sizeof(struct _Mix_Channel));
/* Clear out the audio channels */
for ( i=0; i<num_channels; ++i ) {
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].fade_volume = SDL_MIX_MAXVOLUME;
mix_channel[i].fade_volume_reset = SDL_MIX_MAXVOLUME;
mix_channel[i].fading = MIX_NO_FADING;
mix_channel[i].tag = -1;
mix_channel[i].expire = 0;
mix_channel[i].effects = NULL;
mix_channel[i].paused = 0;
}
Mix_VolumeMusic(SDL_MIX_MAXVOLUME);
_Mix_InitEffects();
/* This list is (currently) decided at build time. */
add_chunk_decoder("WAVE");
add_chunk_decoder("AIFF");
add_chunk_decoder("VOC");
503
#ifdef OGG_MUSIC
504
add_chunk_decoder("OGG");
505
506
#endif
#ifdef FLAC_MUSIC
507
add_chunk_decoder("FLAC");
508
#endif
509
510
511
#if defined(MP3_MUSIC) || defined(MP3_MAD_MUSIC)
add_chunk_decoder("MP3");
#endif
512
513
audio_opened = 1;
514
SDL_PauseAudioDevice(audio_device, 0);
515
return(0);
516
517
}
518
519
520
521
522
523
524
/* Open the mixer with a certain desired audio format */
int Mix_OpenAudio(int frequency, Uint16 format, int nchannels, int chunksize)
{
return Mix_OpenAudioDevice(frequency, format, nchannels, chunksize,
NULL, SDL_AUDIO_ALLOW_ANY_CHANGE);
}
525
526
527
528
529
530
/* 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)
{
531
532
533
534
535
536
537
538
539
540
541
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_UnregisterAllEffects(i);
Mix_HaltChannel(i);
}
}
542
Mix_LockAudio();
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
mix_channel = (struct _Mix_Channel *) SDL_realloc(mix_channel, numchans * sizeof(struct _Mix_Channel));
if ( numchans > num_channels ) {
/* Initialize the new channels */
int i;
for(i=num_channels; i < numchans; i++) {
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].fade_volume = SDL_MIX_MAXVOLUME;
mix_channel[i].fade_volume_reset = SDL_MIX_MAXVOLUME;
mix_channel[i].fading = MIX_NO_FADING;
mix_channel[i].tag = -1;
mix_channel[i].expire = 0;
mix_channel[i].effects = NULL;
mix_channel[i].paused = 0;
}
}
num_channels = numchans;
562
Mix_UnlockAudio();
563
return(num_channels);
564
565
}
566
567
568
/* Return the actual mixer parameters */
int Mix_QuerySpec(int *frequency, Uint16 *format, int *channels)
{
569
570
571
572
573
574
575
576
577
578
579
580
if ( audio_opened ) {
if ( frequency ) {
*frequency = mixer.freq;
}
if ( format ) {
*format = mixer.format;
}
if ( channels ) {
*channels = mixer.channels;
}
}
return(audio_opened);
581
582
}
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
static int detect_mp3(Uint8 *magic)
{
if ( strncmp((char *)magic, "ID3", 3) == 0 ) {
return 1;
}
/* Detection code lifted from SMPEG */
if(((magic[0] & 0xff) != 0xff) || // No sync bits
((magic[1] & 0xf0) != 0xf0) || //
((magic[2] & 0xf0) == 0x00) || // Bitrate is 0
((magic[2] & 0xf0) == 0xf0) || // Bitrate is 15
((magic[2] & 0x0c) == 0x0c) || // Frequency is 3
((magic[1] & 0x06) == 0x00)) { // Layer is 4
return(0);
}
return 1;
}
600
601
602
603
/* Load a wave file */
Mix_Chunk *Mix_LoadWAV_RW(SDL_RWops *src, int freesrc)
{
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
Uint32 magic;
Mix_Chunk *chunk;
SDL_AudioSpec wavespec, *loaded;
SDL_AudioCVT wavecvt;
int samplesize;
/* rcg06012001 Make sure src is valid */
if ( ! src ) {
SDL_SetError("Mix_LoadWAV_RW with NULL src");
return(NULL);
}
/* Make sure audio has been opened */
if ( ! audio_opened ) {
SDL_SetError("Audio device hasn't been opened");
619
if ( freesrc ) {
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
SDL_RWclose(src);
}
return(NULL);
}
/* Allocate the chunk memory */
chunk = (Mix_Chunk *)SDL_malloc(sizeof(Mix_Chunk));
if ( chunk == NULL ) {
SDL_SetError("Out of memory");
if ( freesrc ) {
SDL_RWclose(src);
}
return(NULL);
}
/* Find out what kind of audio file this is */
magic = SDL_ReadLE32(src);
/* Seek backwards for compatibility with older loaders */
SDL_RWseek(src, -(int)sizeof(Uint32), RW_SEEK_CUR);
switch (magic) {
case WAVE:
case RIFF:
loaded = SDL_LoadWAV_RW(src, freesrc, &wavespec,
(Uint8 **)&chunk->abuf, &chunk->alen);
break;
case FORM:
loaded = Mix_LoadAIFF_RW(src, freesrc, &wavespec,
(Uint8 **)&chunk->abuf, &chunk->alen);
break;
650
#ifdef OGG_MUSIC
651
652
653
654
case OGGS:
loaded = Mix_LoadOGG_RW(src, freesrc, &wavespec,
(Uint8 **)&chunk->abuf, &chunk->alen);
break;
655
656
#endif
#ifdef FLAC_MUSIC
657
658
659
660
case FLAC:
loaded = Mix_LoadFLAC_RW(src, freesrc, &wavespec,
(Uint8 **)&chunk->abuf, &chunk->alen);
break;
661
#endif
662
663
664
665
666
case CREA:
loaded = Mix_LoadVOC_RW(src, freesrc, &wavespec,
(Uint8 **)&chunk->abuf, &chunk->alen);
break;
default:
667
668
669
670
671
672
673
674
675
676
#if defined(MP3_MUSIC) || defined(MP3_MAD_MUSIC)
if (detect_mp3((Uint8*)&magic))
{
/* note: send a copy of the mixer spec */
wavespec = mixer;
loaded = Mix_LoadMP3_RW(src, freesrc, &wavespec,
(Uint8 **)&chunk->abuf, &chunk->alen);
break;
}
#endif
677
678
679
680
681
682
683
684
685
686
687
688
SDL_SetError("Unrecognized sound file type");
if ( freesrc ) {
SDL_RWclose(src);
}
loaded = NULL;
break;
}
if ( !loaded ) {
/* The individual loaders have closed src if needed */
SDL_free(chunk);
return(NULL);
}
689
690
#if 0
691
692
PrintFormat("Audio device", &mixer);
PrintFormat("-- Wave file", &wavespec);
693
694
#endif
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
/* Build the audio converter and create conversion buffers */
if ( wavespec.format != mixer.format ||
wavespec.channels != mixer.channels ||
wavespec.freq != mixer.freq ) {
if ( SDL_BuildAudioCVT(&wavecvt,
wavespec.format, wavespec.channels, wavespec.freq,
mixer.format, mixer.channels, mixer.freq) < 0 ) {
SDL_free(chunk->abuf);
SDL_free(chunk);
return(NULL);
}
samplesize = ((wavespec.format & 0xFF)/8)*wavespec.channels;
wavecvt.len = chunk->alen & ~(samplesize-1);
wavecvt.buf = (Uint8 *)SDL_calloc(1, wavecvt.len*wavecvt.len_mult);
if ( wavecvt.buf == NULL ) {
SDL_SetError("Out of memory");
SDL_free(chunk->abuf);
SDL_free(chunk);
return(NULL);
}
715
SDL_memcpy(wavecvt.buf, chunk->abuf, chunk->alen);
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
SDL_free(chunk->abuf);
/* Run the audio converter */
if ( SDL_ConvertAudio(&wavecvt) < 0 ) {
SDL_free(wavecvt.buf);
SDL_free(chunk);
return(NULL);
}
chunk->abuf = wavecvt.buf;
chunk->alen = wavecvt.len_cvt;
}
chunk->allocated = 1;
chunk->volume = MIX_MAX_VOLUME;
return(chunk);
733
734
}
735
736
737
/* Load a wave file of the mixer format from a memory buffer */
Mix_Chunk *Mix_QuickLoad_WAV(Uint8 *mem)
{
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
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 *)SDL_calloc(1,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 {
758
SDL_memcpy(magic, mem, 4);
759
760
761
762
763
764
765
766
767
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);
768
769
}
770
771
772
/* Load raw audio data of the mixer format from a memory buffer */
Mix_Chunk *Mix_QuickLoad_RAW(Uint8 *mem, Uint32 len)
{
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
Mix_Chunk *chunk;
/* 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 *)SDL_malloc(sizeof(Mix_Chunk));
if ( chunk == NULL ) {
SDL_SetError("Out of memory");
return(NULL);
}
/* Essentially just point at the audio data (no error checking - fast) */
chunk->allocated = 0;
chunk->alen = len;
chunk->abuf = mem;
chunk->volume = MIX_MAX_VOLUME;
return(chunk);
795
796
}
797
798
799
/* Free an audio chunk previously loaded */
void Mix_FreeChunk(Mix_Chunk *chunk)
{
800
801
802
803
804
int i;
/* Caution -- if the chunk is playing, the mixer will crash */
if ( chunk ) {
/* Guarantee that this chunk isn't playing */
805
Mix_LockAudio();
806
807
808
809
810
811
812
813
if ( mix_channel ) {
for ( i=0; i<num_channels; ++i ) {
if ( chunk == mix_channel[i].chunk ) {
mix_channel[i].playing = 0;
mix_channel[i].looping = 0;
}
}
}
814
Mix_UnlockAudio();
815
816
817
818
819
820
/* Actually free the chunk */
if ( chunk->allocated ) {
SDL_free(chunk->abuf);
}
SDL_free(chunk);
}
821
822
}
823
824
825
826
827
828
829
/* 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)
{
830
Mix_LockAudio();
831
832
mix_postmix_data = arg;
mix_postmix = mix_func;
833
Mix_UnlockAudio();
834
835
}
836
837
838
839
840
841
/* 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)
{
842
Mix_LockAudio();
843
844
845
846
847
848
849
if ( mix_func != NULL ) {
music_data = arg;
mix_music = mix_func;
} else {
music_data = NULL;
mix_music = music_mixer;
}
850
Mix_UnlockAudio();
851
852
853
854
}
void *Mix_GetMusicHookData(void)
{
855
return(music_data);
856
857
}
858
859
void Mix_ChannelFinished(void (*channel_finished)(int channel))
{
860
Mix_LockAudio();
861
channel_done_callback = channel_finished;
862
Mix_UnlockAudio();
863
864
865
}
866
867
868
869
870
871
/* 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)
{
872
873
874
875
if (num > num_channels)
num = num_channels;
reserved_channels = num;
return num;
876
877
}
878
879
static int checkchunkintegral(Mix_Chunk *chunk)
{
880
int frame_width = 1;
881
882
883
884
885
if ((mixer.format & 0xFF) == 16) frame_width = 2;
frame_width *= mixer.channels;
while (chunk->alen % frame_width) chunk->alen--;
return chunk->alen;
886
887
}
888
889
/* Play an audio chunk on a specific channel.
If the specified channel is -1, play on the first free channel.
890
891
'ticks' is the number of milliseconds at most to play the sample, or -1
if there is no limit.
892
893
Returns which channel was used to play the sound.
*/
894
int Mix_PlayChannelTimed(int which, Mix_Chunk *chunk, int loops, int ticks)
895
{
896
897
898
899
900
901
902
903
904
905
906
907
908
int i;
/* Don't play null pointers :-) */
if ( chunk == NULL ) {
Mix_SetError("Tried to play a NULL chunk");
return(-1);
}
if ( !checkchunkintegral(chunk)) {
Mix_SetError("Tried to play a chunk with a bad frame");
return(-1);
}
/* Lock the mixer while modifying the playing channels */
909
Mix_LockAudio();
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
{
/* If which is -1, play on the first free channel */
if ( which == -1 ) {
for ( i=reserved_channels; i<num_channels; ++i ) {
if ( mix_channel[i].playing <= 0 )
break;
}
if ( i == num_channels ) {
Mix_SetError("No free channels available");
which = -1;
} else {
which = i;
}
}
/* Queue up the audio data for this channel */
if ( which >= 0 && which < num_channels ) {
Uint32 sdl_ticks = SDL_GetTicks();
if (Mix_Playing(which))
_Mix_channel_done_playing(which);
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;
}
}
940
Mix_UnlockAudio();
941
942
943
/* Return the channel on which the sound is being played */
return(which);
944
945
}
946
947
948
/* Change the expiration delay for a channel */
int Mix_ExpireChannel(int which, int ticks)
{
949
950
951
952
953
954
955
956
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 ) {
957
Mix_LockAudio();
958
mix_channel[which].expire = (ticks>0) ? (SDL_GetTicks() + ticks) : 0;
959
Mix_UnlockAudio();
960
961
962
++ status;
}
return(status);
963
964
}
965
/* Fade in a sound on a channel, over ms milliseconds */
966
int Mix_FadeInChannelTimed(int which, Mix_Chunk *chunk, int loops, int ms, int ticks)
967
{
968
969
970
971
972
973
974
975
976
977
978
979
int i;
/* Don't play null pointers :-) */
if ( chunk == NULL ) {
return(-1);
}
if ( !checkchunkintegral(chunk)) {
Mix_SetError("Tried to play a chunk with a bad frame");
return(-1);
}
/* Lock the mixer while modifying the playing channels */
980
Mix_LockAudio();
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
{
/* If which is -1, play on the first free channel */
if ( which == -1 ) {
for ( i=reserved_channels; i<num_channels; ++i ) {
if ( mix_channel[i].playing <= 0 )
break;
}
if ( i == num_channels ) {
which = -1;
} else {
which = i;
}
}
/* Queue up the audio data for this channel */
if ( which >= 0 && which < num_channels ) {
Uint32 sdl_ticks = SDL_GetTicks();
if (Mix_Playing(which))
_Mix_channel_done_playing(which);
mix_channel[which].samples = chunk->abuf;