Dependencies/OpenAL/include/AL/al.h

   1 #ifndef AL_AL_H
   2 #define AL_AL_H
   3
   4 #if defined(__cplusplus)
   5 extern "C" {
   6 #endif
   7
   8 #if defined(_WIN32) && !defined(_XBOX)
   9  #if defined(AL_BUILD_LIBRARY)
  10   #define AL_API __declspec(dllexport)
  11  #else
  12   #define AL_API __declspec(dllimport)
  13  #endif
  14 #else
  15  #if defined(AL_BUILD_LIBRARY) && defined(HAVE_GCC_VISIBILITY)
  16   #define AL_API __attribute__((visibility("protected")))
  17  #else
  18   #define AL_API extern
  19  #endif
  20 #endif
  21
  22 #if defined(_WIN32)
  23  #define AL_APIENTRY __cdecl
  24 #else
  25  #define AL_APIENTRY
  26 #endif
  27
  28 #if defined(TARGET_OS_MAC) && TARGET_OS_MAC
  29  #pragma export on
  30 #endif
  31
  32 /*
  33  * The OPENAL, ALAPI, ALAPIENTRY, AL_INVALID, AL_ILLEGAL_ENUM, and
  34  * AL_ILLEGAL_COMMAND macros are deprecated, but are included for
  35  * applications porting code from AL 1.0
  36  */
  37 #define OPENAL
  38 #define ALAPI AL_API
  39 #define ALAPIENTRY AL_APIENTRY
  40 #define AL_INVALID                                (-1)
  41 #define AL_ILLEGAL_ENUM                           AL_INVALID_ENUM
  42 #define AL_ILLEGAL_COMMAND                        AL_INVALID_OPERATION
  43
  44 #define AL_VERSION_1_0
  45 #define AL_VERSION_1_1
  46
  47
  48 /** 8-bit boolean */
  49 typedef char ALboolean;
  50
  51 /** character */
  52 typedef char ALchar;
  53
  54 /** signed 8-bit 2's complement integer */
  55 typedef signed char ALbyte;
  56
  57 /** unsigned 8-bit integer */
  58 typedef unsigned char ALubyte;
  59
  60 /** signed 16-bit 2's complement integer */
  61 typedef short ALshort;
  62
  63 /** unsigned 16-bit integer */
  64 typedef unsigned short ALushort;
  65
  66 /** signed 32-bit 2's complement integer */
  67 typedef int ALint;
  68
  69 /** unsigned 32-bit integer */
  70 typedef unsigned int ALuint;
  71
  72 /** non-negative 32-bit binary integer size */
  73 typedef int ALsizei;
  74
  75 /** enumerated 32-bit value */
  76 typedef int ALenum;
  77
  78 /** 32-bit IEEE754 floating-point */
  79 typedef float ALfloat;
  80
  81 /** 64-bit IEEE754 floating-point */
  82 typedef double ALdouble;
  83
  84 /** void type (for opaque pointers only) */
  85 typedef void ALvoid;
  86
  87
  88 /* Enumerant values begin at column 50. No tabs. */
  89
  90 /* "no distance model" or "no buffer" */
  91 #define AL_NONE                                   0
  92
  93 /* Boolean False. */
  94 #define AL_FALSE                                  0
  95
  96 /** Boolean True. */
  97 #define AL_TRUE                                   1
  98
  99 /** Indicate Source has relative coordinates. */
 100 #define AL_SOURCE_RELATIVE                        0x202
 101
 102
 103
 104 /**
 105  * Directional source, inner cone angle, in degrees.
 106  * Range:    [0-360]
 107  * Default:  360
 108  */
 109 #define AL_CONE_INNER_ANGLE                       0x1001
 110
 111 /**
 112  * Directional source, outer cone angle, in degrees.
 113  * Range:    [0-360]
 114  * Default:  360
 115  */
 116 #define AL_CONE_OUTER_ANGLE                       0x1002
 117
 118 /**
 119  * Specify the pitch to be applied at source.
 120  * Range:   [0.5-2.0]
 121  * Default: 1.0
 122  */
 123 #define AL_PITCH                                  0x1003
 124
 125 /**
 126  * Specify the current location in three dimensional space.
 127  * OpenAL, like OpenGL, uses a right handed coordinate system,
 128  *  where in a frontal default view X (thumb) points right,
 129  *  Y points up (index finger), and Z points towards the
 130  *  viewer/camera (middle finger).
 131  * To switch from a left handed coordinate system, flip the
 132  *  sign on the Z coordinate.
 133  * Listener position is always in the world coordinate system.
 134  */
 135 #define AL_POSITION                               0x1004
 136
 137 /** Specify the current direction. */
 138 #define AL_DIRECTION                              0x1005
 139
 140 /** Specify the current velocity in three dimensional space. */
 141 #define AL_VELOCITY                               0x1006
 142
 143 /**
 144  * Indicate whether source is looping.
 145  * Type: ALboolean?
 146  * Range:   [AL_TRUE, AL_FALSE]
 147  * Default: FALSE.
 148  */
 149 #define AL_LOOPING                                0x1007
 150
 151 /**
 152  * Indicate the buffer to provide sound samples.
 153  * Type: ALuint.
 154  * Range: any valid Buffer id.
 155  */
 156 #define AL_BUFFER                                 0x1009
 157
 158 /**
 159  * Indicate the gain (volume amplification) applied.
 160  * Type:   ALfloat.
 161  * Range:  ]0.0-  ]
 162  * A value of 1.0 means un-attenuated/unchanged.
 163  * Each division by 2 equals an attenuation of -6dB.
 164  * Each multiplicaton with 2 equals an amplification of +6dB.
 165  * A value of 0.0 is meaningless with respect to a logarithmic
 166  *  scale; it is interpreted as zero volume - the channel
 167  *  is effectively disabled.
 168  */
 169 #define AL_GAIN                                   0x100A
 170
 171 /*
 172  * Indicate minimum source attenuation
 173  * Type: ALfloat
 174  * Range:  [0.0 - 1.0]
 175  *
 176  * Logarthmic
 177  */
 178 #define AL_MIN_GAIN                               0x100D
 179
 180 /**
 181  * Indicate maximum source attenuation
 182  * Type: ALfloat
 183  * Range:  [0.0 - 1.0]
 184  *
 185  * Logarthmic
 186  */
 187 #define AL_MAX_GAIN                               0x100E
 188
 189 /**
 190  * Indicate listener orientation.
 191  *
 192  * at/up
 193  */
 194 #define AL_ORIENTATION                            0x100F
 195
 196 /**
 197  * Source state information.
 198  */
 199 #define AL_SOURCE_STATE                           0x1010
 200 #define AL_INITIAL                                0x1011
 201 #define AL_PLAYING                                0x1012
 202 #define AL_PAUSED                                 0x1013
 203 #define AL_STOPPED                                0x1014
 204
 205 /**
 206  * Buffer Queue params
 207  */
 208 #define AL_BUFFERS_QUEUED                         0x1015
 209 #define AL_BUFFERS_PROCESSED                      0x1016
 210
 211 /**
 212  * Source buffer position information
 213  */
 214 #define AL_SEC_OFFSET                             0x1024
 215 #define AL_SAMPLE_OFFSET                          0x1025
 216 #define AL_BYTE_OFFSET                            0x1026
 217
 218 /*
 219  * Source type (Static, Streaming or undetermined)
 220  * Source is Static if a Buffer has been attached using AL_BUFFER
 221  * Source is Streaming if one or more Buffers have been attached using alSourceQueueBuffers
 222  * Source is undetermined when it has the NULL buffer attached
 223  */
 224 #define AL_SOURCE_TYPE                            0x1027
 225 #define AL_STATIC                                 0x1028
 226 #define AL_STREAMING                              0x1029
 227 #define AL_UNDETERMINED                           0x1030
 228
 229 /** Sound samples: format specifier. */
 230 #define AL_FORMAT_MONO8                           0x1100
 231 #define AL_FORMAT_MONO16                          0x1101
 232 #define AL_FORMAT_STEREO8                         0x1102
 233 #define AL_FORMAT_STEREO16                        0x1103
 234
 235 /**
 236  * source specific reference distance
 237  * Type: ALfloat
 238  * Range:  0.0 - +inf
 239  *
 240  * At 0.0, no distance attenuation occurs.  Default is
 241  * 1.0.
 242  */
 243 #define AL_REFERENCE_DISTANCE                     0x1020
 244
 245 /**
 246  * source specific rolloff factor
 247  * Type: ALfloat
 248  * Range:  0.0 - +inf
 249  *
 250  */
 251 #define AL_ROLLOFF_FACTOR                         0x1021
 252
 253 /**
 254  * Directional source, outer cone gain.
 255  *
 256  * Default:  0.0
 257  * Range:    [0.0 - 1.0]
 258  * Logarithmic
 259  */
 260 #define AL_CONE_OUTER_GAIN                        0x1022
 261
 262 /**
 263  * Indicate distance above which sources are not
 264  * attenuated using the inverse clamped distance model.
 265  *
 266  * Default: +inf
 267  * Type: ALfloat
 268  * Range:  0.0 - +inf
 269  */
 270 #define AL_MAX_DISTANCE                           0x1023
 271
 272 /**
 273  * Sound samples: frequency, in units of Hertz [Hz].
 274  * This is the number of samples per second. Half of the
 275  *  sample frequency marks the maximum significant
 276  *  frequency component.
 277  */
 278 #define AL_FREQUENCY                              0x2001
 279 #define AL_BITS                                   0x2002
 280 #define AL_CHANNELS                               0x2003
 281 #define AL_SIZE                                   0x2004
 282
 283 /**
 284  * Buffer state.
 285  *
 286  * Not supported for public use (yet).
 287  */
 288 #define AL_UNUSED                                 0x2010
 289 #define AL_PENDING                                0x2011
 290 #define AL_PROCESSED                              0x2012
 291
 292
 293 /** Errors: No Error. */
 294 #define AL_NO_ERROR                               AL_FALSE
 295
 296 /**
 297  * Invalid Name paramater passed to AL call.
 298  */
 299 #define AL_INVALID_NAME                           0xA001
 300
 301 /**
 302  * Invalid parameter passed to AL call.
 303  */
 304 #define AL_INVALID_ENUM                           0xA002
 305
 306 /**
 307  * Invalid enum parameter value.
 308  */
 309 #define AL_INVALID_VALUE                          0xA003
 310
 311 /**
 312  * Illegal call.
 313  */
 314 #define AL_INVALID_OPERATION                      0xA004
 315
 316
 317 /**
 318  * No mojo.
 319  */
 320 #define AL_OUT_OF_MEMORY                          0xA005
 321
 322
 323 /** Context strings: Vendor Name. */
 324 #define AL_VENDOR                                 0xB001
 325 #define AL_VERSION                                0xB002
 326 #define AL_RENDERER                               0xB003
 327 #define AL_EXTENSIONS                             0xB004
 328
 329 /** Global tweakage. */
 330
 331 /**
 332  * Doppler scale.  Default 1.0
 333  */
 334 #define AL_DOPPLER_FACTOR                         0xC000
 335
 336 /**
 337  * Tweaks speed of propagation.
 338  */
 339 #define AL_DOPPLER_VELOCITY                       0xC001
 340
 341 /**
 342  * Speed of Sound in units per second
 343  */
 344 #define AL_SPEED_OF_SOUND                         0xC003
 345
 346 /**
 347  * Distance models
 348  *
 349  * used in conjunction with DistanceModel
 350  *
 351  * implicit: NONE, which disances distance attenuation.
 352  */
 353 #define AL_DISTANCE_MODEL                         0xD000
 354 #define AL_INVERSE_DISTANCE                       0xD001
 355 #define AL_INVERSE_DISTANCE_CLAMPED               0xD002
 356 #define AL_LINEAR_DISTANCE                        0xD003
 357 #define AL_LINEAR_DISTANCE_CLAMPED                0xD004
 358 #define AL_EXPONENT_DISTANCE                      0xD005
 359 #define AL_EXPONENT_DISTANCE_CLAMPED              0xD006
 360
 361 /*
 362  * Renderer State management
 363  */
 364 AL_API void AL_APIENTRY alEnable( ALenum capability );
 365
 366 AL_API void AL_APIENTRY alDisable( ALenum capability );
 367
 368 AL_API ALboolean AL_APIENTRY alIsEnabled( ALenum capability );
 369
 370
 371 /*
 372  * State retrieval
 373  */
 374 AL_API const ALchar* AL_APIENTRY alGetString( ALenum param );
 375
 376 AL_API void AL_APIENTRY alGetBooleanv( ALenum param, ALboolean* data );
 377
 378 AL_API void AL_APIENTRY alGetIntegerv( ALenum param, ALint* data );
 379
 380 AL_API void AL_APIENTRY alGetFloatv( ALenum param, ALfloat* data );
 381
 382 AL_API void AL_APIENTRY alGetDoublev( ALenum param, ALdouble* data );
 383
 384 AL_API ALboolean AL_APIENTRY alGetBoolean( ALenum param );
 385
 386 AL_API ALint AL_APIENTRY alGetInteger( ALenum param );
 387
 388 AL_API ALfloat AL_APIENTRY alGetFloat( ALenum param );
 389
 390 AL_API ALdouble AL_APIENTRY alGetDouble( ALenum param );
 391
 392
 393 /*
 394  * Error support.
 395  * Obtain the most recent error generated in the AL state machine.
 396  */
 397 AL_API ALenum AL_APIENTRY alGetError( void );
 398
 399
 400 /*
 401  * Extension support.
 402  * Query for the presence of an extension, and obtain any appropriate
 403  * function pointers and enum values.
 404  */
 405 AL_API ALboolean AL_APIENTRY alIsExtensionPresent( const ALchar* extname );
 406
 407 AL_API void* AL_APIENTRY alGetProcAddress( const ALchar* fname );
 408
 409 AL_API ALenum AL_APIENTRY alGetEnumValue( const ALchar* ename );
 410
 411
 412 /*
 413  * LISTENER
 414  * Listener represents the location and orientation of the
 415  * 'user' in 3D-space.
 416  *
 417  * Properties include: -
 418  *
 419  * Gain         AL_GAIN         ALfloat
 420  * Position     AL_POSITION     ALfloat[3]
 421  * Velocity     AL_VELOCITY     ALfloat[3]
 422  * Orientation  AL_ORIENTATION  ALfloat[6] (Forward then Up vectors)
 423 */
 424
 425 /*
 426  * Set Listener parameters
 427  */
 428 AL_API void AL_APIENTRY alListenerf( ALenum param, ALfloat value );
 429
 430 AL_API void AL_APIENTRY alListener3f( ALenum param, ALfloat value1, ALfloat value2, ALfloat value3 );
 431
 432 AL_API void AL_APIENTRY alListenerfv( ALenum param, const ALfloat* values );
 433
 434 AL_API void AL_APIENTRY alListeneri( ALenum param, ALint value );
 435
 436 AL_API void AL_APIENTRY alListener3i( ALenum param, ALint value1, ALint value2, ALint value3 );
 437
 438 AL_API void AL_APIENTRY alListeneriv( ALenum param, const ALint* values );
 439
 440 /*
 441  * Get Listener parameters
 442  */
 443 AL_API void AL_APIENTRY alGetListenerf( ALenum param, ALfloat* value );
 444
 445 AL_API void AL_APIENTRY alGetListener3f( ALenum param, ALfloat *value1, ALfloat *value2, ALfloat *value3 );
 446
 447 AL_API void AL_APIENTRY alGetListenerfv( ALenum param, ALfloat* values );
 448
 449 AL_API void AL_APIENTRY alGetListeneri( ALenum param, ALint* value );
 450
 451 AL_API void AL_APIENTRY alGetListener3i( ALenum param, ALint *value1, ALint *value2, ALint *value3 );
 452
 453 AL_API void AL_APIENTRY alGetListeneriv( ALenum param, ALint* values );
 454
 455
 456 /**
 457  * SOURCE
 458  * Sources represent individual sound objects in 3D-space.
 459  * Sources take the PCM data provided in the specified Buffer,
 460  * apply Source-specific modifications, and then
 461  * submit them to be mixed according to spatial arrangement etc.
 462  *
 463  * Properties include: -
 464  *
 465  * Gain                              AL_GAIN                 ALfloat
 466  * Min Gain                          AL_MIN_GAIN             ALfloat
 467  * Max Gain                          AL_MAX_GAIN             ALfloat
 468  * Position                          AL_POSITION             ALfloat[3]
 469  * Velocity                          AL_VELOCITY             ALfloat[3]
 470  * Direction                         AL_DIRECTION            ALfloat[3]
 471  * Head Relative Mode                AL_SOURCE_RELATIVE      ALint (AL_TRUE or AL_FALSE)
 472  * Reference Distance                AL_REFERENCE_DISTANCE   ALfloat
 473  * Max Distance                      AL_MAX_DISTANCE         ALfloat
 474  * RollOff Factor                    AL_ROLLOFF_FACTOR       ALfloat
 475  * Inner Angle                       AL_CONE_INNER_ANGLE     ALint or ALfloat
 476  * Outer Angle                       AL_CONE_OUTER_ANGLE     ALint or ALfloat
 477  * Cone Outer Gain                   AL_CONE_OUTER_GAIN      ALint or ALfloat
 478  * Pitch                             AL_PITCH                ALfloat
 479  * Looping                           AL_LOOPING              ALint (AL_TRUE or AL_FALSE)
 480  * MS Offset                         AL_MSEC_OFFSET          ALint or ALfloat
 481  * Byte Offset                       AL_BYTE_OFFSET          ALint or ALfloat
 482  * Sample Offset                     AL_SAMPLE_OFFSET        ALint or ALfloat
 483  * Attached Buffer                   AL_BUFFER               ALint
 484  * State (Query only)                AL_SOURCE_STATE         ALint
 485  * Buffers Queued (Query only)       AL_BUFFERS_QUEUED       ALint
 486  * Buffers Processed (Query only)    AL_BUFFERS_PROCESSED    ALint
 487  */
 488
 489 /* Create Source objects */
 490 AL_API void AL_APIENTRY alGenSources( ALsizei n, ALuint* sources );
 491
 492 /* Delete Source objects */
 493 AL_API void AL_APIENTRY alDeleteSources( ALsizei n, const ALuint* sources );
 494
 495 /* Verify a handle is a valid Source */
 496 AL_API ALboolean AL_APIENTRY alIsSource( ALuint sid );
 497
 498 /*
 499  * Set Source parameters
 500  */
 501 AL_API void AL_APIENTRY alSourcef( ALuint sid, ALenum param, ALfloat value );
 502
 503 AL_API void AL_APIENTRY alSource3f( ALuint sid, ALenum param, ALfloat value1, ALfloat value2, ALfloat value3 );
 504
 505 AL_API void AL_APIENTRY alSourcefv( ALuint sid, ALenum param, const ALfloat* values );
 506
 507 AL_API void AL_APIENTRY alSourcei( ALuint sid, ALenum param, ALint value );
 508
 509 AL_API void AL_APIENTRY alSource3i( ALuint sid, ALenum param, ALint value1, ALint value2, ALint value3 );
 510
 511 AL_API void AL_APIENTRY alSourceiv( ALuint sid, ALenum param, const ALint* values );
 512
 513 /*
 514  * Get Source parameters
 515  */
 516 AL_API void AL_APIENTRY alGetSourcef( ALuint sid, ALenum param, ALfloat* value );
 517
 518 AL_API void AL_APIENTRY alGetSource3f( ALuint sid, ALenum param, ALfloat* value1, ALfloat* value2, ALfloat* value3);
 519
 520 AL_API void AL_APIENTRY alGetSourcefv( ALuint sid, ALenum param, ALfloat* values );
 521
 522 AL_API void AL_APIENTRY alGetSourcei( ALuint sid,  ALenum param, ALint* value );
 523
 524 AL_API void AL_APIENTRY alGetSource3i( ALuint sid, ALenum param, ALint* value1, ALint* value2, ALint* value3);
 525
 526 AL_API void AL_APIENTRY alGetSourceiv( ALuint sid,  ALenum param, ALint* values );
 527
 528
 529 /*
 530  * Source vector based playback calls
 531  */
 532
 533 /* Play, replay, or resume (if paused) a list of Sources */
 534 AL_API void AL_APIENTRY alSourcePlayv( ALsizei ns, const ALuint *sids );
 535
 536 /* Stop a list of Sources */
 537 AL_API void AL_APIENTRY alSourceStopv( ALsizei ns, const ALuint *sids );
 538
 539 /* Rewind a list of Sources */
 540 AL_API void AL_APIENTRY alSourceRewindv( ALsizei ns, const ALuint *sids );
 541
 542 /* Pause a list of Sources */
 543 AL_API void AL_APIENTRY alSourcePausev( ALsizei ns, const ALuint *sids );
 544
 545 /*
 546  * Source based playback calls
 547  */
 548
 549 /* Play, replay, or resume a Source */
 550 AL_API void AL_APIENTRY alSourcePlay( ALuint sid );
 551
 552 /* Stop a Source */
 553 AL_API void AL_APIENTRY alSourceStop( ALuint sid );
 554
 555 /* Rewind a Source (set playback postiton to beginning) */
 556 AL_API void AL_APIENTRY alSourceRewind( ALuint sid );
 557
 558 /* Pause a Source */
 559 AL_API void AL_APIENTRY alSourcePause( ALuint sid );
 560
 561 /*
 562  * Source Queuing
 563  */
 564 AL_API void AL_APIENTRY alSourceQueueBuffers( ALuint sid, ALsizei numEntries, const ALuint *bids );
 565
 566 AL_API void AL_APIENTRY alSourceUnqueueBuffers( ALuint sid, ALsizei numEntries, ALuint *bids );
 567
 568
 569 /**
 570  * BUFFER
 571  * Buffer objects are storage space for sample data.
 572  * Buffers are referred to by Sources. One Buffer can be used
 573  * by multiple Sources.
 574  *
 575  * Properties include: -
 576  *
 577  * Frequency (Query only)    AL_FREQUENCY      ALint
 578  * Size (Query only)         AL_SIZE           ALint
 579  * Bits (Query only)         AL_BITS           ALint
 580  * Channels (Query only)     AL_CHANNELS       ALint
 581  */
 582
 583 /* Create Buffer objects */
 584 AL_API void AL_APIENTRY alGenBuffers( ALsizei n, ALuint* buffers );
 585
 586 /* Delete Buffer objects */
 587 AL_API void AL_APIENTRY alDeleteBuffers( ALsizei n, const ALuint* buffers );
 588
 589 /* Verify a handle is a valid Buffer */
 590 AL_API ALboolean AL_APIENTRY alIsBuffer( ALuint bid );
 591
 592 /* Specify the data to be copied into a buffer */
 593 AL_API void AL_APIENTRY alBufferData( ALuint bid, ALenum format, const ALvoid* data, ALsizei size, ALsizei freq );
 594
 595 /*
 596  * Set Buffer parameters
 597  */
 598 AL_API void AL_APIENTRY alBufferf( ALuint bid, ALenum param, ALfloat value );
 599
 600 AL_API void AL_APIENTRY alBuffer3f( ALuint bid, ALenum param, ALfloat value1, ALfloat value2, ALfloat value3 );
 601
 602 AL_API void AL_APIENTRY alBufferfv( ALuint bid, ALenum param, const ALfloat* values );
 603
 604 AL_API void AL_APIENTRY alBufferi( ALuint bid, ALenum param, ALint value );
 605
 606 AL_API void AL_APIENTRY alBuffer3i( ALuint bid, ALenum param, ALint value1, ALint value2, ALint value3 );
 607
 608 AL_API void AL_APIENTRY alBufferiv( ALuint bid, ALenum param, const ALint* values );
 609
 610 /*
 611  * Get Buffer parameters
 612  */
 613 AL_API void AL_APIENTRY alGetBufferf( ALuint bid, ALenum param, ALfloat* value );
 614
 615 AL_API void AL_APIENTRY alGetBuffer3f( ALuint bid, ALenum param, ALfloat* value1, ALfloat* value2, ALfloat* value3);
 616
 617 AL_API void AL_APIENTRY alGetBufferfv( ALuint bid, ALenum param, ALfloat* values );
 618
 619 AL_API void AL_APIENTRY alGetBufferi( ALuint bid, ALenum param, ALint* value );
 620
 621 AL_API void AL_APIENTRY alGetBuffer3i( ALuint bid, ALenum param, ALint* value1, ALint* value2, ALint* value3);
 622
 623 AL_API void AL_APIENTRY alGetBufferiv( ALuint bid, ALenum param, ALint* values );
 624
 625
 626 /*
 627  * Global Parameters
 628  */
 629 AL_API void AL_APIENTRY alDopplerFactor( ALfloat value );
 630
 631 AL_API void AL_APIENTRY alDopplerVelocity( ALfloat value );
 632
 633 AL_API void AL_APIENTRY alSpeedOfSound( ALfloat value );
 634
 635 AL_API void AL_APIENTRY alDistanceModel( ALenum distanceModel );
 636
 637 /*
 638  * Pointer-to-function types, useful for dynamically getting AL entry points.
 639  */
 640 typedef void           (AL_APIENTRY *LPALENABLE)( ALenum capability );
 641 typedef void           (AL_APIENTRY *LPALDISABLE)( ALenum capability );
 642 typedef ALboolean      (AL_APIENTRY *LPALISENABLED)( ALenum capability );
 643 typedef const ALchar*  (AL_APIENTRY *LPALGETSTRING)( ALenum param );
 644 typedef void           (AL_APIENTRY *LPALGETBOOLEANV)( ALenum param, ALboolean* data );
 645 typedef void           (AL_APIENTRY *LPALGETINTEGERV)( ALenum param, ALint* data );
 646 typedef void           (AL_APIENTRY *LPALGETFLOATV)( ALenum param, ALfloat* data );
 647 typedef void           (AL_APIENTRY *LPALGETDOUBLEV)( ALenum param, ALdouble* data );
 648 typedef ALboolean      (AL_APIENTRY *LPALGETBOOLEAN)( ALenum param );
 649 typedef ALint          (AL_APIENTRY *LPALGETINTEGER)( ALenum param );
 650 typedef ALfloat        (AL_APIENTRY *LPALGETFLOAT)( ALenum param );
 651 typedef ALdouble       (AL_APIENTRY *LPALGETDOUBLE)( ALenum param );
 652 typedef ALenum         (AL_APIENTRY *LPALGETERROR)( void );
 653 typedef ALboolean      (AL_APIENTRY *LPALISEXTENSIONPRESENT)(const ALchar* extname );
 654 typedef void*          (AL_APIENTRY *LPALGETPROCADDRESS)( const ALchar* fname );
 655 typedef ALenum         (AL_APIENTRY *LPALGETENUMVALUE)( const ALchar* ename );
 656 typedef void           (AL_APIENTRY *LPALLISTENERF)( ALenum param, ALfloat value );
 657 typedef void           (AL_APIENTRY *LPALLISTENER3F)( ALenum param, ALfloat value1, ALfloat value2, ALfloat value3 );
 658 typedef void           (AL_APIENTRY *LPALLISTENERFV)( ALenum param, const ALfloat* values );
 659 typedef void           (AL_APIENTRY *LPALLISTENERI)( ALenum param, ALint value );
 660 typedef void           (AL_APIENTRY *LPALLISTENER3I)( ALenum param, ALint value1, ALint value2, ALint value3 );
 661 typedef void           (AL_APIENTRY *LPALLISTENERIV)( ALenum param, const ALint* values );
 662 typedef void           (AL_APIENTRY *LPALGETLISTENERF)( ALenum param, ALfloat* value );
 663 typedef void           (AL_APIENTRY *LPALGETLISTENER3F)( ALenum param, ALfloat *value1, ALfloat *value2, ALfloat *value3 );
 664 typedef void           (AL_APIENTRY *LPALGETLISTENERFV)( ALenum param, ALfloat* values );
 665 typedef void           (AL_APIENTRY *LPALGETLISTENERI)( ALenum param, ALint* value );
 666 typedef void           (AL_APIENTRY *LPALGETLISTENER3I)( ALenum param, ALint *value1, ALint *value2, ALint *value3 );
 667 typedef void           (AL_APIENTRY *LPALGETLISTENERIV)( ALenum param, ALint* values );
 668 typedef void           (AL_APIENTRY *LPALGENSOURCES)( ALsizei n, ALuint* sources );
 669 typedef void           (AL_APIENTRY *LPALDELETESOURCES)( ALsizei n, const ALuint* sources );
 670 typedef ALboolean      (AL_APIENTRY *LPALISSOURCE)( ALuint sid );
 671 typedef void           (AL_APIENTRY *LPALSOURCEF)( ALuint sid, ALenum param, ALfloat value);
 672 typedef void           (AL_APIENTRY *LPALSOURCE3F)( ALuint sid, ALenum param, ALfloat value1, ALfloat value2, ALfloat value3 );
 673 typedef void           (AL_APIENTRY *LPALSOURCEFV)( ALuint sid, ALenum param, const ALfloat* values );
 674 typedef void           (AL_APIENTRY *LPALSOURCEI)( ALuint sid, ALenum param, ALint value);
 675 typedef void           (AL_APIENTRY *LPALSOURCE3I)( ALuint sid, ALenum param, ALint value1, ALint value2, ALint value3 );
 676 typedef void           (AL_APIENTRY *LPALSOURCEIV)( ALuint sid, ALenum param, const ALint* values );
 677 typedef void           (AL_APIENTRY *LPALGETSOURCEF)( ALuint sid, ALenum param, ALfloat* value );
 678 typedef void           (AL_APIENTRY *LPALGETSOURCE3F)( ALuint sid, ALenum param, ALfloat* value1, ALfloat* value2, ALfloat* value3);
 679 typedef void           (AL_APIENTRY *LPALGETSOURCEFV)( ALuint sid, ALenum param, ALfloat* values );
 680 typedef void           (AL_APIENTRY *LPALGETSOURCEI)( ALuint sid, ALenum param, ALint* value );
 681 typedef void           (AL_APIENTRY *LPALGETSOURCE3I)( ALuint sid, ALenum param, ALint* value1, ALint* value2, ALint* value3);
 682 typedef void           (AL_APIENTRY *LPALGETSOURCEIV)( ALuint sid, ALenum param, ALint* values );
 683 typedef void           (AL_APIENTRY *LPALSOURCEPLAYV)( ALsizei ns, const ALuint *sids );
 684 typedef void           (AL_APIENTRY *LPALSOURCESTOPV)( ALsizei ns, const ALuint *sids );
 685 typedef void           (AL_APIENTRY *LPALSOURCEREWINDV)( ALsizei ns, const ALuint *sids );
 686 typedef void           (AL_APIENTRY *LPALSOURCEPAUSEV)( ALsizei ns, const ALuint *sids );
 687 typedef void           (AL_APIENTRY *LPALSOURCEPLAY)( ALuint sid );
 688 typedef void           (AL_APIENTRY *LPALSOURCESTOP)( ALuint sid );
 689 typedef void           (AL_APIENTRY *LPALSOURCEREWIND)( ALuint sid );
 690 typedef void           (AL_APIENTRY *LPALSOURCEPAUSE)( ALuint sid );
 691 typedef void           (AL_APIENTRY *LPALSOURCEQUEUEBUFFERS)(ALuint sid, ALsizei numEntries, const ALuint *bids );
 692 typedef void           (AL_APIENTRY *LPALSOURCEUNQUEUEBUFFERS)(ALuint sid, ALsizei numEntries, ALuint *bids );
 693 typedef void           (AL_APIENTRY *LPALGENBUFFERS)( ALsizei n, ALuint* buffers );
 694 typedef void           (AL_APIENTRY *LPALDELETEBUFFERS)( ALsizei n, const ALuint* buffers );
 695 typedef ALboolean      (AL_APIENTRY *LPALISBUFFER)( ALuint bid );
 696 typedef void           (AL_APIENTRY *LPALBUFFERDATA)( ALuint bid, ALenum format, const ALvoid* data, ALsizei size, ALsizei freq );
 697 typedef void           (AL_APIENTRY *LPALBUFFERF)( ALuint bid, ALenum param, ALfloat value);
 698 typedef void           (AL_APIENTRY *LPALBUFFER3F)( ALuint bid, ALenum param, ALfloat value1, ALfloat value2, ALfloat value3 );
 699 typedef void           (AL_APIENTRY *LPALBUFFERFV)( ALuint bid, ALenum param, const ALfloat* values );
 700 typedef void           (AL_APIENTRY *LPALBUFFERI)( ALuint bid, ALenum param, ALint value);
 701 typedef void           (AL_APIENTRY *LPALBUFFER3I)( ALuint bid, ALenum param, ALint value1, ALint value2, ALint value3 );
 702 typedef void           (AL_APIENTRY *LPALBUFFERIV)( ALuint bid, ALenum param, const ALint* values );
 703 typedef void           (AL_APIENTRY *LPALGETBUFFERF)( ALuint bid, ALenum param, ALfloat* value );
 704 typedef void           (AL_APIENTRY *LPALGETBUFFER3F)( ALuint bid, ALenum param, ALfloat* value1, ALfloat* value2, ALfloat* value3);
 705 typedef void           (AL_APIENTRY *LPALGETBUFFERFV)( ALuint bid, ALenum param, ALfloat* values );
 706 typedef void           (AL_APIENTRY *LPALGETBUFFERI)( ALuint bid, ALenum param, ALint* value );
 707 typedef void           (AL_APIENTRY *LPALGETBUFFER3I)( ALuint bid, ALenum param, ALint* value1, ALint* value2, ALint* value3);
 708 typedef void           (AL_APIENTRY *LPALGETBUFFERIV)( ALuint bid, ALenum param, ALint* values );
 709 typedef void           (AL_APIENTRY *LPALDOPPLERFACTOR)( ALfloat value );
 710 typedef void           (AL_APIENTRY *LPALDOPPLERVELOCITY)( ALfloat value );
 711 typedef void           (AL_APIENTRY *LPALSPEEDOFSOUND)( ALfloat value );
 712 typedef void           (AL_APIENTRY *LPALDISTANCEMODEL)( ALenum distanceModel );
 713
 714 #if defined(TARGET_OS_MAC) && TARGET_OS_MAC
 715  #pragma export off
 716 #endif
 717
 718 #if defined(__cplusplus)
 719 }  /* extern "C" */
 720 #endif
 721
 722 #endif /* AL_AL_H */