/* * OpenAL Helpers * * Copyright (c) 2011 by Chris Robinson * * 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 "alhelpers.h" #include #include #include #include "AL/al.h" #include "AL/alc.h" #include "AL/alext.h" /* InitAL opens a device and sets up a context using default attributes, making * the program ready to call OpenAL functions. */ int InitAL(char ***argv, int *argc) { const ALCchar *name; ALCdevice *device; ALCcontext *ctx; /* Open and initialize a device */ device = NULL; if(argc && argv && *argc > 1 && strcmp((*argv)[0], "-device") == 0) { device = alcOpenDevice((*argv)[1]); if(!device) fprintf(stderr, "Failed to open \"%s\", trying default\n", (*argv)[1]); (*argv) += 2; (*argc) -= 2; } if(!device) 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; } name = NULL; if(alcIsExtensionPresent(device, "ALC_ENUMERATE_ALL_EXT")) name = alcGetString(device, ALC_ALL_DEVICES_SPECIFIER); if(!name || alcGetError(device) != AL_NO_ERROR) name = alcGetString(device, ALC_DEVICE_SPECIFIER); printf("Opened \"%s\"\n", name); return 0; } /* CloseAL closes the device belonging to the current context, and destroys the * context. */ void CloseAL(void) { ALCdevice *device; ALCcontext *ctx; ctx = alcGetCurrentContext(); if(ctx == NULL) return; device = alcGetContextsDevice(ctx); alcMakeContextCurrent(NULL); alcDestroyContext(ctx); alcCloseDevice(device); } const char *FormatName(ALenum format) { switch(format) { case AL_FORMAT_MONO8: return "Mono, U8"; case AL_FORMAT_MONO16: return "Mono, S16"; case AL_FORMAT_MONO_FLOAT32: return "Mono, Float32"; case AL_FORMAT_MONO_MULAW: return "Mono, muLaw"; case AL_FORMAT_MONO_ALAW_EXT: return "Mono, aLaw"; case AL_FORMAT_MONO_IMA4: return "Mono, IMA4 ADPCM"; case AL_FORMAT_MONO_MSADPCM_SOFT: return "Mono, MS ADPCM"; case AL_FORMAT_STEREO8: return "Stereo, U8"; case AL_FORMAT_STEREO16: return "Stereo, S16"; case AL_FORMAT_STEREO_FLOAT32: return "Stereo, Float32"; case AL_FORMAT_STEREO_MULAW: return "Stereo, muLaw"; case AL_FORMAT_STEREO_ALAW_EXT: return "Stereo, aLaw"; case AL_FORMAT_STEREO_IMA4: return "Stereo, IMA4 ADPCM"; case AL_FORMAT_STEREO_MSADPCM_SOFT: return "Stereo, MS ADPCM"; case AL_FORMAT_QUAD8: return "Quadraphonic, U8"; case AL_FORMAT_QUAD16: return "Quadraphonic, S16"; case AL_FORMAT_QUAD32: return "Quadraphonic, Float32"; case AL_FORMAT_QUAD_MULAW: return "Quadraphonic, muLaw"; case AL_FORMAT_51CHN8: return "5.1 Surround, U8"; case AL_FORMAT_51CHN16: return "5.1 Surround, S16"; case AL_FORMAT_51CHN32: return "5.1 Surround, Float32"; case AL_FORMAT_51CHN_MULAW: return "5.1 Surround, muLaw"; case AL_FORMAT_61CHN8: return "6.1 Surround, U8"; case AL_FORMAT_61CHN16: return "6.1 Surround, S16"; case AL_FORMAT_61CHN32: return "6.1 Surround, Float32"; case AL_FORMAT_61CHN_MULAW: return "6.1 Surround, muLaw"; case AL_FORMAT_71CHN8: return "7.1 Surround, U8"; case AL_FORMAT_71CHN16: return "7.1 Surround, S16"; case AL_FORMAT_71CHN32: return "7.1 Surround, Float32"; case AL_FORMAT_71CHN_MULAW: return "7.1 Surround, muLaw"; case AL_FORMAT_BFORMAT2D_8: return "B-Format 2D, U8"; case AL_FORMAT_BFORMAT2D_16: return "B-Format 2D, S16"; case AL_FORMAT_BFORMAT2D_FLOAT32: return "B-Format 2D, Float32"; case AL_FORMAT_BFORMAT2D_MULAW: return "B-Format 2D, muLaw"; case AL_FORMAT_BFORMAT3D_8: return "B-Format 3D, U8"; case AL_FORMAT_BFORMAT3D_16: return "B-Format 3D, S16"; case AL_FORMAT_BFORMAT3D_FLOAT32: return "B-Format 3D, Float32"; case AL_FORMAT_BFORMAT3D_MULAW: return "B-Format 3D, muLaw"; case AL_FORMAT_UHJ2CHN8_SOFT: return "UHJ 2-channel, U8"; case AL_FORMAT_UHJ2CHN16_SOFT: return "UHJ 2-channel, S16"; case AL_FORMAT_UHJ2CHN_FLOAT32_SOFT: return "UHJ 2-channel, Float32"; case AL_FORMAT_UHJ3CHN8_SOFT: return "UHJ 3-channel, U8"; case AL_FORMAT_UHJ3CHN16_SOFT: return "UHJ 3-channel, S16"; case AL_FORMAT_UHJ3CHN_FLOAT32_SOFT: return "UHJ 3-channel, Float32"; case AL_FORMAT_UHJ4CHN8_SOFT: return "UHJ 4-channel, U8"; case AL_FORMAT_UHJ4CHN16_SOFT: return "UHJ 4-channel, S16"; case AL_FORMAT_UHJ4CHN_FLOAT32_SOFT: return "UHJ 4-channel, Float32"; } return "Unknown Format"; } #ifdef _WIN32 #define WIN32_LEAN_AND_MEAN #include #include int altime_get(void) { static int start_time = 0; int cur_time; union { FILETIME ftime; ULARGE_INTEGER ulint; } systime; GetSystemTimeAsFileTime(&systime.ftime); /* FILETIME is in 100-nanosecond units, or 1/10th of a microsecond. */ cur_time = (int)(systime.ulint.QuadPart/10000); if(!start_time) start_time = cur_time; return cur_time - start_time; } void al_nssleep(unsigned long nsec) { Sleep(nsec / 1000000); } #else #include #include #include int altime_get(void) { static int start_time = 0u; int cur_time; #if _POSIX_TIMERS > 0 struct timespec ts; int ret = clock_gettime(CLOCK_REALTIME, &ts); if(ret != 0) return 0; cur_time = (int)(ts.tv_sec*1000 + ts.tv_nsec/1000000); #else /* _POSIX_TIMERS > 0 */ struct timeval tv; int ret = gettimeofday(&tv, NULL); if(ret != 0) return 0; cur_time = (int)(tv.tv_sec*1000 + tv.tv_usec/1000); #endif if(!start_time) start_time = cur_time; return cur_time - start_time; } void al_nssleep(unsigned long nsec) { struct timespec ts, rem; ts.tv_sec = (time_t)(nsec / 1000000000ul); ts.tv_nsec = (long)(nsec % 1000000000ul); while(nanosleep(&ts, &rem) == -1 && errno == EINTR) ts = rem; } #endif