2 Copyright (C) 2003, 2010 - Wolfire Games
4 This file is part of Lugaru.
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.
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.
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/>.
20 #ifndef OPENAL_WRAPPER_H
21 #define OPENAL_WRAPPER_H
31 #include "vorbis/vorbisfile.h"
33 #include "MacCompatibility.h"
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))
45 #if defined(_WIN32_WCE)
47 #define F_CALLBACKAPI _cdecl
49 #define AL_API __stdcall
50 #define F_CALLBACKAPI __stdcall
54 #define DLL_API __declspec(dllexport)
56 #if defined(__LCC__) || defined(__MINGW32__) || defined(__CYGWIN32__)
57 #define DLL_API AL_API
60 #endif /* __LCC__ || __MINGW32__ || __CYGWIN32__ */
61 #endif /* DLL_EXPORTS */
65 typedef struct OPENAL_SAMPLE OPENAL_SAMPLE;
66 typedef OPENAL_SAMPLE OPENAL_STREAM;
67 typedef struct OPENAL_DSPUNIT OPENAL_DSPUNIT;
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. */
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. */
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);