openalbridge/openalbridge.c
author unc0rr
Fri, 12 Nov 2010 19:40:35 +0300
branch0.9.12
changeset 2559 711db3cb2aed
parent 2529 51e5df1c8462
permissions -rw-r--r--
Close 0.9.12 branch

/*
 * 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"


#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;
                
                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)
                        device = alcOpenDevice(NULL);
                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;
                
#ifdef DEBUG
                err_msg("(%s) INFO - Realloc in process from %d to %d\n", prog, oldsize, globalsize);
#endif
                
                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;
        }
        
#ifdef __CPLUSPLUS
}
#endif