]> git.jsancho.org Git - lugaru.git/blob - Source/openal_wrapper.h
Add copyright notice and AUTHORS file for open source contributors
[lugaru.git] / 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, int freq);
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