include/AL/alext.h

   1 /**
   2  * OpenAL cross platform audio library
   3  * Copyright (C) 2008 by authors.
   4  * This library is free software; you can redistribute it and/or
   5  *  modify it under the terms of the GNU Library General Public
   6  *  License as published by the Free Software Foundation; either
   7  *  version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  *  Library General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Library General Public
  15  *  License along with this library; if not, write to the
  16  *  Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17  *  Boston, MA  02111-1307, USA.
  18  * Or go to http://www.gnu.org/copyleft/lgpl.html
  19  */
  20
  21 #ifndef AL_ALEXT_H
  22 #define AL_ALEXT_H
  23
  24 #include <stddef.h>
  25 /* Define int64_t and uint64_t types */
  26 #if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L
  27 #include <inttypes.h>
  28 #elif defined(_WIN32) && defined(__GNUC__)
  29 #include <stdint.h>
  30 #elif defined(_WIN32)
  31 typedef __int64 int64_t;
  32 typedef unsigned __int64 uint64_t;
  33 #else
  34 /* Fallback if nothing above works */
  35 #include <inttypes.h>
  36 #endif
  37
  38 #include "alc.h"
  39 #include "al.h"
  40
  41 #ifdef __cplusplus
  42 extern "C" {
  43 #endif
  44
  45 #ifndef AL_LOKI_IMA_ADPCM_format
  46 #define AL_LOKI_IMA_ADPCM_format 1
  47 #define AL_FORMAT_IMA_ADPCM_MONO16_EXT           0x10000
  48 #define AL_FORMAT_IMA_ADPCM_STEREO16_EXT         0x10001
  49 #endif
  50
  51 #ifndef AL_LOKI_WAVE_format
  52 #define AL_LOKI_WAVE_format 1
  53 #define AL_FORMAT_WAVE_EXT                       0x10002
  54 #endif
  55
  56 #ifndef AL_EXT_vorbis
  57 #define AL_EXT_vorbis 1
  58 #define AL_FORMAT_VORBIS_EXT                     0x10003
  59 #endif
  60
  61 #ifndef AL_LOKI_quadriphonic
  62 #define AL_LOKI_quadriphonic 1
  63 #define AL_FORMAT_QUAD8_LOKI                     0x10004
  64 #define AL_FORMAT_QUAD16_LOKI                    0x10005
  65 #endif
  66
  67 #ifndef AL_EXT_float32
  68 #define AL_EXT_float32 1
  69 #define AL_FORMAT_MONO_FLOAT32                   0x10010
  70 #define AL_FORMAT_STEREO_FLOAT32                 0x10011
  71 #endif
  72
  73 #ifndef AL_EXT_double
  74 #define AL_EXT_double 1
  75 #define AL_FORMAT_MONO_DOUBLE_EXT                0x10012
  76 #define AL_FORMAT_STEREO_DOUBLE_EXT              0x10013
  77 #endif
  78
  79 #ifndef AL_EXT_MULAW
  80 #define AL_EXT_MULAW 1
  81 #define AL_FORMAT_MONO_MULAW_EXT                 0x10014
  82 #define AL_FORMAT_STEREO_MULAW_EXT               0x10015
  83 #endif
  84
  85 #ifndef AL_EXT_ALAW
  86 #define AL_EXT_ALAW 1
  87 #define AL_FORMAT_MONO_ALAW_EXT                  0x10016
  88 #define AL_FORMAT_STEREO_ALAW_EXT                0x10017
  89 #endif
  90
  91 #ifndef ALC_LOKI_audio_channel
  92 #define ALC_LOKI_audio_channel 1
  93 #define ALC_CHAN_MAIN_LOKI                       0x500001
  94 #define ALC_CHAN_PCM_LOKI                        0x500002
  95 #define ALC_CHAN_CD_LOKI                         0x500003
  96 #endif
  97
  98 #ifndef AL_EXT_MCFORMATS
  99 #define AL_EXT_MCFORMATS 1
 100 #define AL_FORMAT_QUAD8                          0x1204
 101 #define AL_FORMAT_QUAD16                         0x1205
 102 #define AL_FORMAT_QUAD32                         0x1206
 103 #define AL_FORMAT_REAR8                          0x1207
 104 #define AL_FORMAT_REAR16                         0x1208
 105 #define AL_FORMAT_REAR32                         0x1209
 106 #define AL_FORMAT_51CHN8                         0x120A
 107 #define AL_FORMAT_51CHN16                        0x120B
 108 #define AL_FORMAT_51CHN32                        0x120C
 109 #define AL_FORMAT_61CHN8                         0x120D
 110 #define AL_FORMAT_61CHN16                        0x120E
 111 #define AL_FORMAT_61CHN32                        0x120F
 112 #define AL_FORMAT_71CHN8                         0x1210
 113 #define AL_FORMAT_71CHN16                        0x1211
 114 #define AL_FORMAT_71CHN32                        0x1212
 115 #endif
 116
 117 #ifndef AL_EXT_MULAW_MCFORMATS
 118 #define AL_EXT_MULAW_MCFORMATS 1
 119 #define AL_FORMAT_MONO_MULAW                     0x10014
 120 #define AL_FORMAT_STEREO_MULAW                   0x10015
 121 #define AL_FORMAT_QUAD_MULAW                     0x10021
 122 #define AL_FORMAT_REAR_MULAW                     0x10022
 123 #define AL_FORMAT_51CHN_MULAW                    0x10023
 124 #define AL_FORMAT_61CHN_MULAW                    0x10024
 125 #define AL_FORMAT_71CHN_MULAW                    0x10025
 126 #endif
 127
 128 #ifndef AL_EXT_IMA4
 129 #define AL_EXT_IMA4 1
 130 #define AL_FORMAT_MONO_IMA4                      0x1300
 131 #define AL_FORMAT_STEREO_IMA4                    0x1301
 132 #endif
 133
 134 #ifndef AL_EXT_STATIC_BUFFER
 135 #define AL_EXT_STATIC_BUFFER 1
 136 typedef ALvoid (AL_APIENTRY*PFNALBUFFERDATASTATICPROC)(const ALint,ALenum,ALvoid*,ALsizei,ALsizei);
 137 #ifdef AL_ALEXT_PROTOTYPES
 138 AL_API ALvoid AL_APIENTRY alBufferDataStatic(const ALint buffer, ALenum format, ALvoid *data, ALsizei len, ALsizei freq);
 139 #endif
 140 #endif
 141
 142 #ifndef ALC_EXT_EFX
 143 #define ALC_EXT_EFX 1
 144 #include "efx.h"
 145 #endif
 146
 147 #ifndef ALC_EXT_disconnect
 148 #define ALC_EXT_disconnect 1
 149 #define ALC_CONNECTED                            0x313
 150 #endif
 151
 152 #ifndef ALC_EXT_thread_local_context
 153 #define ALC_EXT_thread_local_context 1
 154 typedef ALCboolean  (ALC_APIENTRY*PFNALCSETTHREADCONTEXTPROC)(ALCcontext *context);
 155 typedef ALCcontext* (ALC_APIENTRY*PFNALCGETTHREADCONTEXTPROC)(void);
 156 #ifdef AL_ALEXT_PROTOTYPES
 157 ALC_API ALCboolean  ALC_APIENTRY alcSetThreadContext(ALCcontext *context);
 158 ALC_API ALCcontext* ALC_APIENTRY alcGetThreadContext(void);
 159 #endif
 160 #endif
 161
 162 #ifndef AL_EXT_source_distance_model
 163 #define AL_EXT_source_distance_model 1
 164 #define AL_SOURCE_DISTANCE_MODEL                 0x200
 165 #endif
 166
 167 #ifndef AL_SOFT_buffer_sub_data
 168 #define AL_SOFT_buffer_sub_data 1
 169 #define AL_BYTE_RW_OFFSETS_SOFT                  0x1031
 170 #define AL_SAMPLE_RW_OFFSETS_SOFT                0x1032
 171 typedef ALvoid (AL_APIENTRY*PFNALBUFFERSUBDATASOFTPROC)(ALuint,ALenum,const ALvoid*,ALsizei,ALsizei);
 172 #ifdef AL_ALEXT_PROTOTYPES
 173 AL_API ALvoid AL_APIENTRY alBufferSubDataSOFT(ALuint buffer,ALenum format,const ALvoid *data,ALsizei offset,ALsizei length);
 174 #endif
 175 #endif
 176
 177 #ifndef AL_SOFT_loop_points
 178 #define AL_SOFT_loop_points 1
 179 #define AL_LOOP_POINTS_SOFT                      0x2015
 180 #endif
 181
 182 #ifndef AL_EXT_FOLDBACK
 183 #define AL_EXT_FOLDBACK 1
 184 #define AL_EXT_FOLDBACK_NAME                     "AL_EXT_FOLDBACK"
 185 #define AL_FOLDBACK_EVENT_BLOCK                  0x4112
 186 #define AL_FOLDBACK_EVENT_START                  0x4111
 187 #define AL_FOLDBACK_EVENT_STOP                   0x4113
 188 #define AL_FOLDBACK_MODE_MONO                    0x4101
 189 #define AL_FOLDBACK_MODE_STEREO                  0x4102
 190 typedef void (AL_APIENTRY*LPALFOLDBACKCALLBACK)(ALenum,ALsizei);
 191 typedef void (AL_APIENTRY*LPALREQUESTFOLDBACKSTART)(ALenum,ALsizei,ALsizei,ALfloat*,LPALFOLDBACKCALLBACK);
 192 typedef void (AL_APIENTRY*LPALREQUESTFOLDBACKSTOP)(void);
 193 #ifdef AL_ALEXT_PROTOTYPES
 194 AL_API void AL_APIENTRY alRequestFoldbackStart(ALenum mode,ALsizei count,ALsizei length,ALfloat *mem,LPALFOLDBACKCALLBACK callback);
 195 AL_API void AL_APIENTRY alRequestFoldbackStop(void);
 196 #endif
 197 #endif
 198
 199 #ifndef ALC_EXT_DEDICATED
 200 #define ALC_EXT_DEDICATED 1
 201 #define AL_DEDICATED_GAIN                        0x0001
 202 #define AL_EFFECT_DEDICATED_DIALOGUE             0x9001
 203 #define AL_EFFECT_DEDICATED_LOW_FREQUENCY_EFFECT 0x9000
 204 #endif
 205
 206 #ifndef AL_SOFT_buffer_samples
 207 #define AL_SOFT_buffer_samples 1
 208 /* Channel configurations */
 209 #define AL_MONO_SOFT                             0x1500
 210 #define AL_STEREO_SOFT                           0x1501
 211 #define AL_REAR_SOFT                             0x1502
 212 #define AL_QUAD_SOFT                             0x1503
 213 #define AL_5POINT1_SOFT                          0x1504
 214 #define AL_6POINT1_SOFT                          0x1505
 215 #define AL_7POINT1_SOFT                          0x1506
 216
 217 /* Sample types */
 218 #define AL_BYTE_SOFT                             0x1400
 219 #define AL_UNSIGNED_BYTE_SOFT                    0x1401
 220 #define AL_SHORT_SOFT                            0x1402
 221 #define AL_UNSIGNED_SHORT_SOFT                   0x1403
 222 #define AL_INT_SOFT                              0x1404
 223 #define AL_UNSIGNED_INT_SOFT                     0x1405
 224 #define AL_FLOAT_SOFT                            0x1406
 225 #define AL_DOUBLE_SOFT                           0x1407
 226 #define AL_BYTE3_SOFT                            0x1408
 227 #define AL_UNSIGNED_BYTE3_SOFT                   0x1409
 228
 229 /* Storage formats */
 230 #define AL_MONO8_SOFT                            0x1100
 231 #define AL_MONO16_SOFT                           0x1101
 232 #define AL_MONO32F_SOFT                          0x10010
 233 #define AL_STEREO8_SOFT                          0x1102
 234 #define AL_STEREO16_SOFT                         0x1103
 235 #define AL_STEREO32F_SOFT                        0x10011
 236 #define AL_QUAD8_SOFT                            0x1204
 237 #define AL_QUAD16_SOFT                           0x1205
 238 #define AL_QUAD32F_SOFT                          0x1206
 239 #define AL_REAR8_SOFT                            0x1207
 240 #define AL_REAR16_SOFT                           0x1208
 241 #define AL_REAR32F_SOFT                          0x1209
 242 #define AL_5POINT1_8_SOFT                        0x120A
 243 #define AL_5POINT1_16_SOFT                       0x120B
 244 #define AL_5POINT1_32F_SOFT                      0x120C
 245 #define AL_6POINT1_8_SOFT                        0x120D
 246 #define AL_6POINT1_16_SOFT                       0x120E
 247 #define AL_6POINT1_32F_SOFT                      0x120F
 248 #define AL_7POINT1_8_SOFT                        0x1210
 249 #define AL_7POINT1_16_SOFT                       0x1211
 250 #define AL_7POINT1_32F_SOFT                      0x1212
 251
 252 /* Buffer attributes */
 253 #define AL_INTERNAL_FORMAT_SOFT                  0x2008
 254 #define AL_BYTE_LENGTH_SOFT                      0x2009
 255 #define AL_SAMPLE_LENGTH_SOFT                    0x200A
 256 #define AL_SEC_LENGTH_SOFT                       0x200B
 257
 258 typedef void (AL_APIENTRY*LPALBUFFERSAMPLESSOFT)(ALuint,ALuint,ALenum,ALsizei,ALenum,ALenum,const ALvoid*);
 259 typedef void (AL_APIENTRY*LPALBUFFERSUBSAMPLESSOFT)(ALuint,ALsizei,ALsizei,ALenum,ALenum,const ALvoid*);
 260 typedef void (AL_APIENTRY*LPALGETBUFFERSAMPLESSOFT)(ALuint,ALsizei,ALsizei,ALenum,ALenum,ALvoid*);
 261 typedef ALboolean (AL_APIENTRY*LPALISBUFFERFORMATSUPPORTEDSOFT)(ALenum);
 262 #ifdef AL_ALEXT_PROTOTYPES
 263 AL_API void AL_APIENTRY alBufferSamplesSOFT(ALuint buffer, ALuint samplerate, ALenum internalformat, ALsizei samples, ALenum channels, ALenum type, const ALvoid *data);
 264 AL_API void AL_APIENTRY alBufferSubSamplesSOFT(ALuint buffer, ALsizei offset, ALsizei samples, ALenum channels, ALenum type, const ALvoid *data);
 265 AL_API void AL_APIENTRY alGetBufferSamplesSOFT(ALuint buffer, ALsizei offset, ALsizei samples, ALenum channels, ALenum type, ALvoid *data);
 266 AL_API ALboolean AL_APIENTRY alIsBufferFormatSupportedSOFT(ALenum format);
 267 #endif
 268 #endif
 269
 270 #ifndef AL_SOFT_direct_channels
 271 #define AL_SOFT_direct_channels 1
 272 #define AL_DIRECT_CHANNELS_SOFT                  0x1033
 273 #endif
 274
 275 #ifndef ALC_SOFT_loopback
 276 #define ALC_SOFT_loopback 1
 277 #define ALC_FORMAT_CHANNELS_SOFT                 0x1990
 278 #define ALC_FORMAT_TYPE_SOFT                     0x1991
 279
 280 /* Sample types */
 281 #define ALC_BYTE_SOFT                            0x1400
 282 #define ALC_UNSIGNED_BYTE_SOFT                   0x1401
 283 #define ALC_SHORT_SOFT                           0x1402
 284 #define ALC_UNSIGNED_SHORT_SOFT                  0x1403
 285 #define ALC_INT_SOFT                             0x1404
 286 #define ALC_UNSIGNED_INT_SOFT                    0x1405
 287 #define ALC_FLOAT_SOFT                           0x1406
 288
 289 /* Channel configurations */
 290 #define ALC_MONO_SOFT                            0x1500
 291 #define ALC_STEREO_SOFT                          0x1501
 292 #define ALC_QUAD_SOFT                            0x1503
 293 #define ALC_5POINT1_SOFT                         0x1504
 294 #define ALC_6POINT1_SOFT                         0x1505
 295 #define ALC_7POINT1_SOFT                         0x1506
 296
 297 typedef ALCdevice* (ALC_APIENTRY*LPALCLOOPBACKOPENDEVICESOFT)(const ALCchar*);
 298 typedef ALCboolean (ALC_APIENTRY*LPALCISRENDERFORMATSUPPORTEDSOFT)(ALCdevice*,ALCsizei,ALCenum,ALCenum);
 299 typedef void (ALC_APIENTRY*LPALCRENDERSAMPLESSOFT)(ALCdevice*,ALCvoid*,ALCsizei);
 300 #ifdef AL_ALEXT_PROTOTYPES
 301 ALC_API ALCdevice* ALC_APIENTRY alcLoopbackOpenDeviceSOFT(const ALCchar *deviceName);
 302 ALC_API ALCboolean ALC_APIENTRY alcIsRenderFormatSupportedSOFT(ALCdevice *device, ALCsizei freq, ALCenum channels, ALCenum type);
 303 ALC_API void ALC_APIENTRY alcRenderSamplesSOFT(ALCdevice *device, ALCvoid *buffer, ALCsizei samples);
 304 #endif
 305 #endif
 306
 307 #ifndef AL_EXT_STEREO_ANGLES
 308 #define AL_EXT_STEREO_ANGLES 1
 309 #define AL_STEREO_ANGLES                         0x1030
 310 #endif
 311
 312 #ifndef AL_EXT_SOURCE_RADIUS
 313 #define AL_EXT_SOURCE_RADIUS 1
 314 #define AL_SOURCE_RADIUS                         0x1031
 315 #endif
 316
 317 #ifndef AL_SOFT_source_latency
 318 #define AL_SOFT_source_latency 1
 319 #define AL_SAMPLE_OFFSET_LATENCY_SOFT            0x1200
 320 #define AL_SEC_OFFSET_LATENCY_SOFT               0x1201
 321 typedef int64_t ALint64SOFT;
 322 typedef uint64_t ALuint64SOFT;
 323 typedef void (AL_APIENTRY*LPALSOURCEDSOFT)(ALuint,ALenum,ALdouble);
 324 typedef void (AL_APIENTRY*LPALSOURCE3DSOFT)(ALuint,ALenum,ALdouble,ALdouble,ALdouble);
 325 typedef void (AL_APIENTRY*LPALSOURCEDVSOFT)(ALuint,ALenum,const ALdouble*);
 326 typedef void (AL_APIENTRY*LPALGETSOURCEDSOFT)(ALuint,ALenum,ALdouble*);
 327 typedef void (AL_APIENTRY*LPALGETSOURCE3DSOFT)(ALuint,ALenum,ALdouble*,ALdouble*,ALdouble*);
 328 typedef void (AL_APIENTRY*LPALGETSOURCEDVSOFT)(ALuint,ALenum,ALdouble*);
 329 typedef void (AL_APIENTRY*LPALSOURCEI64SOFT)(ALuint,ALenum,ALint64SOFT);
 330 typedef void (AL_APIENTRY*LPALSOURCE3I64SOFT)(ALuint,ALenum,ALint64SOFT,ALint64SOFT,ALint64SOFT);
 331 typedef void (AL_APIENTRY*LPALSOURCEI64VSOFT)(ALuint,ALenum,const ALint64SOFT*);
 332 typedef void (AL_APIENTRY*LPALGETSOURCEI64SOFT)(ALuint,ALenum,ALint64SOFT*);
 333 typedef void (AL_APIENTRY*LPALGETSOURCE3I64SOFT)(ALuint,ALenum,ALint64SOFT*,ALint64SOFT*,ALint64SOFT*);
 334 typedef void (AL_APIENTRY*LPALGETSOURCEI64VSOFT)(ALuint,ALenum,ALint64SOFT*);
 335 #ifdef AL_ALEXT_PROTOTYPES
 336 AL_API void AL_APIENTRY alSourcedSOFT(ALuint source, ALenum param, ALdouble value);
 337 AL_API void AL_APIENTRY alSource3dSOFT(ALuint source, ALenum param, ALdouble value1, ALdouble value2, ALdouble value3);
 338 AL_API void AL_APIENTRY alSourcedvSOFT(ALuint source, ALenum param, const ALdouble *values);
 339 AL_API void AL_APIENTRY alGetSourcedSOFT(ALuint source, ALenum param, ALdouble *value);
 340 AL_API void AL_APIENTRY alGetSource3dSOFT(ALuint source, ALenum param, ALdouble *value1, ALdouble *value2, ALdouble *value3);
 341 AL_API void AL_APIENTRY alGetSourcedvSOFT(ALuint source, ALenum param, ALdouble *values);
 342 AL_API void AL_APIENTRY alSourcei64SOFT(ALuint source, ALenum param, ALint64SOFT value);
 343 AL_API void AL_APIENTRY alSource3i64SOFT(ALuint source, ALenum param, ALint64SOFT value1, ALint64SOFT value2, ALint64SOFT value3);
 344 AL_API void AL_APIENTRY alSourcei64vSOFT(ALuint source, ALenum param, const ALint64SOFT *values);
 345 AL_API void AL_APIENTRY alGetSourcei64SOFT(ALuint source, ALenum param, ALint64SOFT *value);
 346 AL_API void AL_APIENTRY alGetSource3i64SOFT(ALuint source, ALenum param, ALint64SOFT *value1, ALint64SOFT *value2, ALint64SOFT *value3);
 347 AL_API void AL_APIENTRY alGetSourcei64vSOFT(ALuint source, ALenum param, ALint64SOFT *values);
 348 #endif
 349 #endif
 350
 351 #ifdef __cplusplus
 352 }
 353 #endif
 354
 355 #endif