openalbridge/openalbridge.c
author koda
Sun, 11 Oct 2009 16:03:56 +0000
changeset 2415 35d09cbf819a
parent 2392 a55dbef5cf31
child 2418 538a777f90c4
permissions -rw-r--r--
OpenALBridge updates - fix problems when building for PPC targets - gives more precise error messages

/*
 * 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 "wrappers.h"
#include "alc.h"
#include "loaders.h"
#include "endianness.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) {
            fprintf(stderr, "ERROR: OpenAL not initialized\n");
            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(uint32_t usehardware, uint32_t memorysize) {	
        /*Initialize an OpenAL contex and allocate memory space for data and buffers*/
        ALCcontext *context;
        ALCdevice *device;
        const ALCchar *default_device;
        
        /*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) {
            fprintf(stderr, "ERROR 'openal_init()': OpenAL already initialized\n");
            return AL_FALSE;
        }

		if(usehardware)
		{
			if ((device = alcOpenDevice(NULL)) == NULL) {
				fprintf(stderr, "ERROR 'openal_init()': Failed to open sound device\n");
				return AL_FALSE;
			}
		}
		else
		{
			if ((device = alcOpenDevice("Generic Software")) == NULL) {
				fprintf(stderr, "ERROR 'openal_init()': Failed to open sound device\n");
				return AL_FALSE;
			}
		}
		fprintf(stderr, "Using default device: %s\n", alcGetString(device, ALC_DEVICE_SPECIFIER));
        
        context = alcCreateContext(device, NULL);
        alcMakeContextCurrent(context);
        alcProcessContext(context);
        
        if (AlGetError("ERROR %d in 'openal_init()': Creating a new contex\n") != 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("ERROR %d: Setting Listener properties\n") != 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
        fprintf(stderr, "OpenALBridge: Realloc in process from %d to %d\n", 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) {
            fprintf(stderr, "ERROR 'openal_loadfile()': OpenAL not initialized\n");
            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) {
            fprintf(stderr, "ERROR 'openal_loadfile()': file %s is too short \n", filename);
            return -2;
        }
        
        /*prepare the buffer to receive data*/
        alGenBuffers(1, &Buffers[globalindex]);
        
        if (AlGetError("ERROR %d in 'openal_loadfile()': Allocating memory for buffers\n") != AL_TRUE)
            return -3;
        
        /*prepare the source to emit sound*/
        alGenSources(1, &Sources[globalindex]);
        
        if (AlGetError("ERROR %d in 'openal_loadfile()': Allocating memory for sources\n") != 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:
                        fprintf(stderr, "ERROR 'openal_loadfile()': File format (%08X) not supported!\n", 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("ERROR %d in 'openal_loadfile()': Writing data to buffer\n") != 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("ERROR %d in 'openal_loadfile()': Setting source properties\n") != 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) {
            fprintf(stderr, "ERROR 'openal_toggleloop()': OpenAL not initialized\n");
            return AL_FALSE;
        }
        
        if (index >= globalsize) {
            fprintf(stderr, "ERROR 'openal_toggleloop()': index out of bounds (got %d, max %d)\n", index, globalindex);
            return AL_FALSE;
        }
        
        alGetSourcei (Sources[index], AL_LOOPING, &loop);
        alSourcei (Sources[index], AL_LOOPING, !((uint8_t) loop) & 0x00000001);
        if (AlGetError("ERROR %d in 'openal_toggleloop()': Getting or setting loop property\n") != 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) {
            fprintf(stderr, "ERROR 'openal_setvolume()': OpenAL not initialized\n");
            return AL_FALSE;
        }
        
        /*Set volume for sound number index*/
        if (index >= globalindex) {
            fprintf(stderr, "ERROR 'openal_setvolume()': index out of bounds (got %d, max %d)\n", index, globalindex);
            return AL_FALSE;
        }
        
        if (percentage > 100)
            percentage = 100;
        alSourcef (Sources[index], AL_GAIN, (float) percentage/100.0f);
        if (AlGetError2("ERROR %d in 'openal_setvolume()': setting 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) {
            fprintf(stderr, "ERROR 'openal_setglobalvolume()': OpenAL not initialized\n");
            return AL_FALSE;
        }
        
        /*Set volume for all sounds*/		
        if (percentage > 100)
            percentage = 100;
        alListenerf (AL_GAIN, (float) percentage/100.0f);
        if (AlGetError("ERROR %d in 'openal_setglobalvolume()': Setting global volume\n") != 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) {
            fprintf(stderr, "ERROR 'openal_togglemute()': OpenAL not initialized\n");
            return AL_FALSE;
        }
        
        alGetListenerf (AL_GAIN, &mute);
        if (mute > 0) 
            mute = 0;
        else
            mute = 1.0;
        alListenerf (AL_GAIN, mute);
        if (AlGetError("ERROR %d in 'openal_togglemute()': Setting mute property\n") != 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) {
            fprintf(stderr, "ERROR 'openal_fade()': OpenAL not initialized\n");
            return AL_FALSE;
        }
        
        fade = (fade_t*) Malloc(sizeof(fade_t));
        fade->index = index;
        fade->quantity = quantity;
        
        if (index >= globalindex) {
            fprintf(stderr, "ERROR 'openal_fade()': index out of bounds (got %d, max %d)\n", 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:
                            fprintf(stderr, "ERROR 'openal_fade()': unknown direction for fade (%d)\n", direction);
                            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) {
            fprintf(stderr, "ERROR 'openal_setposition()': OpenAL not initialized\n");
            return AL_FALSE;
        }
        
        if (index >= globalindex) {
            fprintf(stderr, "ERROR 'openal_setposition()': index out of bounds (got %d, max %d)\n", index, globalindex);
            return AL_FALSE;
        }
        
        alSource3f(Sources[index], AL_POSITION, x, y, z);
        if (AlGetError2("ERROR %d in 'openal_setposition()': setting position for sound %d\n", index) != AL_TRUE)
            return AL_FALSE;
        
        return AL_TRUE;
    }
    
    
    ALboolean openal_playsound (uint32_t index){
        if(openalReady == AL_FALSE) {
            fprintf(stderr, "ERROR 'openal_playsound()': OpenAL not initialized\n");
            return AL_FALSE;
        }
        
        /*Play sound number index*/
        if (index >= globalindex) {
            fprintf(stderr, "ERROR 'openal_playsound()': index out of bounds (got %d, max %d)\n", index, globalindex);
            return AL_FALSE;
        }
        alSourcePlay(Sources[index]);
        if (AlGetError2("ERROR %d in 'openal_playsound()': Playing sound %d\n", 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) {
            fprintf(stderr, "ERROR 'openal_pausesound()': OpenAL not initialized\n");
            return AL_FALSE;
        }
        
        /*Pause sound number index*/
        if (index >= globalindex) {
            fprintf(stderr, "ERROR 'openal_pausesound()': index out of bounds (got %d, max %d)\n", index, globalindex);
            return AL_FALSE;
        }
        alSourcePause(Sources[index]);
        if (AlGetError2("ERROR %d in 'openal_pausesound()': Pausing sound %d\n", index) != AL_TRUE)
            return AL_FALSE;
        
        return AL_TRUE;
    }
    
    
    ALboolean openal_stopsound(uint32_t index){
        if(openalReady == AL_FALSE) {
            fprintf(stderr, "ERROR 'openal_stopsound()': OpenAL not initialized\n");
            return AL_FALSE;
        }
        
        /*Stop sound number index*/
        if (index >= globalindex) {
            fprintf(stderr, "ERROR 'openal_stopsound()': index out of bounds (got %d, max %d)\n", index, globalindex);
            return AL_FALSE;
        }
        alSourceStop(Sources[index]);
        if (AlGetError2("ERROR %d in 'openal_stopsound()': Stopping sound %d\n", index) != AL_TRUE)
            return AL_FALSE;
        
        alGetError();  /* clear any AL errors beforehand */
        
        return AL_TRUE;
    }
    
#ifdef __CPLUSPLUS
}
#endif