Source/openal_wrapper.h

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