]> git.jsancho.org Git - lugaru.git/blobdiff - Dependencies/OpenAL/include/AL/al.h
Something screwy with internal headers, replaced them with headers from OpenAL-Soft
[lugaru.git] / Dependencies / OpenAL / include / AL / al.h
index 522cc5fc701adc6a8a30e8f894e8791f81957cf3..c409701f022af53b09a33a19b644a58d3a4f0d4f 100644 (file)
-#ifndef __al_h_
-#define __al_h_
+#ifndef AL_AL_H
+#define AL_AL_H
 
-/**
- * OpenAL cross platform audio library
- * Copyright (C) 1999-2000 by authors.
- * This library is free software; you can redistribute it and/or
- *  modify it under the terms of the GNU Library General Public
- *  License as published by the Free Software Foundation; either
- *  version 2 of the License, or (at your option) any later version.
- *
- * This library is distributed in the hope that it will be useful,
- *  but WITHOUT ANY WARRANTY; without even the implied warranty of
- *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- *  Library General Public License for more details.
- *
- * You should have received a copy of the GNU Library General Public
- *  License along with this library; if not, write to the
- *  Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- *  Boston, MA  02111-1307, USA.
- * Or go to http://www.gnu.org/copyleft/lgpl.html
- */
-#include "altypes.h"
-
-#ifdef __cplusplus
+#if defined(__cplusplus)
 extern "C" {
 #endif
 
-#ifdef _WIN32
-#define ALAPI       __declspec(dllexport)
-#define ALAPIENTRY  __cdecl
-#define AL_CALLBACK 
-#else /* _WIN32 */
-
-#ifdef TARGET_OS_MAC
-#if TARGET_OS_MAC
-#pragma export on
-#endif /* TARGET_OS_MAC */
-#endif /* TARGET_OS_MAC */
-
-#ifndef ALAPI
-#define ALAPI
+#if defined(_WIN32) && !defined(_XBOX)
+ #if defined(AL_BUILD_LIBRARY)
+  #define AL_API __declspec(dllexport)
+ #else
+  #define AL_API __declspec(dllimport)
+ #endif
+#else
+ #if defined(AL_BUILD_LIBRARY) && defined(HAVE_GCC_VISIBILITY)
+  #define AL_API __attribute__((visibility("protected")))
+ #else
+  #define AL_API extern
+ #endif
 #endif
 
-#ifndef ALAPIENTRY
-#define ALAPIENTRY
+#if defined(_WIN32)
+ #define AL_APIENTRY __cdecl
+#else
+ #define AL_APIENTRY
 #endif
 
-#ifndef CALLBACK
-#define AL_CALLBACK 
+#if defined(TARGET_OS_MAC) && TARGET_OS_MAC
+ #pragma export on
 #endif
 
-#endif /* _WIN32 */
+/*
+ * The OPENAL, ALAPI, ALAPIENTRY, AL_INVALID, AL_ILLEGAL_ENUM, and
+ * AL_ILLEGAL_COMMAND macros are deprecated, but are included for
+ * applications porting code from AL 1.0
+ */
+#define OPENAL
+#define ALAPI AL_API
+#define ALAPIENTRY AL_APIENTRY
+#define AL_INVALID                                (-1)
+#define AL_ILLEGAL_ENUM                           AL_INVALID_ENUM
+#define AL_ILLEGAL_COMMAND                        AL_INVALID_OPERATION
 
-#ifndef AL_NO_PROTOTYPES
+#define AL_VERSION_1_0
+#define AL_VERSION_1_1
 
-/**
- * OpenAL Maintenance Functions
- * State Management and Query.
- * Error Handling.
- * Extension Support.
- */
 
+/** 8-bit boolean */
+typedef char ALboolean;
 
-/** Renderer State management. */
-ALAPI void ALAPIENTRY alEnable( ALenum capability );
+/** character */
+typedef char ALchar;
 
-ALAPI void ALAPIENTRY alDisable( ALenum capability ); 
+/** signed 8-bit 2's complement integer */
+typedef signed char ALbyte;
 
-ALAPI ALboolean ALAPIENTRY alIsEnabled( ALenum capability ); 
+/** unsigned 8-bit integer */
+typedef unsigned char ALubyte;
 
-/** Application preferences for driver performance choices. */
-ALAPI void ALAPIENTRY alHint( ALenum target, ALenum mode );
+/** signed 16-bit 2's complement integer */
+typedef short ALshort;
 
-/** State retrieval. */
-ALAPI void ALAPIENTRY alGetBooleanv( ALenum param, ALboolean* data );
+/** unsigned 16-bit integer */
+typedef unsigned short ALushort;
 
-/** State retrieval. */
-ALAPI void ALAPIENTRY alGetIntegerv( ALenum param, ALint* data );
+/** signed 32-bit 2's complement integer */
+typedef int ALint;
 
-/** State retrieval. */
-ALAPI void ALAPIENTRY alGetFloatv( ALenum param, ALfloat* data );
+/** unsigned 32-bit integer */
+typedef unsigned int ALuint;
 
-/** State retrieval. */
-ALAPI void ALAPIENTRY alGetDoublev( ALenum param, ALdouble* data );
+/** non-negative 32-bit binary integer size */
+typedef int ALsizei;
 
-/** State retrieval. */
-ALAPI const ALubyte* ALAPIENTRY alGetString( ALenum param );
+/** enumerated 32-bit value */
+typedef int ALenum;
+
+/** 32-bit IEEE754 floating-point */
+typedef float ALfloat;
+
+/** 64-bit IEEE754 floating-point */
+typedef double ALdouble;
+
+/** void type (for opaque pointers only) */
+typedef void ALvoid;
+
+
+/* Enumerant values begin at column 50. No tabs. */
+
+/* "no distance model" or "no buffer" */
+#define AL_NONE                                   0
+
+/* Boolean False. */
+#define AL_FALSE                                  0
+
+/** Boolean True. */
+#define AL_TRUE                                   1
+
+/** Indicate Source has relative coordinates. */
+#define AL_SOURCE_RELATIVE                        0x202
 
 
-/** State retrieval.through return value ( for compatibility ) */
-ALAPI ALboolean ALAPIENTRY alGetBoolean( ALenum param );
-ALAPI ALint ALAPIENTRY alGetInteger( ALenum param );
-ALAPI ALfloat ALAPIENTRY alGetFloat( ALenum param );
-ALAPI ALdouble ALAPIENTRY alGetDouble( ALenum param );
 
 /**
- * Error support.
- * Obtain the most recent error generated in the AL state machine.
+ * Directional source, inner cone angle, in degrees.
+ * Range:    [0-360] 
+ * Default:  360
  */
-ALAPI ALenum ALAPIENTRY alGetError( ALvoid );
+#define AL_CONE_INNER_ANGLE                       0x1001
 
-/** 
- * Extension support.
- * Obtain the address of a function (usually an extension)
- *  with the name fname. All addresses are context-independent. 
+/**
+ * Directional source, outer cone angle, in degrees.
+ * Range:    [0-360] 
+ * Default:  360
  */
-ALAPI ALboolean ALAPIENTRY alIsExtensionPresent( const ALubyte* fname );
-
+#define AL_CONE_OUTER_ANGLE                       0x1002
 
-/** 
- * Extension support.
- * Obtain the address of a function (usually an extension)
- *  with the name fname. All addresses are context-independent. 
+/**
+ * Specify the pitch to be applied at source.
+ * Range:   [0.5-2.0]
+ * Default: 1.0
  */
-ALAPI void* ALAPIENTRY alGetProcAddress( const ALubyte* fname );
+#define AL_PITCH                                  0x1003
+  
+/** 
+ * Specify the current location in three dimensional space.
+ * OpenAL, like OpenGL, uses a right handed coordinate system,
+ *  where in a frontal default view X (thumb) points right, 
+ *  Y points up (index finger), and Z points towards the
+ *  viewer/camera (middle finger). 
+ * To switch from a left handed coordinate system, flip the
+ *  sign on the Z coordinate.
+ * Listener position is always in the world coordinate system.
+ */ 
+#define AL_POSITION                               0x1004
+  
+/** Specify the current direction. */
+#define AL_DIRECTION                              0x1005
+  
+/** Specify the current velocity in three dimensional space. */
+#define AL_VELOCITY                               0x1006
 
+/**
+ * Indicate whether source is looping.
+ * Type: ALboolean?
+ * Range:   [AL_TRUE, AL_FALSE]
+ * Default: FALSE.
+ */
+#define AL_LOOPING                                0x1007
 
 /**
- * Extension support.
- * Obtain the integer value of an enumeration (usually an extension) with the name ename. 
+ * Indicate the buffer to provide sound samples. 
+ * Type: ALuint.
+ * Range: any valid Buffer id.
+ */
+#define AL_BUFFER                                 0x1009
+  
+/**
+ * Indicate the gain (volume amplification) applied. 
+ * Type:   ALfloat.
+ * Range:  ]0.0-  ]
+ * A value of 1.0 means un-attenuated/unchanged.
+ * Each division by 2 equals an attenuation of -6dB.
+ * Each multiplicaton with 2 equals an amplification of +6dB.
+ * A value of 0.0 is meaningless with respect to a logarithmic
+ *  scale; it is interpreted as zero volume - the channel
+ *  is effectively disabled.
  */
-ALAPI ALenum ALAPIENTRY alGetEnumValue( const ALubyte* ename );
+#define AL_GAIN                                   0x100A
 
+/*
+ * Indicate minimum source attenuation
+ * Type: ALfloat
+ * Range:  [0.0 - 1.0]
+ *
+ * Logarthmic
+ */
+#define AL_MIN_GAIN                               0x100D
 
+/**
+ * Indicate maximum source attenuation
+ * Type: ALfloat
+ * Range:  [0.0 - 1.0]
+ *
+ * Logarthmic
+ */
+#define AL_MAX_GAIN                               0x100E
 
+/**
+ * Indicate listener orientation.
+ *
+ * at/up 
+ */
+#define AL_ORIENTATION                            0x100F
 
+/**
+ * Source state information.
+ */
+#define AL_SOURCE_STATE                           0x1010
+#define AL_INITIAL                                0x1011
+#define AL_PLAYING                                0x1012
+#define AL_PAUSED                                 0x1013
+#define AL_STOPPED                                0x1014
 
+/**
+ * Buffer Queue params
+ */
+#define AL_BUFFERS_QUEUED                         0x1015
+#define AL_BUFFERS_PROCESSED                      0x1016
 
 /**
- * LISTENER
- * Listener is the sample position for a given context.
- * The multi-channel (usually stereo) output stream generated
- *  by the mixer is parametrized by this Listener object:
- *  its position and velocity relative to Sources, within
- *  occluder and reflector geometry.
+ * Source buffer position information
  */
+#define AL_SEC_OFFSET                             0x1024
+#define AL_SAMPLE_OFFSET                          0x1025
+#define AL_BYTE_OFFSET                            0x1026
 
+/*
+ * Source type (Static, Streaming or undetermined)
+ * Source is Static if a Buffer has been attached using AL_BUFFER
+ * Source is Streaming if one or more Buffers have been attached using alSourceQueueBuffers
+ * Source is undetermined when it has the NULL buffer attached
+ */
+#define AL_SOURCE_TYPE                            0x1027
+#define AL_STATIC                                 0x1028
+#define AL_STREAMING                              0x1029
+#define AL_UNDETERMINED                           0x1030
 
+/** Sound samples: format specifier. */
+#define AL_FORMAT_MONO8                           0x1100
+#define AL_FORMAT_MONO16                          0x1101
+#define AL_FORMAT_STEREO8                         0x1102
+#define AL_FORMAT_STEREO16                        0x1103
 
 /**
+ * source specific reference distance
+ * Type: ALfloat
+ * Range:  0.0 - +inf
  *
- * Listener Gain:  default 1.0f.
+ * At 0.0, no distance attenuation occurs.  Default is
+ * 1.0.
  */
-ALAPI void ALAPIENTRY alListenerf( ALenum pname, ALfloat param );
-
-ALAPI void ALAPIENTRY alListeneri( ALenum pname, ALint param );
+#define AL_REFERENCE_DISTANCE                     0x1020
 
 /**
+ * source specific rolloff factor
+ * Type: ALfloat
+ * Range:  0.0 - +inf
  *
- * Listener Position:        ALfloat[3]
- * Listener Velocity:        ALfloat[3]
  */
-ALAPI void ALAPIENTRY alListener3f( ALenum pname,
-                                   ALfloat f1, ALfloat f2, ALfloat f3 ); 
+#define AL_ROLLOFF_FACTOR                         0x1021
 
 /**
+ * Directional source, outer cone gain.
  *
- * Listener Position:        ALfloat[3]
- * Listener Velocity:        ALfloat[3]
- * Listener Orientation:     ALfloat[6]  (forward and up vector).
+ * Default:  0.0
+ * Range:    [0.0 - 1.0]
+ * Logarithmic
  */
-ALAPI void ALAPIENTRY alListenerfv( ALenum pname, ALfloat* param ); 
+#define AL_CONE_OUTER_GAIN                        0x1022
 
-/*
- * Retrieve listener information.
+/**
+ * Indicate distance above which sources are not
+ * attenuated using the inverse clamped distance model.
+ *
+ * Default: +inf
+ * Type: ALfloat
+ * Range:  0.0 - +inf
  */
-ALAPI void ALAPIENTRY alGetListeneri( ALenum pname, ALint* value );
-ALAPI void ALAPIENTRY alGetListenerf( ALenum pname, ALfloat* value );
-
-ALAPI void ALAPIENTRY alGetListeneriv( ALenum pname, ALint* value );
-ALAPI void ALAPIENTRY alGetListenerfv( ALenum pname, ALfloat* values );
+#define AL_MAX_DISTANCE                           0x1023
 
-ALAPI void ALAPIENTRY alGetListener3f( ALenum pname,
-                                      ALfloat *f1, ALfloat *f2, ALfloat *f3 ); 
+/** 
+ * Sound samples: frequency, in units of Hertz [Hz].
+ * This is the number of samples per second. Half of the
+ *  sample frequency marks the maximum significant
+ *  frequency component.
+ */
+#define AL_FREQUENCY                              0x2001
+#define AL_BITS                                   0x2002
+#define AL_CHANNELS                               0x2003
+#define AL_SIZE                                   0x2004
 
 /**
- * SOURCE
- * Source objects are by default localized. Sources
- *  take the PCM data provided in the specified Buffer,
- *  apply Source-specific modifications, and then
- *  submit them to be mixed according to spatial 
- *  arrangement etc.
+ * Buffer state.
+ *
+ * Not supported for public use (yet).
  */
+#define AL_UNUSED                                 0x2010
+#define AL_PENDING                                0x2011
+#define AL_PROCESSED                              0x2012
 
 
+/** Errors: No Error. */
+#define AL_NO_ERROR                               AL_FALSE
 
-/** Create Source objects. */
-ALAPI void ALAPIENTRY alGenSources( ALsizei n, ALuint* sources ); 
-
-/** Delete Source objects. */
-ALAPI void ALAPIENTRY alDeleteSources( ALsizei n, ALuint* sources );
+/** 
+ * Invalid Name paramater passed to AL call.
+ */
+#define AL_INVALID_NAME                           0xA001
 
-/** Verify a handle is a valid Source. */ 
-ALAPI ALboolean ALAPIENTRY alIsSource( ALuint sid ); 
+/** 
+ * Invalid parameter passed to AL call.
+ */
+#define AL_INVALID_ENUM                           0xA002
 
+/** 
+ * Invalid enum parameter value.
+ */
+#define AL_INVALID_VALUE                          0xA003
 
-/** Set an integer parameter for a Source object. */
-ALAPI void ALAPIENTRY alSourcei( ALuint sid, ALenum param, ALint value ); 
-ALAPI void ALAPIENTRY alSourcef( ALuint sid, ALenum param, ALfloat value ); 
-ALAPI void ALAPIENTRY alSource3f( ALuint sid, ALenum param,
-                                  ALfloat f1, ALfloat f2, ALfloat f3 );
-ALAPI void ALAPIENTRY alSourcefv( ALuint sid, ALenum param, ALfloat* values ); 
+/** 
+ * Illegal call.
+ */
+#define AL_INVALID_OPERATION                      0xA004
 
-/** Get an integer parameter for a Source object. */
-ALAPI void ALAPIENTRY alGetSourcei( ALuint sid,  ALenum pname, ALint* value );
-ALAPI void ALAPIENTRY alGetSourceiv( ALuint sid,  ALenum pname, ALint* values );
-ALAPI void ALAPIENTRY alGetSourcef( ALuint sid, ALenum pname, ALfloat* value );
-ALAPI void ALAPIENTRY alGetSourcefv( ALuint sid, ALenum pname, ALfloat* values );
+  
+/**
+ * No mojo.
+ */
+#define AL_OUT_OF_MEMORY                          0xA005
 
-/* deprecated, included for Win compatibility */
-ALAPI void ALAPIENTRY alGetSource3f( ALuint sid, ALenum pname, ALfloat* value1,
-                                     ALfloat* value2, ALfloat* value3);
 
-ALAPI void ALAPIENTRY alSourcePlayv( ALsizei ns, ALuint *ids );
-ALAPI void ALAPIENTRY alSourceStopv( ALsizei ns, ALuint *ids );
-ALAPI void ALAPIENTRY alSourceRewindv( ALsizei ns, ALuint *ids );
-ALAPI void ALAPIENTRY alSourcePausev( ALsizei ns, ALuint *ids );
+/** Context strings: Vendor Name. */
+#define AL_VENDOR                                 0xB001
+#define AL_VERSION                                0xB002
+#define AL_RENDERER                               0xB003
+#define AL_EXTENSIONS                             0xB004
 
-/** Activate a source, start replay. */
-ALAPI void ALAPIENTRY alSourcePlay( ALuint sid );
+/** Global tweakage. */
 
 /**
- * Pause a source, 
- *  temporarily remove it from the mixer list.
+ * Doppler scale.  Default 1.0
  */
-ALAPI void ALAPIENTRY alSourcePause( ALuint sid );
+#define AL_DOPPLER_FACTOR                         0xC000
 
 /**
- * Rewind a source, 
- *  set the source to play at the beginning.
+ * Tweaks speed of propagation.
  */
-ALAPI void ALAPIENTRY alSourceRewind( ALuint sid );
+#define AL_DOPPLER_VELOCITY                       0xC001
 
 /**
- * Stop a source,
- *  temporarily remove it from the mixer list,
- *  and reset its internal state to pre-Play.
- * To remove a Source completely, it has to be
- *  deleted following Stop, or before Play.
+ * Speed of Sound in units per second
  */
-ALAPI void ALAPIENTRY alSourceStop( ALuint sid );
+#define AL_SPEED_OF_SOUND                         0xC003
 
 /**
- * BUFFER
- * Buffer objects are storage space for sample data.
- * Buffers are referred to by Sources. There can be more than
- *  one Source using the same Buffer data. If Buffers have
- *  to be duplicated on a per-Source basis, the driver has to
- *  take care of allocation, copying, and deallocation as well
- *  as propagating buffer data changes.
+ * Distance models
+ *
+ * used in conjunction with DistanceModel
+ *
+ * implicit: NONE, which disances distance attenuation.
  */
+#define AL_DISTANCE_MODEL                         0xD000
+#define AL_INVERSE_DISTANCE                       0xD001
+#define AL_INVERSE_DISTANCE_CLAMPED               0xD002
+#define AL_LINEAR_DISTANCE                        0xD003
+#define AL_LINEAR_DISTANCE_CLAMPED                0xD004
+#define AL_EXPONENT_DISTANCE                      0xD005
+#define AL_EXPONENT_DISTANCE_CLAMPED              0xD006
 
+/*
+ * Renderer State management
+ */
+AL_API void AL_APIENTRY alEnable( ALenum capability );
 
+AL_API void AL_APIENTRY alDisable( ALenum capability ); 
 
+AL_API ALboolean AL_APIENTRY alIsEnabled( ALenum capability ); 
 
-/** Buffer object generation. */
-ALAPI void ALAPIENTRY alGenBuffers( ALsizei n, ALuint* buffers );
 
-ALAPI void ALAPIENTRY alDeleteBuffers( ALsizei n, ALuint* buffers );
+/*
+ * State retrieval
+ */
+AL_API const ALchar* AL_APIENTRY alGetString( ALenum param );
 
+AL_API void AL_APIENTRY alGetBooleanv( ALenum param, ALboolean* data );
 
-ALAPI ALboolean ALAPIENTRY alIsBuffer( ALuint buffer );
+AL_API void AL_APIENTRY alGetIntegerv( ALenum param, ALint* data );
 
-/**
- * Specify the data to be filled into a buffer.
+AL_API void AL_APIENTRY alGetFloatv( ALenum param, ALfloat* data );
+
+AL_API void AL_APIENTRY alGetDoublev( ALenum param, ALdouble* data );
+
+AL_API ALboolean AL_APIENTRY alGetBoolean( ALenum param );
+
+AL_API ALint AL_APIENTRY alGetInteger( ALenum param );
+
+AL_API ALfloat AL_APIENTRY alGetFloat( ALenum param );
+
+AL_API ALdouble AL_APIENTRY alGetDouble( ALenum param );
+
+
+/*
+ * Error support.
+ * Obtain the most recent error generated in the AL state machine.
  */
-ALAPI void ALAPIENTRY alBufferData( ALuint   buffer,
-                   ALenum   format,
-                   ALvoid*    data,
-                   ALsizei  size,
-                   ALsizei  freq );
+AL_API ALenum AL_APIENTRY alGetError( void );
 
-ALAPI void ALAPIENTRY alGetBufferi( ALuint buffer, ALenum param, ALint*   value );
-ALAPI void ALAPIENTRY alGetBufferf( ALuint buffer, ALenum param, ALfloat* value );
-ALAPI void ALAPIENTRY alGetBufferiv( ALuint buffer, ALenum param, ALint *v);
-ALAPI void ALAPIENTRY alGetBufferfv( ALuint buffer, ALenum param, ALfloat *v);
 
+/* 
+ * Extension support.
+ * Query for the presence of an extension, and obtain any appropriate
+ * function pointers and enum values.
+ */
+AL_API ALboolean AL_APIENTRY alIsExtensionPresent( const ALchar* extname );
 
+AL_API void* AL_APIENTRY alGetProcAddress( const ALchar* fname );
 
-/**
- * Frequency Domain Filters are band filters.
- *  Attenuation in Media (distance based)
- *  Reflection Material
- *  Occlusion Material (separating surface)
+AL_API ALenum AL_APIENTRY alGetEnumValue( const ALchar* ename );
+
+
+/*
+ * LISTENER
+ * Listener represents the location and orientation of the
+ * 'user' in 3D-space.
  *
- * Temporal Domain Filters:
- *  Early Reflections
- *  Late Reverb 
+ * Properties include: -
  *
+ * Gain         AL_GAIN         ALfloat
+ * Position     AL_POSITION     ALfloat[3]
+ * Velocity     AL_VELOCITY     ALfloat[3]
+ * Orientation  AL_ORIENTATION  ALfloat[6] (Forward then Up vectors)
+*/
+
+/*
+ * Set Listener parameters
  */
+AL_API void AL_APIENTRY alListenerf( ALenum param, ALfloat value );
 
+AL_API void AL_APIENTRY alListener3f( ALenum param, ALfloat value1, ALfloat value2, ALfloat value3 );
 
+AL_API void AL_APIENTRY alListenerfv( ALenum param, const ALfloat* values ); 
 
+AL_API void AL_APIENTRY alListeneri( ALenum param, ALint value );
 
-/**
- * EXTENSION: IASIG Level 2 Environment.
- * Environment object generation.
- * This is an EXTension that describes the Environment/Reverb
- *  properties according to IASIG Level 2 specifications.
+AL_API void AL_APIENTRY alListener3i( ALenum param, ALint value1, ALint value2, ALint value3 );
+
+AL_API void AL_APIENTRY alListeneriv( ALenum param, const ALint* values );
+
+/*
+ * Get Listener parameters
  */
+AL_API void AL_APIENTRY alGetListenerf( ALenum param, ALfloat* value );
 
+AL_API void AL_APIENTRY alGetListener3f( ALenum param, ALfloat *value1, ALfloat *value2, ALfloat *value3 );
 
+AL_API void AL_APIENTRY alGetListenerfv( ALenum param, ALfloat* values );
 
+AL_API void AL_APIENTRY alGetListeneri( ALenum param, ALint* value );
+
+AL_API void AL_APIENTRY alGetListener3i( ALenum param, ALint *value1, ALint *value2, ALint *value3 );
+
+AL_API void AL_APIENTRY alGetListeneriv( ALenum param, ALint* values );
 
 
 /**
- * Allocate n environment ids and store them in the array environs.
- * Returns the number of environments actually allocated.
+ * SOURCE
+ * Sources represent individual sound objects in 3D-space.
+ * Sources take the PCM data provided in the specified Buffer,
+ * apply Source-specific modifications, and then
+ * submit them to be mixed according to spatial arrangement etc.
+ * 
+ * Properties include: -
+ *
+ * Gain                              AL_GAIN                 ALfloat
+ * Min Gain                          AL_MIN_GAIN             ALfloat
+ * Max Gain                          AL_MAX_GAIN             ALfloat
+ * Position                          AL_POSITION             ALfloat[3]
+ * Velocity                          AL_VELOCITY             ALfloat[3]
+ * Direction                         AL_DIRECTION            ALfloat[3]
+ * Head Relative Mode                AL_SOURCE_RELATIVE      ALint (AL_TRUE or AL_FALSE)
+ * Reference Distance                AL_REFERENCE_DISTANCE   ALfloat
+ * Max Distance                      AL_MAX_DISTANCE         ALfloat
+ * RollOff Factor                    AL_ROLLOFF_FACTOR       ALfloat
+ * Inner Angle                       AL_CONE_INNER_ANGLE     ALint or ALfloat
+ * Outer Angle                       AL_CONE_OUTER_ANGLE     ALint or ALfloat
+ * Cone Outer Gain                   AL_CONE_OUTER_GAIN      ALint or ALfloat
+ * Pitch                             AL_PITCH                ALfloat
+ * Looping                           AL_LOOPING              ALint (AL_TRUE or AL_FALSE)
+ * MS Offset                         AL_MSEC_OFFSET          ALint or ALfloat
+ * Byte Offset                       AL_BYTE_OFFSET          ALint or ALfloat
+ * Sample Offset                     AL_SAMPLE_OFFSET        ALint or ALfloat
+ * Attached Buffer                   AL_BUFFER               ALint
+ * State (Query only)                AL_SOURCE_STATE         ALint
+ * Buffers Queued (Query only)       AL_BUFFERS_QUEUED       ALint
+ * Buffers Processed (Query only)    AL_BUFFERS_PROCESSED    ALint
  */
-ALAPI ALsizei ALAPIENTRY alGenEnvironmentIASIG( ALsizei n, ALuint* environs );
 
-ALAPI void ALAPIENTRY alDeleteEnvironmentIASIG( ALsizei n, ALuint* environs );
+/* Create Source objects */
+AL_API void AL_APIENTRY alGenSources( ALsizei n, ALuint* sources ); 
 
-ALAPI ALboolean ALAPIENTRY alIsEnvironmentIASIG( ALuint environ );
+/* Delete Source objects */
+AL_API void AL_APIENTRY alDeleteSources( ALsizei n, const ALuint* sources );
 
-ALAPI void ALAPIENTRY alEnvironmentiIASIG( ALuint eid, ALenum param, ALint value );
+/* Verify a handle is a valid Source */ 
+AL_API ALboolean AL_APIENTRY alIsSource( ALuint sid ); 
 
-ALAPI void ALAPIENTRY alEnvironmentfIASIG( ALuint eid, ALenum param, ALfloat value );
+/*
+ * Set Source parameters
+ */
+AL_API void AL_APIENTRY alSourcef( ALuint sid, ALenum param, ALfloat value ); 
 
+AL_API void AL_APIENTRY alSource3f( ALuint sid, ALenum param, ALfloat value1, ALfloat value2, ALfloat value3 );
 
+AL_API void AL_APIENTRY alSourcefv( ALuint sid, ALenum param, const ALfloat* values ); 
 
-/**
- * Queue stuff
- */
-ALAPI void ALAPIENTRY alSourceQueueBuffers( ALuint sid, ALsizei numEntries, ALuint *bids );
-ALAPI void ALAPIENTRY alSourceUnqueueBuffers( ALuint sid, ALsizei numEntries, ALuint *bids );
-ALAPI void ALAPIENTRY alQueuei( ALuint sid, ALenum param, ALint value );
+AL_API void AL_APIENTRY alSourcei( ALuint sid, ALenum param, ALint value ); 
 
-/**
- * Knobs and dials
- */
-ALAPI void ALAPIENTRY alDopplerFactor( ALfloat value );
-ALAPI void ALAPIENTRY alDopplerVelocity( ALfloat value );
-ALAPI void ALAPIENTRY alDistanceModel( ALenum distanceModel );
-
-#else /* AL_NO_PROTOTYPES */
-
-
-/** OpenAL Maintenance Functions */
-
-      void                         (*alEnable)( ALenum capability );
-      void                         (*alDisable)( ALenum capability ); 
-      ALboolean                    (*alIsEnabled)( ALenum capability ); 
-      void                           (*alHint)( ALenum target, ALenum mode );
-      ALboolean                    (*alGetBoolean)( ALenum param );
-      ALint                        (*alGetInteger)( ALenum param );
-      ALfloat                      (*alGetFloat)( ALenum param );
-      ALdouble                     (*alGetDouble)( ALenum param );
-      void                         (*alGetBooleanv)( ALenum param,
-                                                      ALboolean* data );
-      void                         (*alGetIntegerv)( ALenum param,
-                                                      ALint* data );
-      void                         (*alGetFloatv)( ALenum param,
-                                                      ALfloat* data );
-      void                         (*alGetDoublev)( ALenum param,
-                                                      ALdouble* data );
-      const ALubyte*               (*GetString)( ALenum param );
-      ALenum                       (*alGetError)( ALvoid );
-
-      /** 
-       * Extension support.
-       * Query existance of extension
-       */
-      ALboolean                (*alIsExtensionPresent)(const ALubyte* fname );
-
-      /** 
-       * Extension support.
-       * Obtain the address of a function (usually an extension)
-       *  with the name fname. All addresses are context-independent. 
-       */
-      void*                (*alGetProcAddress)( const ALubyte* fname );
-      
-
-      /**
-       * Extension support.
-       * Obtain the integer value of an enumeration (usually an extension) with the name ename. 
-       */
-      ALenum                (*alGetEnumValue)( const ALubyte* ename );
+AL_API void AL_APIENTRY alSource3i( ALuint sid, ALenum param, ALint value1, ALint value2, ALint value3 );
 
-/**
- * LISTENER
- * Listener is the sample position for a given context.
- * The multi-channel (usually stereo) output stream generated
- *  by the mixer is parametrized by this Listener object:
- *  its position and velocity relative to Sources, within
- *  occluder and reflector geometry.
- */
-      /**
-       *
-       * Listener Gain:  default 1.0f.
-       */
-      void                (*alListenerf)( ALenum pname, ALfloat param );
-
-      /**
-       *
-       * Listener Position:        ALfloat[3]
-       * Listener Velocity:        ALfloat[3]
-       * Listener Orientation:     ALfloat[6]  (forward and up vector).
-       */
-      void                (*alListenerfv)( ALenum pname, ALfloat* param ); 
-
-      /*
-       * Retrieve listener information.
-       */
-      void              (*alGetListeneri)( ALenum pname, ALint* value );
-      void              (*alGetListenerf)( ALenum pname, ALfloat* value );
-
-      void              (*alGetListeneriv)( ALenum pname, ALint* values );
-      void              (*alGetListenerfv)( ALenum pname, ALfloat* values );
+AL_API void AL_APIENTRY alSourceiv( ALuint sid, ALenum param, const ALint* values );
 
-/**
- * SOURCE
- * Source objects are by default localized. Sources
- *  take the PCM data provided in the specified Buffer,
- *  apply Source-specific modifications, and then
- *  submit them to be mixed according to spatial 
- *  arrangement etc.
+/*
+ * Get Source parameters
  */
+AL_API void AL_APIENTRY alGetSourcef( ALuint sid, ALenum param, ALfloat* value );
 
-      /** Create Source objects. */
-      void                (*alGenSources)( ALsizei n, ALuint* sources ); 
+AL_API void AL_APIENTRY alGetSource3f( ALuint sid, ALenum param, ALfloat* value1, ALfloat* value2, ALfloat* value3);
 
-      /** Delete Source objects. */
-      void                (*alDeleteSources)( ALsizei n, ALuint* sources );
+AL_API void AL_APIENTRY alGetSourcefv( ALuint sid, ALenum param, ALfloat* values );
 
-      /** Verify a handle is a valid Source. */ 
-      ALboolean        (*alIsSource)( ALuint sid ); 
+AL_API void AL_APIENTRY alGetSourcei( ALuint sid,  ALenum param, ALint* value );
 
-      /** Set an integer parameter for a Source object. */
-      void                (*alSourcei)( ALuint sid, ALenum param, ALint value); 
+AL_API void AL_APIENTRY alGetSource3i( ALuint sid, ALenum param, ALint* value1, ALint* value2, ALint* value3);
 
-      /** Set a float parameter for a Source object. */
-      void                (*alSourcef)( ALuint sid, ALenum param, ALfloat value); 
+AL_API void AL_APIENTRY alGetSourceiv( ALuint sid,  ALenum param, ALint* values );
 
-      /** Set a 3 float parameter for a Source object. */
-      void                (*alSource3f)( ALuint sid, ALenum param,
-                                  ALfloat f1, ALfloat f2, ALfloat f3 );
 
-      /** Set a float vector parameter for a Source object. */
-      void                (*alSourcefv)( ALuint sid, ALenum param,
-                              ALfloat* values ); 
+/*
+ * Source vector based playback calls
+ */
 
-      /** Get an integer scalar parameter for a Source object. */
-      void                (*alGetSourcei)( ALuint sid,
-                              ALenum pname, ALint* value );
+/* Play, replay, or resume (if paused) a list of Sources */
+AL_API void AL_APIENTRY alSourcePlayv( ALsizei ns, const ALuint *sids );
 
-      /** Get an integer parameter for a Source object. */
-      void                (*alGetSourceiv)( ALuint sid,
-                              ALenum pname, ALint* values );
+/* Stop a list of Sources */
+AL_API void AL_APIENTRY alSourceStopv( ALsizei ns, const ALuint *sids );
 
-      /** Get a float scalar parameter for a Source object. */
-      void                (*alGetSourcef)( ALuint sid,
-                              ALenum pname, ALfloat* value );
+/* Rewind a list of Sources */
+AL_API void AL_APIENTRY alSourceRewindv( ALsizei ns, const ALuint *sids );
 
-      /** Get three float scalar parameter for a Source object. */
-      void                (*alGetSource3f)( ALuint sid, ALenum pname,
-                                           ALfloat* value1,
-                                           ALfloat* value2,
-                                           ALfloat* value3);
+/* Pause a list of Sources */
+AL_API void AL_APIENTRY alSourcePausev( ALsizei ns, const ALuint *sids );
 
-      /** Get a float vector parameter for a Source object. */
-      void                (*alGetSourcefv)( ALuint sid,
-                              ALenum pname, ALfloat* values );
+/*
+ * Source based playback calls
+ */
 
-  
-      /** Activate a source, start replay. */
-      void                (*alSourcePlay)( ALuint sid );
-
-      /**
-       * Pause a source, 
-       *  temporarily remove it from the mixer list.
-       */
-      void                (*alSourcePause)( ALuint sid );
-
-      /**
-       * Stop a source,
-       *  temporarily remove it from the mixer list,
-       *  and reset its internal state to pre-Play.
-       * To remove a Source completely, it has to be
-       *  deleted following Stop, or before Play.
-       */
-      void                (*alSourceStop)( ALuint sid );
-
-      /**
-       * Rewind a souce.  Stopped paused and playing sources,
-       * resets the offset into the PCM data and sets state to
-       * AL_INITIAL.
-       */
-      void                (*alSourceRewind)( ALuint sid );
-
-      /**
-       * vector forms of those functions we all love
-       */
-      void                (*alSourcePlayv)( ALsizei ns, ALuint *ids );
-      void                (*alSourceStopv)( ALsizei ns, ALuint *ids );
-      void                (*alSourceRewindv)( ALsizei ns, ALuint *ids );
-      void                (*alSourcePausev)( ALsizei ns, ALuint *ids );
+/* Play, replay, or resume a Source */
+AL_API void AL_APIENTRY alSourcePlay( ALuint sid );
 
-/**
- * BUFFER
- * Buffer objects are storage space for sample data.
- * Buffers are referred to by Sources. There can be more than
- *  one Source using the same Buffer data. If Buffers have
- *  to be duplicated on a per-Source basis, the driver has to
- *  take care of allocation, copying, and deallocation as well
- *  as propagating buffer data changes.
- */
-
-      /** Buffer object generation. */
-      void                (*alGenBuffers)( ALsizei n, ALuint* buffers );
-      void                (*alDeleteBuffers)( ALsizei n, ALuint* buffers );
-      ALboolean           (*alIsBuffer)( ALuint buffer );
-
-      /**
-       * Specify the data to be filled into a buffer.
-       */
-      void                (*alBufferData)( ALuint   buffer,
-                                        ALenum   format,
-                                        ALvoid*    data,
-                                        ALsizei  size,
-                                        ALsizei  freq );
-
-      void                (*alGetBufferi)( ALuint buffer,
-                                      ALenum param, ALint*   value );
-      void                (*alGetBufferf)( ALuint buffer,
-                                      ALenum param, ALfloat* value );
-      void                (*alGetBufferiv)( ALuint buffer,
-                                      ALenum param, ALint*   value );
-      void                (*alGetBufferfv)( ALuint buffer,
-                                      ALenum param, ALfloat* value );
+/* Stop a Source */
+AL_API void AL_APIENTRY alSourceStop( ALuint sid );
+
+/* Rewind a Source (set playback postiton to beginning) */
+AL_API void AL_APIENTRY alSourceRewind( ALuint sid );
+
+/* Pause a Source */
+AL_API void AL_APIENTRY alSourcePause( ALuint sid );
+
+/*
+ * Source Queuing 
+ */
+AL_API void AL_APIENTRY alSourceQueueBuffers( ALuint sid, ALsizei numEntries, const ALuint *bids );
+
+AL_API void AL_APIENTRY alSourceUnqueueBuffers( ALuint sid, ALsizei numEntries, ALuint *bids );
 
-/**
- * EXTENSION: IASIG Level 2 Environment.
- * Environment object generation.
- * This is an EXTension that describes the Environment/Reverb
- *  properties according to IASIG Level 2 specifications.
- */
-      /**
-       * Allocate n environment ids and store them in the array environs.
-       * Returns the number of environments actually allocated.
-       */
-      ALsizei                (*alGenEnvironmentIASIG)( ALsizei n, ALuint* environs );
-      void                (*alDeleteEnvironmentIASIG)(ALsizei n,
-                                              ALuint* environs);
-      ALboolean                (*alIsEnvironmentIASIG)( ALuint environ );
-      void                (*alEnvironmentiIASIG)( ALuint eid,
-                                      ALenum param, ALint value );
-      void                (*alEnvironmentfIASIG)( ALuint eid,
-                                      ALenum param, ALuint value );
-      /**
-       * Queue stuff
-       */
-      void              (*alQueuei)(ALuint sid, ALenum param, ALint value );
-      void              (*alSourceUnqueueBuffers)(ALuint sid, ALsizei numEntries, ALuint *bids );
-      void              (*alSourceQueueBuffers)(ALuint sid, ALsizei numEntries, ALuint *bids );
-
-      void              (*alDopplerFactor)( ALfloat value );
-      void              (*alDopplerVelocity)( ALfloat value );
-      void              (*alDistanceModel)( ALenum distanceModel );
 
 /**
- * Frequency Domain Filters are band filters.
- *  Attenuation in Media (distance based)
- *  Reflection Material
- *  Occlusion Material (separating surface)
+ * BUFFER
+ * Buffer objects are storage space for sample data.
+ * Buffers are referred to by Sources. One Buffer can be used
+ * by multiple Sources.
  *
- * Temporal Domain Filters:
- *  Early Reflections
- *  Late Reverb 
+ * Properties include: -
  *
+ * Frequency (Query only)    AL_FREQUENCY      ALint
+ * Size (Query only)         AL_SIZE           ALint
+ * Bits (Query only)         AL_BITS           ALint
+ * Channels (Query only)     AL_CHANNELS       ALint
+ */
+
+/* Create Buffer objects */
+AL_API void AL_APIENTRY alGenBuffers( ALsizei n, ALuint* buffers );
+
+/* Delete Buffer objects */
+AL_API void AL_APIENTRY alDeleteBuffers( ALsizei n, const ALuint* buffers );
+
+/* Verify a handle is a valid Buffer */
+AL_API ALboolean AL_APIENTRY alIsBuffer( ALuint bid );
+
+/* Specify the data to be copied into a buffer */
+AL_API void AL_APIENTRY alBufferData( ALuint bid, ALenum format, const ALvoid* data, ALsizei size, ALsizei freq );
+
+/*
+ * Set Buffer parameters
  */
+AL_API void AL_APIENTRY alBufferf( ALuint bid, ALenum param, ALfloat value );
+
+AL_API void AL_APIENTRY alBuffer3f( ALuint bid, ALenum param, ALfloat value1, ALfloat value2, ALfloat value3 );
 
-#endif /* AL_NO_PROTOTYPES */
+AL_API void AL_APIENTRY alBufferfv( ALuint bid, ALenum param, const ALfloat* values );
 
-#ifdef TARGET_OS_MAC
-#if TARGET_OS_MAC
-#pragma export off
-#endif /* TARGET_OS_MAC */
-#endif /* TARGET_OS_MAC */
+AL_API void AL_APIENTRY alBufferi( ALuint bid, ALenum param, ALint value );
 
+AL_API void AL_APIENTRY alBuffer3i( ALuint bid, ALenum param, ALint value1, ALint value2, ALint value3 );
+
+AL_API void AL_APIENTRY alBufferiv( ALuint bid, ALenum param, const ALint* values );
+
+/*
+ * Get Buffer parameters
+ */
+AL_API void AL_APIENTRY alGetBufferf( ALuint bid, ALenum param, ALfloat* value );
+
+AL_API void AL_APIENTRY alGetBuffer3f( ALuint bid, ALenum param, ALfloat* value1, ALfloat* value2, ALfloat* value3);
+
+AL_API void AL_APIENTRY alGetBufferfv( ALuint bid, ALenum param, ALfloat* values );
+
+AL_API void AL_APIENTRY alGetBufferi( ALuint bid, ALenum param, ALint* value );
+
+AL_API void AL_APIENTRY alGetBuffer3i( ALuint bid, ALenum param, ALint* value1, ALint* value2, ALint* value3);
+
+AL_API void AL_APIENTRY alGetBufferiv( ALuint bid, ALenum param, ALint* values );
+
+
+/*
+ * Global Parameters
+ */
+AL_API void AL_APIENTRY alDopplerFactor( ALfloat value );
+
+AL_API void AL_APIENTRY alDopplerVelocity( ALfloat value );
+
+AL_API void AL_APIENTRY alSpeedOfSound( ALfloat value );
+
+AL_API void AL_APIENTRY alDistanceModel( ALenum distanceModel );
+
+/*
+ * Pointer-to-function types, useful for dynamically getting AL entry points.
+ */
+typedef void           (AL_APIENTRY *LPALENABLE)( ALenum capability );
+typedef void           (AL_APIENTRY *LPALDISABLE)( ALenum capability ); 
+typedef ALboolean      (AL_APIENTRY *LPALISENABLED)( ALenum capability ); 
+typedef const ALchar*  (AL_APIENTRY *LPALGETSTRING)( ALenum param );
+typedef void           (AL_APIENTRY *LPALGETBOOLEANV)( ALenum param, ALboolean* data );
+typedef void           (AL_APIENTRY *LPALGETINTEGERV)( ALenum param, ALint* data );
+typedef void           (AL_APIENTRY *LPALGETFLOATV)( ALenum param, ALfloat* data );
+typedef void           (AL_APIENTRY *LPALGETDOUBLEV)( ALenum param, ALdouble* data );
+typedef ALboolean      (AL_APIENTRY *LPALGETBOOLEAN)( ALenum param );
+typedef ALint          (AL_APIENTRY *LPALGETINTEGER)( ALenum param );
+typedef ALfloat        (AL_APIENTRY *LPALGETFLOAT)( ALenum param );
+typedef ALdouble       (AL_APIENTRY *LPALGETDOUBLE)( ALenum param );
+typedef ALenum         (AL_APIENTRY *LPALGETERROR)( void );
+typedef ALboolean      (AL_APIENTRY *LPALISEXTENSIONPRESENT)(const ALchar* extname );
+typedef void*          (AL_APIENTRY *LPALGETPROCADDRESS)( const ALchar* fname );
+typedef ALenum         (AL_APIENTRY *LPALGETENUMVALUE)( const ALchar* ename );
+typedef void           (AL_APIENTRY *LPALLISTENERF)( ALenum param, ALfloat value );
+typedef void           (AL_APIENTRY *LPALLISTENER3F)( ALenum param, ALfloat value1, ALfloat value2, ALfloat value3 );
+typedef void           (AL_APIENTRY *LPALLISTENERFV)( ALenum param, const ALfloat* values );
+typedef void           (AL_APIENTRY *LPALLISTENERI)( ALenum param, ALint value );
+typedef void           (AL_APIENTRY *LPALLISTENER3I)( ALenum param, ALint value1, ALint value2, ALint value3 );
+typedef void           (AL_APIENTRY *LPALLISTENERIV)( ALenum param, const ALint* values );
+typedef void           (AL_APIENTRY *LPALGETLISTENERF)( ALenum param, ALfloat* value );
+typedef void           (AL_APIENTRY *LPALGETLISTENER3F)( ALenum param, ALfloat *value1, ALfloat *value2, ALfloat *value3 );
+typedef void           (AL_APIENTRY *LPALGETLISTENERFV)( ALenum param, ALfloat* values );
+typedef void           (AL_APIENTRY *LPALGETLISTENERI)( ALenum param, ALint* value );
+typedef void           (AL_APIENTRY *LPALGETLISTENER3I)( ALenum param, ALint *value1, ALint *value2, ALint *value3 );
+typedef void           (AL_APIENTRY *LPALGETLISTENERIV)( ALenum param, ALint* values );
+typedef void           (AL_APIENTRY *LPALGENSOURCES)( ALsizei n, ALuint* sources ); 
+typedef void           (AL_APIENTRY *LPALDELETESOURCES)( ALsizei n, const ALuint* sources );
+typedef ALboolean      (AL_APIENTRY *LPALISSOURCE)( ALuint sid ); 
+typedef void           (AL_APIENTRY *LPALSOURCEF)( ALuint sid, ALenum param, ALfloat value); 
+typedef void           (AL_APIENTRY *LPALSOURCE3F)( ALuint sid, ALenum param, ALfloat value1, ALfloat value2, ALfloat value3 );
+typedef void           (AL_APIENTRY *LPALSOURCEFV)( ALuint sid, ALenum param, const ALfloat* values );
+typedef void           (AL_APIENTRY *LPALSOURCEI)( ALuint sid, ALenum param, ALint value); 
+typedef void           (AL_APIENTRY *LPALSOURCE3I)( ALuint sid, ALenum param, ALint value1, ALint value2, ALint value3 );
+typedef void           (AL_APIENTRY *LPALSOURCEIV)( ALuint sid, ALenum param, const ALint* values );
+typedef void           (AL_APIENTRY *LPALGETSOURCEF)( ALuint sid, ALenum param, ALfloat* value );
+typedef void           (AL_APIENTRY *LPALGETSOURCE3F)( ALuint sid, ALenum param, ALfloat* value1, ALfloat* value2, ALfloat* value3);
+typedef void           (AL_APIENTRY *LPALGETSOURCEFV)( ALuint sid, ALenum param, ALfloat* values );
+typedef void           (AL_APIENTRY *LPALGETSOURCEI)( ALuint sid, ALenum param, ALint* value );
+typedef void           (AL_APIENTRY *LPALGETSOURCE3I)( ALuint sid, ALenum param, ALint* value1, ALint* value2, ALint* value3);
+typedef void           (AL_APIENTRY *LPALGETSOURCEIV)( ALuint sid, ALenum param, ALint* values );
+typedef void           (AL_APIENTRY *LPALSOURCEPLAYV)( ALsizei ns, const ALuint *sids );
+typedef void           (AL_APIENTRY *LPALSOURCESTOPV)( ALsizei ns, const ALuint *sids );
+typedef void           (AL_APIENTRY *LPALSOURCEREWINDV)( ALsizei ns, const ALuint *sids );
+typedef void           (AL_APIENTRY *LPALSOURCEPAUSEV)( ALsizei ns, const ALuint *sids );
+typedef void           (AL_APIENTRY *LPALSOURCEPLAY)( ALuint sid );
+typedef void           (AL_APIENTRY *LPALSOURCESTOP)( ALuint sid );
+typedef void           (AL_APIENTRY *LPALSOURCEREWIND)( ALuint sid );
+typedef void           (AL_APIENTRY *LPALSOURCEPAUSE)( ALuint sid );
+typedef void           (AL_APIENTRY *LPALSOURCEQUEUEBUFFERS)(ALuint sid, ALsizei numEntries, const ALuint *bids );
+typedef void           (AL_APIENTRY *LPALSOURCEUNQUEUEBUFFERS)(ALuint sid, ALsizei numEntries, ALuint *bids );
+typedef void           (AL_APIENTRY *LPALGENBUFFERS)( ALsizei n, ALuint* buffers );
+typedef void           (AL_APIENTRY *LPALDELETEBUFFERS)( ALsizei n, const ALuint* buffers );
+typedef ALboolean      (AL_APIENTRY *LPALISBUFFER)( ALuint bid );
+typedef void           (AL_APIENTRY *LPALBUFFERDATA)( ALuint bid, ALenum format, const ALvoid* data, ALsizei size, ALsizei freq );
+typedef void           (AL_APIENTRY *LPALBUFFERF)( ALuint bid, ALenum param, ALfloat value);
+typedef void           (AL_APIENTRY *LPALBUFFER3F)( ALuint bid, ALenum param, ALfloat value1, ALfloat value2, ALfloat value3 );
+typedef void           (AL_APIENTRY *LPALBUFFERFV)( ALuint bid, ALenum param, const ALfloat* values );
+typedef void           (AL_APIENTRY *LPALBUFFERI)( ALuint bid, ALenum param, ALint value);
+typedef void           (AL_APIENTRY *LPALBUFFER3I)( ALuint bid, ALenum param, ALint value1, ALint value2, ALint value3 );
+typedef void           (AL_APIENTRY *LPALBUFFERIV)( ALuint bid, ALenum param, const ALint* values );
+typedef void           (AL_APIENTRY *LPALGETBUFFERF)( ALuint bid, ALenum param, ALfloat* value );
+typedef void           (AL_APIENTRY *LPALGETBUFFER3F)( ALuint bid, ALenum param, ALfloat* value1, ALfloat* value2, ALfloat* value3);
+typedef void           (AL_APIENTRY *LPALGETBUFFERFV)( ALuint bid, ALenum param, ALfloat* values );
+typedef void           (AL_APIENTRY *LPALGETBUFFERI)( ALuint bid, ALenum param, ALint* value );
+typedef void           (AL_APIENTRY *LPALGETBUFFER3I)( ALuint bid, ALenum param, ALint* value1, ALint* value2, ALint* value3);
+typedef void           (AL_APIENTRY *LPALGETBUFFERIV)( ALuint bid, ALenum param, ALint* values );
+typedef void           (AL_APIENTRY *LPALDOPPLERFACTOR)( ALfloat value );
+typedef void           (AL_APIENTRY *LPALDOPPLERVELOCITY)( ALfloat value );
+typedef void           (AL_APIENTRY *LPALSPEEDOFSOUND)( ALfloat value );
+typedef void           (AL_APIENTRY *LPALDISTANCEMODEL)( ALenum distanceModel );
+
+#if defined(TARGET_OS_MAC) && TARGET_OS_MAC
+ #pragma export off
+#endif
 
-#ifdef __cplusplus
+#if defined(__cplusplus)
 }  /* extern "C" */
 #endif
 
-#endif /* __al_h_ */
+#endif /* AL_AL_H */