misc/openalbridge/openalbridge.c
changeset 3353 a767dd3786b5
child 3356 3ae3fccb439e
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/misc/openalbridge/openalbridge.c	Sat Apr 17 08:30:34 2010 +0000
@@ -0,0 +1,523 @@
+/*
+ * OpenAL Bridge - a simple portable library for OpenAL interface
+ * Copyright (c) 2009 Vittorio Giovara <vittorio.giovara@gmail.com>
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation; version 2 of the License
+ *
+ * This program 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 Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+ */
+
+#include "openalbridge.h"
+#include "globals.h"
+#include "wrappers.h"
+#include "alc.h"
+#include "loaders.h"
+
+#ifdef __CPLUSPLUS
+extern "C" {
+#endif 
+    
+    /*Sources are points emitting sound*/
+    ALuint *Sources;
+    /*Buffers hold sound data*/
+    ALuint *Buffers;
+    /*index for Sources and Buffers*/
+    ALuint globalindex, globalsize, increment;
+    
+    ALboolean openalReady = AL_FALSE;
+    
+    ALboolean openal_close (void) {
+        /*Stop all sounds, deallocate all memory and close OpenAL */
+        ALCcontext *context;
+        ALCdevice  *device;
+        
+        if (openalReady == AL_FALSE) {
+            errno = EPERM;
+            err_ret("(%s) WARN - OpenAL not initialized", prog);
+            return AL_FALSE;
+        }
+        
+        alSourceStopv	(globalsize, Sources);
+        alDeleteSources (globalsize, Sources);
+        alDeleteBuffers (globalsize, Buffers);
+        
+        free(Sources);
+        free(Buffers);
+        
+        context = alcGetCurrentContext();
+        device  = alcGetContextsDevice(context);
+        
+        alcMakeContextCurrent(NULL);
+        alcDestroyContext(context);
+        alcCloseDevice(device);
+        
+        openalReady = AL_FALSE;
+        
+        err_msg("(%s) INFO - OpenAL closed", prog);
+        
+        return AL_TRUE;
+    }
+    
+    ALboolean openal_ready(void) {
+        return openalReady;
+    }
+    
+    ALboolean openal_init(char* programname, ALboolean usehardware, uint32_t memorysize) {	
+        /*Initialize an OpenAL contex and allocate memory space for data and buffers*/
+        ALCcontext *context;
+        ALCdevice *device;
+        const ALCchar *default_device;
+        
+        prog = programname;
+        
+        /*Position of the listener*/
+        ALfloat ListenerPos[] = { 0.0, 0.0, 0.0 };
+        /*Velocity of the listener*/
+        ALfloat ListenerVel[] = { 0.0, 0.0, 0.0 };
+        /*Orientation of the listener. (first 3 elements are "at", second 3 are "up")*/
+        ALfloat ListenerOri[] = { 0.0, 0.0, -1.0,  0.0, 1.0, 0.0 };
+        
+        if (openalReady == AL_TRUE) {
+            errno = EPERM;                
+            err_ret("(%s) WARN - OpenAL already initialized", prog);
+            return AL_FALSE;
+        }
+        
+        if (usehardware == AL_TRUE) {
+             default_device = alcGetString(NULL, ALC_DEFAULT_DEVICE_SPECIFIER);
+            device = alcOpenDevice(default_device);
+        } else
+            device = alcOpenDevice("Generic Software");
+        
+        if (device == NULL) {
+            errno = ENODEV;                
+            err_ret("(%s) WARN - Failed to open sound device", prog);
+            return AL_FALSE;
+        }
+        err_msg("(%s) INFO - Output device: %s", prog, alcGetString(device, ALC_DEVICE_SPECIFIER));
+        
+        context = alcCreateContext(device, NULL);
+        alcMakeContextCurrent(context);
+        alcProcessContext(context);
+        
+        if (AlGetError("(%s) WARN - Failed to create a new contex") != AL_TRUE)
+            return AL_FALSE;
+        
+        /*allocate memory space for buffers and sources*/
+        if (memorysize == 0)
+            globalsize = 50;
+        else
+            globalsize = memorysize;
+        increment  = globalsize;
+        
+        Buffers = (ALuint*) Malloc(sizeof(ALuint)*globalsize);
+        Sources = (ALuint*) Malloc(sizeof(ALuint)*globalsize);
+        
+        /*set the listener gain, position (on xyz axes), velocity (one value for each axe) and orientation*/
+        alListenerf (AL_GAIN,        1.0f       );
+        alListenerfv(AL_POSITION,    ListenerPos);
+        alListenerfv(AL_VELOCITY,    ListenerVel);
+        alListenerfv(AL_ORIENTATION, ListenerOri);
+        
+        if (AlGetError("(%s) WARN - Failed to set Listener properties") != AL_TRUE)
+            return AL_FALSE;
+        
+        openalReady = AL_TRUE;
+        
+        alGetError();  /* clear any AL errors beforehand */
+        return AL_TRUE;
+    }
+    
+    
+    ALboolean helper_realloc (void) {
+        /*expands allocated memory when loading more sound files than expected*/
+        int oldsize = globalsize;
+        globalsize += increment;
+        
+        err_msg("(%s) INFO - Realloc in process from %d to %d\n", prog, oldsize, globalsize);
+        
+        Buffers = (ALuint*) Realloc(Buffers, sizeof(ALuint)*globalsize);
+        Sources = (ALuint*) Realloc(Sources, sizeof(ALuint)*globalsize);
+        
+        return AL_TRUE;
+    }
+    
+    
+    ALint openal_loadfile (const char *filename){
+        /*Open a file, load into memory and allocate the Source buffer for playing*/
+        ALfloat SourcePos[] = { 0.0, 0.0, 0.0 }; /*Position of the source sound*/
+        ALfloat SourceVel[] = { 0.0, 0.0, 0.0 }; /*Velocity of the source sound*/
+        ALenum format;
+        ALsizei bitsize, freq;
+        char *data;
+        uint32_t fileformat;
+        ALenum error;
+        FILE *fp;
+        
+        if (openalReady == AL_FALSE) {
+            errno = EPERM;                
+            err_ret("(%s) WARN - OpenAL not initialized", prog);
+            return AL_FALSE;
+        }
+        
+        /*when the buffers are all used, we can expand memory to accept new files*/
+        if (globalindex == globalsize)
+            helper_realloc();
+        
+        /*detect the file format, as written in the first 4 bytes of the header*/
+        fp = Fopen (filename, "rb");
+        
+        if (fp == NULL)
+            return -1;
+        
+        error = fread (&fileformat, sizeof(uint32_t), 1, fp);
+        fclose (fp);
+        
+        if (error < 0) {
+            errno = EIO;
+            err_ret("(%s) ERROR - File %s is too short", prog, filename);
+            return -2;
+        }
+        
+        /*prepare the buffer to receive data*/
+        alGenBuffers(1, &Buffers[globalindex]);
+        
+        if (AlGetError("(%s) ERROR - Failed to allocate memory for buffers") != AL_TRUE)
+            return -3;
+        
+        /*prepare the source to emit sound*/
+        alGenSources(1, &Sources[globalindex]);
+        
+        if (AlGetError("(%s) ERROR - Failed to allocate memory for sources") != AL_TRUE)
+            return -4;
+        
+        
+        switch (ENDIAN_BIG_32(fileformat)) {
+            case OGG_FILE_FORMAT:
+                error = load_oggvorbis (filename, &format, &data, &bitsize, &freq);
+                break;
+            case WAV_FILE_FORMAT:
+                error = load_wavpcm (filename, &format, &data, &bitsize, &freq);
+                break;
+            default:
+                errno = EINVAL;
+                err_ret ("(%s) ERROR - File format (%08X) not supported", prog, ENDIAN_BIG_32(fileformat));
+                return -5;
+                break;
+        }
+        
+        
+        /*copy pcm data in one buffer*/
+        alBufferData(Buffers[globalindex], format, data, bitsize, freq);
+        free(data);		/*deallocate data to save memory*/
+        
+        if (AlGetError("(%s) ERROR - Failed to write data to buffers") != AL_TRUE)
+            return -6;
+        
+        /*set source properties that it will use when it's in playback*/
+        alSourcei (Sources[globalindex], AL_BUFFER,   Buffers[globalindex]  );
+        alSourcef (Sources[globalindex], AL_PITCH,    1.0f                  );
+        alSourcef (Sources[globalindex], AL_GAIN,     1.0f                  );
+        alSourcefv(Sources[globalindex], AL_POSITION, SourcePos             );
+        alSourcefv(Sources[globalindex], AL_VELOCITY, SourceVel             );
+        alSourcei (Sources[globalindex], AL_LOOPING,  0                     );
+        
+        if (AlGetError("(%s) ERROR - Failed to set Source properties") != AL_TRUE)
+            return -7;
+        
+        alGetError();  /* clear any AL errors beforehand */
+        
+        /*returns the index of the source you just loaded, increments it and exits*/
+        return globalindex++;
+    }
+    
+    
+    ALboolean openal_toggleloop (uint32_t index){
+        /*Set or unset looping mode*/
+        ALint loop;
+        
+        if (openalReady == AL_FALSE) {
+            errno = EPERM;                
+            err_ret("(%s) WARN - OpenAL not initialized", prog);
+            return AL_FALSE;
+        }
+        
+        if (index >= globalsize) {
+            errno = EINVAL;
+            err_ret("(%s) ERROR - Index out of bounds (got %d, max %d)", prog, index, globalindex);
+            return AL_FALSE;
+        }
+        
+        alGetSourcei (Sources[index], AL_LOOPING, &loop);
+        alSourcei (Sources[index], AL_LOOPING, !((uint8_t) loop) & 0x00000001);
+        if (AlGetError("(%s) ERROR - Failed to get or set loop property") != AL_TRUE)
+            return AL_FALSE;
+        
+        alGetError();  /* clear any AL errors beforehand */
+        
+        return AL_TRUE;
+    }
+    
+    
+    ALboolean openal_setvolume (uint32_t index, uint8_t percentage) {
+        if (openalReady == AL_FALSE) {
+            errno = EPERM;                
+            err_ret("(%s) WARN - OpenAL not initialized", prog);
+            return AL_FALSE;
+        }
+        
+        /*Set volume for sound number index*/
+        if (index >= globalsize) {
+            errno = EINVAL;
+            err_ret("(%s) ERROR - Index out of bounds (got %d, max %d)", prog, index, globalindex);
+            return AL_FALSE;
+        }
+        
+        if (percentage > 100)
+            percentage = 100;
+        alSourcef (Sources[index], AL_GAIN, (float) percentage/100.0f);
+        if (AlGetError2("(%s) ERROR -  Failed to set volume for sound %d\n", index) != AL_TRUE)
+            return AL_FALSE;
+        
+        alGetError();  /* clear any AL errors beforehand */
+        
+        return AL_TRUE;
+    }
+    
+    
+    ALboolean openal_setglobalvolume (uint8_t percentage) {
+        if (openalReady == AL_FALSE) {
+            errno = EPERM;                
+            err_ret("(%s) WARN - OpenAL not initialized", prog);
+            return AL_FALSE;
+        }
+        
+        /*Set volume for all sounds*/		
+        if (percentage > 100)
+            percentage = 100;
+        alListenerf (AL_GAIN, (float) percentage/100.0f);
+        if (AlGetError("(%s) ERROR -  Failed to set global volume") != AL_TRUE)
+            return AL_FALSE;
+        
+        alGetError();  /* clear any AL errors beforehand */
+        
+        return AL_TRUE;
+    }
+    
+    
+    ALboolean openal_togglemute () {
+        /*Mute or unmute sound*/
+        ALfloat mute;
+        
+        if (openalReady == AL_FALSE) {
+            errno = EPERM;                
+            err_ret("(%s) WARN - OpenAL not initialized", prog);
+            return AL_FALSE;
+        }
+        
+        alGetListenerf (AL_GAIN, &mute);
+        if (mute > 0) 
+            mute = 0;
+        else
+            mute = 1.0;
+        alListenerf (AL_GAIN, mute);
+        if (AlGetError("(%s) ERROR -  Failed to set mute property") != AL_TRUE)
+            return AL_FALSE;
+        
+        alGetError();  /* clear any AL errors beforehand */
+        
+        return AL_TRUE;
+    }
+    
+    
+    ALboolean openal_fade (uint32_t index, uint16_t quantity, ALboolean direction) {
+        /*Fade in or out by calling a helper thread*/
+#ifndef _WIN32
+        pthread_t thread;
+#else
+        HANDLE Thread;
+        DWORD threadID;
+#endif
+        fade_t *fade;
+        
+        if (openalReady == AL_FALSE) {
+            errno = EPERM;                
+            err_ret("(%s) WARN - OpenAL not initialized", prog);
+            return AL_FALSE;
+        }
+        
+        fade = (fade_t*) Malloc(sizeof(fade_t));
+        fade->index = index;
+        fade->quantity = quantity;
+        
+        if (index >= globalsize) {
+            errno = EINVAL;
+            err_ret("(%s) ERROR - Index out of bounds (got %d, max %d)", prog, index, globalindex);
+            return AL_FALSE;
+        }
+        
+        switch (direction) {
+            case FADE_IN:
+#ifndef _WIN32
+                pthread_create(&thread, NULL, helper_fadein, (void*) fade);
+#else
+                Thread = _beginthread(&helper_fadein, 0, (void*) fade);
+#endif
+                break;
+            case FADE_OUT:
+#ifndef _WIN32
+                pthread_create(&thread, NULL, helper_fadeout, (void*) fade);
+#else
+                Thread = _beginthread(&helper_fadeout, 0, (void*) fade);
+#endif	
+                break;
+            default:
+                errno = EINVAL;
+                err_ret("(%s) ERROR - Unknown direction for fading", prog, index, globalindex);
+                free(fade);
+                return AL_FALSE;
+                break;
+        }
+        
+#ifndef _WIN32
+        pthread_detach(thread);
+#endif
+        
+        alGetError();  /* clear any AL errors beforehand */
+        
+        return AL_TRUE;
+    }
+    
+    
+    ALboolean openal_fadeout (uint32_t index, uint16_t quantity) {
+        /*wrapper for fadeout*/
+        return openal_fade(index, quantity, FADE_OUT);
+    }
+    
+    
+    ALboolean openal_fadein (uint32_t index, uint16_t quantity) {
+        /*wrapper for fadein*/
+        return openal_fade(index, quantity, FADE_IN);
+    }
+    
+    
+    ALboolean openal_setposition (uint32_t index, float x, float y, float z) {
+        if (openalReady == AL_FALSE) {
+            errno = EPERM;                
+            err_ret("(%s) WARN - OpenAL not initialized", prog);
+            return AL_FALSE;
+        }
+        
+        if (index >= globalsize) {
+            errno = EINVAL;
+            err_ret("(%s) ERROR - Index out of bounds (got %d, max %d)", prog, index, globalindex);
+            return AL_FALSE;
+        }
+        
+        alSource3f(Sources[index], AL_POSITION, x, y, z);
+        if (AlGetError2("(%s) ERROR - Failed to set position for sound %d)", index) != AL_TRUE)
+            return AL_FALSE;
+        
+        return AL_TRUE;
+    }
+    
+    
+    ALboolean openal_playsound (uint32_t index){
+        if (openalReady == AL_FALSE) {
+            errno = EPERM;                
+            err_ret("(%s) WARN - OpenAL not initialized", prog);
+            return AL_FALSE;
+        }
+        
+        /*Play sound number index*/
+        if (index >= globalsize) {
+            errno = EINVAL;
+            err_ret("(%s) ERROR - Index out of bounds (got %d, max %d)", prog, index, globalindex);
+            return AL_FALSE;
+        }
+        alSourcePlay(Sources[index]);
+        if (AlGetError2("(%s) ERROR - Failed to play sound %d)", index) != AL_TRUE)
+            return AL_FALSE;
+        
+        alGetError();  /* clear any AL errors beforehand */
+        
+        return AL_TRUE;
+    }
+    
+    
+    ALboolean openal_pausesound(uint32_t index){
+        if (openalReady == AL_FALSE) {
+            errno = EPERM;                
+            err_ret("(%s) WARN - OpenAL not initialized", prog);
+            return AL_FALSE;
+        }
+        
+        /*Pause sound number index*/
+        if (index >= globalsize) {
+            errno = EINVAL;
+            err_ret("(%s) ERROR - Index out of bounds (got %d, max %d)", prog, index, globalindex);
+            return AL_FALSE;
+        }
+        alSourcePause(Sources[index]);
+        if (AlGetError2("(%s) ERROR - Failed to pause sound %d)", index) != AL_TRUE)
+            return AL_FALSE;
+        
+        return AL_TRUE;
+    }
+    
+    
+    ALboolean openal_stopsound(uint32_t index){
+        if (openalReady == AL_FALSE) {
+            errno = EPERM;                
+            err_ret("(%s) WARN - OpenAL not initialized", prog);
+            return AL_FALSE;
+        }
+        
+        /*Stop sound number index*/
+        if (index >= globalsize) {
+            errno = EINVAL;
+            err_ret("(%s) ERROR - Index out of bounds (got %d, max %d)", prog, index, globalindex);
+            return AL_FALSE;
+        }
+        alSourceStop(Sources[index]);
+        if (AlGetError2("(%s) ERROR - Failed to stop sound %d)", index) != AL_TRUE)
+            return AL_FALSE;
+        
+        alGetError();  /* clear any AL errors beforehand */
+        
+        return AL_TRUE;
+    }
+    
+    
+    ALboolean openal_freesound(uint32_t index){
+        if (openalReady == AL_FALSE) {
+            errno = EPERM;                
+            err_ret("(%s) WARN - OpenAL not initialized", prog);
+            return AL_FALSE;
+        }
+        
+        /*Stop sound number index*/
+        if (index >= globalsize) {
+            errno = EINVAL;
+            err_ret("(%s) ERROR - Index out of bounds (got %d, max %d)", prog, index, globalindex);
+            return AL_FALSE;
+        }
+        globalindex--;
+        
+        alGetError();  /* clear any AL errors beforehand */
+        
+        return AL_TRUE;
+    }
+    
+#ifdef __CPLUSPLUS
+}
+#endif