aboutsummaryrefslogtreecommitdiffstats
path: root/examples/common/alhelpers.c
diff options
context:
space:
mode:
authorChris Robinson <[email protected]>2012-10-14 01:55:39 -0700
committerChris Robinson <[email protected]>2012-10-14 01:55:39 -0700
commitf7655d44a266a4eeadd7d14921363594b64ac15f (patch)
treefd89151f62f2b17debe8c9f8f5bc74d24fa35fa6 /examples/common/alhelpers.c
parent38e6bfb7024f73671087da2caae5b952b80a5dab (diff)
Move alhelpers and alffmpeg code to a common sub-directory
Diffstat (limited to 'examples/common/alhelpers.c')
-rw-r--r--examples/common/alhelpers.c319
1 files changed, 319 insertions, 0 deletions
diff --git a/examples/common/alhelpers.c b/examples/common/alhelpers.c
new file mode 100644
index 00000000..dbfe2383
--- /dev/null
+++ b/examples/common/alhelpers.c
@@ -0,0 +1,319 @@
+/*
+ * OpenAL Helpers
+ *
+ * Copyright (c) 2011 by Chris Robinson <[email protected]>
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+/* This file contains routines to help with some menial OpenAL-related tasks,
+ * such as opening a device and setting up a context, closing the device and
+ * destroying its context, converting between frame counts and byte lengths,
+ * finding an appropriate buffer format, and getting readable strings for
+ * channel configs and sample types. */
+
+#include <stdio.h>
+
+#include "AL/al.h"
+#include "AL/alc.h"
+#include "AL/alext.h"
+
+#include "alhelpers.h"
+
+
+const char *ChannelsName(ALenum chans)
+{
+ switch(chans)
+ {
+ case AL_MONO_SOFT: return "Mono";
+ case AL_STEREO_SOFT: return "Stereo";
+ case AL_REAR_SOFT: return "Rear";
+ case AL_QUAD_SOFT: return "Quadraphonic";
+ case AL_5POINT1_SOFT: return "5.1 Surround";
+ case AL_6POINT1_SOFT: return "6.1 Surround";
+ case AL_7POINT1_SOFT: return "7.1 Surround";
+ }
+ return "Unknown Channels";
+}
+
+const char *TypeName(ALenum type)
+{
+ switch(type)
+ {
+ case AL_BYTE_SOFT: return "S8";
+ case AL_UNSIGNED_BYTE_SOFT: return "U8";
+ case AL_SHORT_SOFT: return "S16";
+ case AL_UNSIGNED_SHORT_SOFT: return "U16";
+ case AL_INT_SOFT: return "S32";
+ case AL_UNSIGNED_INT_SOFT: return "U32";
+ case AL_FLOAT_SOFT: return "Float32";
+ case AL_DOUBLE_SOFT: return "Float64";
+ }
+ return "Unknown Type";
+}
+
+
+ALsizei FramesToBytes(ALsizei size, ALenum channels, ALenum type)
+{
+ switch(channels)
+ {
+ case AL_MONO_SOFT: size *= 1; break;
+ case AL_STEREO_SOFT: size *= 2; break;
+ case AL_REAR_SOFT: size *= 2; break;
+ case AL_QUAD_SOFT: size *= 4; break;
+ case AL_5POINT1_SOFT: size *= 6; break;
+ case AL_6POINT1_SOFT: size *= 7; break;
+ case AL_7POINT1_SOFT: size *= 8; break;
+ }
+
+ switch(type)
+ {
+ case AL_BYTE_SOFT: size *= sizeof(ALbyte); break;
+ case AL_UNSIGNED_BYTE_SOFT: size *= sizeof(ALubyte); break;
+ case AL_SHORT_SOFT: size *= sizeof(ALshort); break;
+ case AL_UNSIGNED_SHORT_SOFT: size *= sizeof(ALushort); break;
+ case AL_INT_SOFT: size *= sizeof(ALint); break;
+ case AL_UNSIGNED_INT_SOFT: size *= sizeof(ALuint); break;
+ case AL_FLOAT_SOFT: size *= sizeof(ALfloat); break;
+ case AL_DOUBLE_SOFT: size *= sizeof(ALdouble); break;
+ }
+
+ return size;
+}
+
+ALsizei BytesToFrames(ALsizei size, ALenum channels, ALenum type)
+{
+ return size / FramesToBytes(1, channels, type);
+}
+
+
+ALenum GetFormat(ALenum channels, ALenum type, LPALISBUFFERFORMATSUPPORTEDSOFT palIsBufferFormatSupportedSOFT)
+{
+ ALenum format = AL_NONE;
+
+ /* If using AL_SOFT_buffer_samples, try looking through its formats */
+ if(palIsBufferFormatSupportedSOFT)
+ {
+ /* AL_SOFT_buffer_samples is more lenient with matching formats. The
+ * specified sample type does not need to match the returned format,
+ * but it is nice to try to get something close. */
+ if(type == AL_UNSIGNED_BYTE_SOFT || type == AL_BYTE_SOFT)
+ {
+ if(channels == AL_MONO_SOFT) format = AL_MONO8_SOFT;
+ else if(channels == AL_STEREO_SOFT) format = AL_STEREO8_SOFT;
+ else if(channels == AL_QUAD_SOFT) format = AL_QUAD8_SOFT;
+ else if(channels == AL_5POINT1_SOFT) format = AL_5POINT1_8_SOFT;
+ else if(channels == AL_6POINT1_SOFT) format = AL_6POINT1_8_SOFT;
+ else if(channels == AL_7POINT1_SOFT) format = AL_7POINT1_8_SOFT;
+ }
+ else if(type == AL_UNSIGNED_SHORT_SOFT || type == AL_SHORT_SOFT)
+ {
+ if(channels == AL_MONO_SOFT) format = AL_MONO16_SOFT;
+ else if(channels == AL_STEREO_SOFT) format = AL_STEREO16_SOFT;
+ else if(channels == AL_QUAD_SOFT) format = AL_QUAD16_SOFT;
+ else if(channels == AL_5POINT1_SOFT) format = AL_5POINT1_16_SOFT;
+ else if(channels == AL_6POINT1_SOFT) format = AL_6POINT1_16_SOFT;
+ else if(channels == AL_7POINT1_SOFT) format = AL_7POINT1_16_SOFT;
+ }
+ else if(type == AL_UNSIGNED_BYTE3_SOFT || type == AL_BYTE3_SOFT ||
+ type == AL_UNSIGNED_INT_SOFT || type == AL_INT_SOFT ||
+ type == AL_FLOAT_SOFT || type == AL_DOUBLE_SOFT)
+ {
+ if(channels == AL_MONO_SOFT) format = AL_MONO32F_SOFT;
+ else if(channels == AL_STEREO_SOFT) format = AL_STEREO32F_SOFT;
+ else if(channels == AL_QUAD_SOFT) format = AL_QUAD32F_SOFT;
+ else if(channels == AL_5POINT1_SOFT) format = AL_5POINT1_32F_SOFT;
+ else if(channels == AL_6POINT1_SOFT) format = AL_6POINT1_32F_SOFT;
+ else if(channels == AL_7POINT1_SOFT) format = AL_7POINT1_32F_SOFT;
+ }
+
+ if(format != AL_NONE && !palIsBufferFormatSupportedSOFT(format))
+ format = AL_NONE;
+
+ /* A matching format was not found or supported. Try 32-bit float. */
+ if(format == AL_NONE)
+ {
+ if(channels == AL_MONO_SOFT) format = AL_MONO32F_SOFT;
+ else if(channels == AL_STEREO_SOFT) format = AL_STEREO32F_SOFT;
+ else if(channels == AL_QUAD_SOFT) format = AL_QUAD32F_SOFT;
+ else if(channels == AL_5POINT1_SOFT) format = AL_5POINT1_32F_SOFT;
+ else if(channels == AL_6POINT1_SOFT) format = AL_6POINT1_32F_SOFT;
+ else if(channels == AL_7POINT1_SOFT) format = AL_7POINT1_32F_SOFT;
+
+ if(format != AL_NONE && !palIsBufferFormatSupportedSOFT(format))
+ format = AL_NONE;
+ }
+ /* 32-bit float not supported. Try 16-bit int. */
+ if(format == AL_NONE)
+ {
+ if(channels == AL_MONO_SOFT) format = AL_MONO16_SOFT;
+ else if(channels == AL_STEREO_SOFT) format = AL_STEREO16_SOFT;
+ else if(channels == AL_QUAD_SOFT) format = AL_QUAD16_SOFT;
+ else if(channels == AL_5POINT1_SOFT) format = AL_5POINT1_16_SOFT;
+ else if(channels == AL_6POINT1_SOFT) format = AL_6POINT1_16_SOFT;
+ else if(channels == AL_7POINT1_SOFT) format = AL_7POINT1_16_SOFT;
+
+ if(format != AL_NONE && !palIsBufferFormatSupportedSOFT(format))
+ format = AL_NONE;
+ }
+ /* 16-bit int not supported. Try 8-bit int. */
+ if(format == AL_NONE)
+ {
+ if(channels == AL_MONO_SOFT) format = AL_MONO8_SOFT;
+ else if(channels == AL_STEREO_SOFT) format = AL_STEREO8_SOFT;
+ else if(channels == AL_QUAD_SOFT) format = AL_QUAD8_SOFT;
+ else if(channels == AL_5POINT1_SOFT) format = AL_5POINT1_8_SOFT;
+ else if(channels == AL_6POINT1_SOFT) format = AL_6POINT1_8_SOFT;
+ else if(channels == AL_7POINT1_SOFT) format = AL_7POINT1_8_SOFT;
+
+ if(format != AL_NONE && !palIsBufferFormatSupportedSOFT(format))
+ format = AL_NONE;
+ }
+
+ return format;
+ }
+
+ /* We use the AL_EXT_MCFORMATS extension to provide output of Quad, 5.1,
+ * and 7.1 channel configs, AL_EXT_FLOAT32 for 32-bit float samples, and
+ * AL_EXT_DOUBLE for 64-bit float samples. */
+ if(type == AL_UNSIGNED_BYTE_SOFT)
+ {
+ if(channels == AL_MONO_SOFT)
+ format = AL_FORMAT_MONO8;
+ else if(channels == AL_STEREO_SOFT)
+ format = AL_FORMAT_STEREO8;
+ else if(alIsExtensionPresent("AL_EXT_MCFORMATS"))
+ {
+ if(channels == AL_QUAD_SOFT)
+ format = alGetEnumValue("AL_FORMAT_QUAD8");
+ else if(channels == AL_5POINT1_SOFT)
+ format = alGetEnumValue("AL_FORMAT_51CHN8");
+ else if(channels == AL_6POINT1_SOFT)
+ format = alGetEnumValue("AL_FORMAT_61CHN8");
+ else if(channels == AL_7POINT1_SOFT)
+ format = alGetEnumValue("AL_FORMAT_71CHN8");
+ }
+ }
+ else if(type == AL_SHORT_SOFT)
+ {
+ if(channels == AL_MONO_SOFT)
+ format = AL_FORMAT_MONO16;
+ else if(channels == AL_STEREO_SOFT)
+ format = AL_FORMAT_STEREO16;
+ else if(alIsExtensionPresent("AL_EXT_MCFORMATS"))
+ {
+ if(channels == AL_QUAD_SOFT)
+ format = alGetEnumValue("AL_FORMAT_QUAD16");
+ else if(channels == AL_5POINT1_SOFT)
+ format = alGetEnumValue("AL_FORMAT_51CHN16");
+ else if(channels == AL_6POINT1_SOFT)
+ format = alGetEnumValue("AL_FORMAT_61CHN16");
+ else if(channels == AL_7POINT1_SOFT)
+ format = alGetEnumValue("AL_FORMAT_71CHN16");
+ }
+ }
+ else if(type == AL_FLOAT_SOFT && alIsExtensionPresent("AL_EXT_FLOAT32"))
+ {
+ if(channels == AL_MONO_SOFT)
+ format = alGetEnumValue("AL_FORMAT_MONO_FLOAT32");
+ else if(channels == AL_STEREO_SOFT)
+ format = alGetEnumValue("AL_FORMAT_STEREO_FLOAT32");
+ else if(alIsExtensionPresent("AL_EXT_MCFORMATS"))
+ {
+ if(channels == AL_QUAD_SOFT)
+ format = alGetEnumValue("AL_FORMAT_QUAD32");
+ else if(channels == AL_5POINT1_SOFT)
+ format = alGetEnumValue("AL_FORMAT_51CHN32");
+ else if(channels == AL_6POINT1_SOFT)
+ format = alGetEnumValue("AL_FORMAT_61CHN32");
+ else if(channels == AL_7POINT1_SOFT)
+ format = alGetEnumValue("AL_FORMAT_71CHN32");
+ }
+ }
+ else if(type == AL_DOUBLE_SOFT && alIsExtensionPresent("AL_EXT_DOUBLE"))
+ {
+ if(channels == AL_MONO_SOFT)
+ format = alGetEnumValue("AL_FORMAT_MONO_DOUBLE");
+ else if(channels == AL_STEREO_SOFT)
+ format = alGetEnumValue("AL_FORMAT_STEREO_DOUBLE");
+ }
+
+ /* NOTE: It seems OSX returns -1 from alGetEnumValue for unknown enums, as
+ * opposed to 0. Correct it. */
+ if(format == -1)
+ format = 0;
+
+ return format;
+}
+
+
+void AL_APIENTRY wrap_BufferSamples(ALuint buffer, ALuint samplerate,
+ ALenum internalformat, ALsizei samples,
+ ALenum channels, ALenum type,
+ const ALvoid *data)
+{
+ alBufferData(buffer, internalformat, data,
+ FramesToBytes(samples, channels, type),
+ samplerate);
+}
+
+
+int InitAL(void)
+{
+ ALCdevice *device;
+ ALCcontext *ctx;
+
+ /* Open and initialize a device with default settings */
+ device = alcOpenDevice(NULL);
+ if(!device)
+ {
+ fprintf(stderr, "Could not open a device!\n");
+ return 1;
+ }
+
+ ctx = alcCreateContext(device, NULL);
+ if(ctx == NULL || alcMakeContextCurrent(ctx) == ALC_FALSE)
+ {
+ if(ctx != NULL)
+ alcDestroyContext(ctx);
+ alcCloseDevice(device);
+ fprintf(stderr, "Could not set a context!\n");
+ return 1;
+ }
+
+ return 0;
+}
+
+void CloseAL(void)
+{
+ ALCdevice *device;
+ ALCcontext *ctx;
+
+ /* Close the device belonging to the current context, and destroy the
+ * context. */
+ ctx = alcGetCurrentContext();
+ if(ctx == NULL)
+ return;
+
+ device = alcGetContextsDevice(ctx);
+
+ alcMakeContextCurrent(NULL);
+ alcDestroyContext(ctx);
+ alcCloseDevice(device);
+}