/
playwave.c
508 lines (422 loc) · 13.5 KB
1
/*
2
PLAYWAVE: A test application for the SDL mixer library.
3
Copyright (C) 1997-2019 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
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
27
28
#ifdef unix
29
30
31
#include <unistd.h>
#endif
32
#include "SDL.h"
33
#include "SDL_mixer.h"
34
35
36
37
38
#ifdef HAVE_SIGNAL_H
#include <signal.h>
#endif
39
40
41
42
/*
* rcg06132001 various mixer tests. Define the ones you want.
*/
43
/*#define TEST_MIX_DECODERS*/
44
45
/*#define TEST_MIX_VERSIONS*/
/*#define TEST_MIX_CHANNELFINISHED*/
46
47
/*#define TEST_MIX_PANNING*/
/*#define TEST_MIX_DISTANCE*/
48
/*#define TEST_MIX_POSITION*/
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
#if (defined TEST_MIX_POSITION)
#if (defined TEST_MIX_PANNING)
#error TEST_MIX_POSITION interferes with TEST_MIX_PANNING.
#endif
#if (defined TEST_MIX_DISTANCE)
#error TEST_MIX_POSITION interferes with TEST_MIX_DISTANCE.
#endif
#endif
/* rcg06192001 for debugging purposes. */
static void output_test_warnings(void)
{
#if (defined TEST_MIX_CHANNELFINISHED)
68
SDL_Log("Warning: TEST_MIX_CHANNELFINISHED is enabled in this binary...\n");
69
70
#endif
#if (defined TEST_MIX_PANNING)
71
SDL_Log("Warning: TEST_MIX_PANNING is enabled in this binary...\n");
72
73
#endif
#if (defined TEST_MIX_VERSIONS)
74
SDL_Log("Warning: TEST_MIX_VERSIONS is enabled in this binary...\n");
75
76
#endif
#if (defined TEST_MIX_DISTANCE)
77
SDL_Log("Warning: TEST_MIX_DISTANCE is enabled in this binary...\n");
78
79
#endif
#if (defined TEST_MIX_POSITION)
80
SDL_Log("Warning: TEST_MIX_POSITION is enabled in this binary...\n");
81
82
83
84
#endif
}
85
86
87
static int audio_open = 0;
static Mix_Chunk *wave = NULL;
88
89
90
91
/* rcg06042009 Report available decoders. */
#if (defined TEST_MIX_DECODERS)
static void report_decoders(void)
{
92
int i, total;
93
94
SDL_Log("Supported decoders...\n");
95
96
total = Mix_GetNumChunkDecoders();
for (i = 0; i < total; i++) {
97
SDL_Log(" - chunk decoder: %s\n", Mix_GetChunkDecoder(i));
98
99
100
101
}
total = Mix_GetNumMusicDecoders();
for (i = 0; i < total; i++) {
102
SDL_Log(" - music decoder: %s\n", Mix_GetMusicDecoder(i));
103
}
104
105
}
#endif
106
107
108
109
/* rcg06192001 Check new Mixer version API. */
#if (defined TEST_MIX_VERSIONS)
static void output_versions(const char *libname, const SDL_version *compiled,
110
const SDL_version *linked)
111
{
112
SDL_Log("This program was compiled against %s %d.%d.%d,\n"
113
114
115
" and is dynamically linked to %d.%d.%d.\n", libname,
compiled->major, compiled->minor, compiled->patch,
linked->major, linked->minor, linked->patch);
116
117
118
119
}
static void test_versions(void)
{
120
SDL_version compiled;
121
SDL_version linked;
122
123
SDL_VERSION(&compiled);
124
125
SDL_GetVersion(&linked);
output_versions("SDL", &compiled, &linked);
126
127
SDL_MIXER_VERSION(&compiled);
128
129
SDL_memcpy(&linked, Mix_Linked_Version(), sizeof(SDL_version));
output_versions("SDL_mixer", &compiled, &linked);
130
131
132
133
134
135
}
#endif
#ifdef TEST_MIX_CHANNELFINISHED /* rcg06072001 */
static volatile int channel_is_done = 0;
136
static void SDLCALL channel_complete_callback (int chan)
137
{
138
Mix_Chunk *done_chunk = Mix_GetChunk(chan);
139
SDL_Log("We were just alerted that Mixer channel #%d is done.\n", chan);
140
SDL_Log("Channel's chunk pointer is (%p).\n", (void*)done_chunk);
141
SDL_Log(" Which %s correct.\n", (wave == done_chunk) ? "is" : "is NOT");
142
channel_is_done = 1;
143
144
145
146
147
148
149
150
}
#endif
/* rcg06192001 abstract this out for testing purposes. */
static int still_playing(void)
{
#ifdef TEST_MIX_CHANNELFINISHED
151
return(!channel_is_done);
152
#else
153
return(Mix_Playing(0));
154
155
156
157
158
159
160
#endif
}
#if (defined TEST_MIX_PANNING)
static void do_panning_update(void)
{
161
162
static Uint8 leftvol = 128;
static Uint8 rightvol = 128;
163
164
static Sint8 leftincr = -1;
static Sint8 rightincr = 1;
165
166
167
168
169
170
static int panningok = 1;
static Uint32 next_panning_update = 0;
if ((panningok) && (SDL_GetTicks() >= next_panning_update)) {
panningok = Mix_SetPanning(0, leftvol, rightvol);
if (!panningok) {
171
SDL_Log("Mix_SetPanning(0, %d, %d) failed!\n",
172
(int) leftvol, (int) rightvol);
173
SDL_Log("Reason: [%s].\n", Mix_GetError());
174
175
176
}
if ((leftvol == 255) || (leftvol == 0)) {
177
if (leftvol == 255) {
178
SDL_Log("All the way in the left speaker.\n");
179
180
}
leftincr *= -1;
181
182
183
}
if ((rightvol == 255) || (rightvol == 0)) {
184
if (rightvol == 255) {
185
SDL_Log("All the way in the right speaker.\n");
186
}
187
188
189
190
191
192
193
rightincr *= -1;
}
leftvol += leftincr;
rightvol += rightincr;
next_panning_update = SDL_GetTicks() + 10;
}
194
195
196
197
198
199
200
}
#endif
#if (defined TEST_MIX_DISTANCE)
static void do_distance_update(void)
{
201
static Uint8 distance = 1;
202
static Sint8 distincr = 1;
203
204
205
206
207
208
static int distanceok = 1;
static Uint32 next_distance_update = 0;
if ((distanceok) && (SDL_GetTicks() >= next_distance_update)) {
distanceok = Mix_SetDistance(0, distance);
if (!distanceok) {
209
210
SDL_Log("Mix_SetDistance(0, %d) failed!\n", (int) distance);
SDL_Log("Reason: [%s].\n", Mix_GetError());
211
212
213
}
if (distance == 0) {
214
SDL_Log("Distance at nearest point.\n");
215
216
217
distincr *= -1;
}
else if (distance == 255) {
218
SDL_Log("Distance at furthest point.\n");
219
220
221
222
223
224
distincr *= -1;
}
distance += distincr;
next_distance_update = SDL_GetTicks() + 15;
}
225
226
227
228
229
230
231
}
#endif
#if (defined TEST_MIX_POSITION)
static void do_position_update(void)
{
232
233
static Sint16 distance = 1;
static Sint8 distincr = 1;
234
static Sint16 angle = 0;
235
236
237
238
239
static Sint8 angleincr = 1;
static int positionok = 1;
static Uint32 next_position_update = 0;
if ((positionok) && (SDL_GetTicks() >= next_position_update)) {
240
positionok = Mix_SetPosition(0, angle, (Uint8)distance);
241
if (!positionok) {
242
SDL_Log("Mix_SetPosition(0, %d, %d) failed!\n",
243
(int) angle, (int) distance);
244
SDL_Log("Reason: [%s].\n", Mix_GetError());
245
246
247
}
if (angle == 0) {
248
SDL_Log("Due north; now rotating clockwise...\n");
249
250
251
252
angleincr = 1;
}
else if (angle == 360) {
253
SDL_Log("Due north; now rotating counter-clockwise...\n");
254
255
256
257
258
259
260
angleincr = -1;
}
distance += distincr;
if (distance < 0) {
distance = 0;
distincr = 3;
261
SDL_Log("Distance is very, very near. Stepping away by threes...\n");
262
263
264
} else if (distance > 255) {
distance = 255;
distincr = -3;
265
SDL_Log("Distance is very, very far. Stepping towards by threes...\n");
266
267
268
269
270
}
angle += angleincr;
next_position_update = SDL_GetTicks() + 30;
}
271
272
273
274
}
#endif
275
static void CleanUp(int exitcode)
276
{
277
if (wave) {
278
279
280
Mix_FreeChunk(wave);
wave = NULL;
}
281
if (audio_open) {
282
283
284
285
286
287
Mix_CloseAudio();
audio_open = 0;
}
SDL_Quit();
exit(exitcode);
288
289
}
290
291
static void Usage(char *argv0)
292
{
293
SDL_Log("Usage: %s [-8] [-f32] [-r rate] [-c channels] [-f] [-F] [-l] [-m] <wavefile>\n", argv0);
294
}
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
/*
* rcg06182001 This is sick, but cool.
*
* Actually, it's meant to be an example of how to manipulate a voice
* without having to use the mixer effects API. This is more processing
* up front, but no extra during the mixing process. Also, in a case like
* this, when you need to touch the whole sample at once, it's the only
* option you've got. And, with the effects API, you are altering a copy of
* the original sample for each playback, and thus, your changes aren't
* permanent; here, you've got a reversed sample, and that's that until
* you either reverse it again, or reload it.
*/
static void flip_sample(Mix_Chunk *wave)
310
{
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
Uint16 format;
int channels, i, incr;
Uint8 *start = wave->abuf;
Uint8 *end = wave->abuf + wave->alen;
Mix_QuerySpec(NULL, &format, &channels);
incr = (format & 0xFF) * channels;
end -= incr;
switch (incr) {
case 8:
for (i = wave->alen / 2; i >= 0; i -= 1) {
Uint8 tmp = *start;
*start = *end;
*end = tmp;
start++;
end--;
}
break;
case 16:
for (i = wave->alen / 2; i >= 0; i -= 2) {
Uint16 tmp = *start;
*((Uint16 *) start) = *((Uint16 *) end);
*((Uint16 *) end) = tmp;
start += 2;
end -= 2;
}
break;
case 32:
for (i = wave->alen / 2; i >= 0; i -= 4) {
Uint32 tmp = *start;
*((Uint32 *) start) = *((Uint32 *) end);
*((Uint32 *) end) = tmp;
start += 4;
end -= 4;
}
break;
default:
353
SDL_Log("Unhandled format in sample flipping.\n");
354
355
return;
}
356
357
358
}
359
int main(int argc, char *argv[])
360
{
361
362
363
364
365
366
367
int audio_rate;
Uint16 audio_format;
int audio_channels;
int loops = 0;
int i;
int reverse_stereo = 0;
int reverse_sample = 0;
368
369
370
(void) argc;
371
#ifdef HAVE_SETBUF
372
373
setbuf(stdout, NULL); /* rcg06132001 for debugging purposes. */
setbuf(stderr, NULL); /* rcg06192001 for debugging purposes, too. */
374
#endif
375
376
377
378
379
output_test_warnings();
/* Initialize variables */
audio_rate = MIX_DEFAULT_FREQUENCY;
audio_format = MIX_DEFAULT_FORMAT;
380
audio_channels = MIX_DEFAULT_CHANNELS;
381
382
/* Check command line usage */
383
384
for (i=1; argv[i] && (*argv[i] == '-'); ++i) {
if ((strcmp(argv[i], "-r") == 0) && argv[i+1]) {
385
386
387
++i;
audio_rate = atoi(argv[i]);
} else
388
if (strcmp(argv[i], "-m") == 0) {
389
390
audio_channels = 1;
} else
391
if ((strcmp(argv[i], "-c") == 0) && argv[i+1]) {
392
393
394
++i;
audio_channels = atoi(argv[i]);
} else
395
if (strcmp(argv[i], "-l") == 0) {
396
397
loops = -1;
} else
398
if (strcmp(argv[i], "-8") == 0) {
399
400
audio_format = AUDIO_U8;
} else
401
if (strcmp(argv[i], "-f32") == 0) {
402
403
audio_format = AUDIO_F32;
} else
404
if (strcmp(argv[i], "-f") == 0) { /* rcg06122001 flip stereo */
405
406
reverse_stereo = 1;
} else
407
if (strcmp(argv[i], "-F") == 0) { /* rcg06172001 flip sample */
408
409
410
411
412
413
reverse_sample = 1;
} else {
Usage(argv[0]);
return(1);
}
}
414
if (! argv[i]) {
415
416
417
418
419
Usage(argv[0]);
return(1);
}
/* Initialize the SDL library */
420
421
if (SDL_Init(SDL_INIT_AUDIO) < 0) {
SDL_Log("Couldn't initialize SDL: %s\n",SDL_GetError());
422
423
return(255);
}
424
#ifdef HAVE_SIGNAL_H
425
426
signal(SIGINT, CleanUp);
signal(SIGTERM, CleanUp);
427
#endif
428
429
430
/* Open the audio device */
if (Mix_OpenAudio(audio_rate, audio_format, audio_channels, 4096) < 0) {
431
SDL_Log("Couldn't open audio: %s\n", SDL_GetError());
432
433
434
CleanUp(2);
} else {
Mix_QuerySpec(&audio_rate, &audio_format, &audio_channels);
435
SDL_Log("Opened audio at %d Hz %d bit%s %s", audio_rate,
436
(audio_format&0xFF),
437
(SDL_AUDIO_ISFLOAT(audio_format) ? " (float)" : ""),
438
439
(audio_channels > 2) ? "surround" :
(audio_channels > 1) ? "stereo" : "mono");
440
441
if (loops) {
SDL_Log(" (looping)\n");
442
443
444
445
446
} else {
putchar('\n');
}
}
audio_open = 1;
447
448
#if (defined TEST_MIX_VERSIONS)
449
test_versions();
450
451
#endif
452
#if (defined TEST_MIX_DECODERS)
453
report_decoders();
454
455
#endif
456
457
/* Load the requested wave file */
wave = Mix_LoadWAV(argv[i]);
458
459
if (wave == NULL) {
SDL_Log("Couldn't load %s: %s\n",
460
461
462
argv[i], SDL_GetError());
CleanUp(2);
}
463
464
465
466
if (reverse_sample) {
flip_sample(wave);
}
467
468
#ifdef TEST_MIX_CHANNELFINISHED /* rcg06072001 */
469
Mix_ChannelFinished(channel_complete_callback);
470
471
#endif
472
473
if ((!Mix_SetReverseStereo(MIX_CHANNEL_POST, reverse_stereo)) &&
(reverse_stereo))
474
{
475
476
SDL_Log("Failed to set up reverse stereo effect!\n");
SDL_Log("Reason: [%s].\n", Mix_GetError());
477
}
478
479
480
/* Play and then exit */
Mix_PlayChannel(0, wave, loops);
481
482
while (still_playing()) {
483
484
#if (defined TEST_MIX_PANNING) /* rcg06132001 */
485
do_panning_update();
486
487
#endif
488
#if (defined TEST_MIX_DISTANCE) /* rcg06192001 */
489
do_distance_update();
490
491
492
#endif
#if (defined TEST_MIX_POSITION) /* rcg06202001 */
493
do_position_update();
494
495
#endif
496
SDL_Delay(1);
497
498
} /* while still_playing() loop... */
499
500
CleanUp(0);
501
502
503
/* Not reached, but fixes compiler warnings */
return 0;
504
}
505
506
507
/* end of playwave.c ... */
508
/* vi: set ts=4 sw=4 expandtab: */