Source/openal_wrapper.h

   1 /*
   2 Copyright (C) 2003, 2010 - Wolfire Games
   3
   4 This file is part of Lugaru.
   5
   6 Lugaru is free software; you can redistribute it and/or modify
   7 it under the terms of the GNU General Public License as published by
   8 the Free Software Foundation; either version 2 of the License, or
   9 (at your option) any later version.
  10
  11 Lugaru is distributed in the hope that it will be useful,
  12 but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 GNU General Public License for more details.
  15
  16 You should have received a copy of the GNU General Public License
  17 along with Lugaru.  If not, see <http://www.gnu.org/licenses/>.
  18 */
  19
  20 #ifndef OPENAL_WRAPPER_H
  21 #define OPENAL_WRAPPER_H
  22
  23 #ifdef _WIN32
  24 #include <malloc.h>
  25 #endif
  26
  27 #include "AL/al.h"
  28 #include "AL/alc.h"
  29
  30 #include "ogg/ogg.h"
  31 #include "vorbis/vorbisfile.h"
  32
  33 #include "MacCompatibility.h"
  34
  35 #if 0 /* this should only be enable if OPENAL doesn't provide AL_API on all platforms */
  36 #if (!defined(WIN32) && !defined(_WIN32) && !defined(__WIN32__) && !defined(_WIN64) && !defined(_WIN32_WCE) && !defined(_XBOX)) || (defined(__GNUC__) && defined(WIN32))
  37 #ifndef __cdecl
  38 #define __cdecl
  39 #endif
  40 #ifndef __stdcall
  41 #define __stdcall
  42 #endif
  43 #endif
  44
  45 #if defined(_WIN32_WCE)
  46 #define AL_API _cdecl
  47 #define F_CALLBACKAPI _cdecl
  48 #else
  49 #define AL_API __stdcall
  50 #define F_CALLBACKAPI __stdcall
  51 #endif
  52
  53 #ifdef DLL_EXPORTS
  54 #define DLL_API __declspec(dllexport)
  55 #else
  56 #if defined(__LCC__) || defined(__MINGW32__) || defined(__CYGWIN32__)
  57 #define DLL_API AL_API
  58 #else
  59 #define DLL_API
  60 #endif /* __LCC__ ||  __MINGW32__ || __CYGWIN32__ */
  61 #endif /* DLL_EXPORTS */
  62 #endif /* if 0 */
  63
  64
  65 typedef struct OPENAL_SAMPLE    OPENAL_SAMPLE;
  66 typedef OPENAL_SAMPLE    OPENAL_STREAM;
  67 typedef struct OPENAL_DSPUNIT   OPENAL_DSPUNIT;
  68
  69 enum OPENAL_OUTPUTTYPES {
  70     OPENAL_OUTPUT_NOSOUND,    /* NoSound driver, all calls to this succeed but do nothing. */
  71     OPENAL_OUTPUT_OSS,        /* Linux/Unix OSS (Open Sound System) driver, i.e. the kernel sound drivers. */
  72     OPENAL_OUTPUT_ALSA,       /* Linux Alsa driver. */
  73 };
  74
  75 #define OPENAL_LOOP_OFF      0x00000001  /* For non looping samples. */
  76 #define OPENAL_LOOP_NORMAL   0x00000002  /* For forward looping samples. */
  77 #define OPENAL_HW3D          0x00001000  /* Attempts to make samples use 3d hardware acceleration. (if the card supports it) */
  78 #define OPENAL_2D            0x00002000  /* Tells software (not hardware) based sample not to be included in 3d processing. */
  79 #define OPENAL_FREE             -1      /* value to play on any free channel, or to allocate a sample in a free sample slot. */
  80 #define OPENAL_ALL              -3      /* for a channel index , this flag will affect ALL channels available!  Not supported by every function. */
  81
  82 #ifdef __cplusplus
  83 extern "C" {
  84 #endif
  85
  86 #undef AL_API
  87 #define AL_API
  88
  89     AL_API void OPENAL_3D_Listener_SetAttributes(const float *pos, const float *vel, float fx, float fy, float fz, float tx, float ty, float tz);
  90     AL_API signed char OPENAL_3D_SetAttributes(int channel, const float *pos, const float *vel);
  91     AL_API signed char OPENAL_3D_SetAttributes_(int channel, const XYZ &pos, const float *vel);
  92     AL_API signed char OPENAL_Init(int mixrate, int maxsoftwarechannels, unsigned int flags);
  93     AL_API void OPENAL_Close();
  94     AL_API OPENAL_SAMPLE *OPENAL_Sample_Load(int index, const char *name_or_data, unsigned int mode, int offset, int length);
  95     AL_API void OPENAL_Sample_Free(OPENAL_SAMPLE *sptr);
  96     AL_API signed char OPENAL_SetFrequency(int channel, int freq);
  97     AL_API signed char OPENAL_SetVolume(int channel, int vol);
  98     AL_API signed char OPENAL_SetPaused(int channel, signed char paused);
  99     AL_API void OPENAL_SetSFXMasterVolume(int volume);
 100     AL_API signed char OPENAL_StopSound(int channel);
 101     AL_API void OPENAL_Stream_Close(OPENAL_STREAM *stream);
 102     AL_API signed char OPENAL_Stream_SetMode(OPENAL_STREAM *stream, unsigned int mode);
 103     AL_API void OPENAL_Update();
 104     AL_API signed char OPENAL_SetOutput(int outputtype);
 105     void PlaySoundEx(int chan, OPENAL_SAMPLE *sptr, OPENAL_DSPUNIT *dsp, signed char startpaused);
 106     void PlayStreamEx(int chan, OPENAL_SAMPLE *sptr, OPENAL_DSPUNIT *dsp, signed char startpaused);
 107
 108 #ifdef __cplusplus
 109 }
 110 #endif
 111
 112 #endif