Mercurial > audio-send

     1 #ifndef AL_ALC_H

     2 #define AL_ALC_H

     3 

     4 #if defined(__cplusplus)

     5 extern "C" {

     6 #endif

     7 

     8 #ifndef ALC_API

     9  #if defined(AL_LIBTYPE_STATIC)

    10   #define ALC_API

    11  #elif defined(_WIN32)

    12   #define ALC_API __declspec(dllimport)

    13  #else

    14   #define ALC_API extern

    15  #endif

    16 #endif

    17 

    18 #if defined(_WIN32)

    19  #define ALC_APIENTRY __cdecl

    20 #else

    21  #define ALC_APIENTRY

    22 #endif

    23 

    24 #if defined(TARGET_OS_MAC) && TARGET_OS_MAC

    25  #pragma export on

    26 #endif

    27 

    28 /*

    29  * The ALCAPI, ALCAPIENTRY, and ALC_INVALID macros are deprecated, but are

    30  * included for applications porting code from AL 1.0

    31  */

    32 #define ALCAPI ALC_API

    33 #define ALCAPIENTRY ALC_APIENTRY

    34 #define ALC_INVALID 0

    35 

    36 

    37 #define ALC_VERSION_0_1         1

    38 

    39 typedef struct ALCdevice_struct ALCdevice;

    40 typedef struct ALCcontext_struct ALCcontext;

    41 

    42 

    43 /** 8-bit boolean */

    44 typedef char ALCboolean;

    45 

    46 /** character */

    47 typedef char ALCchar;

    48 

    49 /** signed 8-bit 2's complement integer */

    50 typedef signed char ALCbyte;

    51 

    52 /** unsigned 8-bit integer */

    53 typedef unsigned char ALCubyte;

    54 

    55 /** signed 16-bit 2's complement integer */

    56 typedef short ALCshort;

    57 

    58 /** unsigned 16-bit integer */

    59 typedef unsigned short ALCushort;

    60 

    61 /** signed 32-bit 2's complement integer */

    62 typedef int ALCint;

    63 

    64 /** unsigned 32-bit integer */

    65 typedef unsigned int ALCuint;

    66 

    67 /** non-negative 32-bit binary integer size */

    68 typedef int ALCsizei;

    69 

    70 /** enumerated 32-bit value */

    71 typedef int ALCenum;

    72 

    73 /** 32-bit IEEE754 floating-point */

    74 typedef float ALCfloat;

    75 

    76 /** 64-bit IEEE754 floating-point */

    77 typedef double ALCdouble;

    78 

    79 /** void type (for opaque pointers only) */

    80 typedef void ALCvoid;

    81 

    82 

    83 /* Enumerant values begin at column 50. No tabs. */

    84 

    85 /* Boolean False. */

    86 #define ALC_FALSE                                0

    87 

    88 /* Boolean True. */

    89 #define ALC_TRUE                                 1

    90 

    91 /**

    92  * followed by <int> Hz

    93  */

    94 #define ALC_FREQUENCY                            0x1007

    95 

    96 /**

    97  * followed by <int> Hz

    98  */

    99 #define ALC_REFRESH                              0x1008

   100 

   101 /**

   102  * followed by AL_TRUE, AL_FALSE

   103  */

   104 #define ALC_SYNC                                 0x1009

   105 

   106 /**

   107  * followed by <int> Num of requested Mono (3D) Sources

   108  */

   109 #define ALC_MONO_SOURCES                         0x1010

   110 

   111 /**

   112  * followed by <int> Num of requested Stereo Sources

   113  */

   114 #define ALC_STEREO_SOURCES                       0x1011

   115 

   116 /**

   117  * errors

   118  */

   119 

   120 /**

   121  * No error

   122  */

   123 #define ALC_NO_ERROR                             ALC_FALSE

   124 

   125 /**

   126  * No device

   127  */

   128 #define ALC_INVALID_DEVICE                       0xA001

   129 

   130 /**

   131  * invalid context ID

   132  */

   133 #define ALC_INVALID_CONTEXT                      0xA002

   134 

   135 /**

   136  * bad enum

   137  */

   138 #define ALC_INVALID_ENUM                         0xA003

   139 

   140 /**

   141  * bad value

   142  */

   143 #define ALC_INVALID_VALUE                        0xA004

   144 

   145 /**

   146  * Out of memory.

   147  */

   148 #define ALC_OUT_OF_MEMORY                        0xA005

   149 

   150 

   151 /**

   152  * The Specifier string for default device

   153  */

   154 #define ALC_DEFAULT_DEVICE_SPECIFIER             0x1004

   155 #define ALC_DEVICE_SPECIFIER                     0x1005

   156 #define ALC_EXTENSIONS                           0x1006

   157 

   158 #define ALC_MAJOR_VERSION                        0x1000

   159 #define ALC_MINOR_VERSION                        0x1001

   160 

   161 #define ALC_ATTRIBUTES_SIZE                      0x1002

   162 #define ALC_ALL_ATTRIBUTES                       0x1003

   163 

   164 

   165 /**

   166  * Capture extension

   167  */

   168 #define ALC_EXT_CAPTURE 1

   169 #define ALC_CAPTURE_DEVICE_SPECIFIER             0x310

   170 #define ALC_CAPTURE_DEFAULT_DEVICE_SPECIFIER     0x311

   171 #define ALC_CAPTURE_SAMPLES                      0x312

   172 

   173 

   174 /**

   175  * ALC_ENUMERATE_ALL_EXT enums

   176  */

   177 #define ALC_ENUMERATE_ALL_EXT 1

   178 #define ALC_DEFAULT_ALL_DEVICES_SPECIFIER        0x1012

   179 #define ALC_ALL_DEVICES_SPECIFIER                0x1013

   180 

   181 

   182 /*

   183  * Context Management

   184  */

   185 ALC_API ALCcontext *    ALC_APIENTRY alcCreateContext( ALCdevice *device, const ALCint* attrlist );

   186 

   187 ALC_API ALCboolean      ALC_APIENTRY alcMakeContextCurrent( ALCcontext *context );

   188 

   189 ALC_API void            ALC_APIENTRY alcProcessContext( ALCcontext *context );

   190 

   191 ALC_API void            ALC_APIENTRY alcSuspendContext( ALCcontext *context );

   192 

   193 ALC_API void            ALC_APIENTRY alcDestroyContext( ALCcontext *context );

   194 

   195 ALC_API ALCcontext *    ALC_APIENTRY alcGetCurrentContext( void );

   196 

   197 ALC_API ALCdevice*      ALC_APIENTRY alcGetContextsDevice( ALCcontext *context );

   198 

   199 

   200 /*

   201  * Device Management

   202  */

   203 ALC_API ALCdevice *     ALC_APIENTRY alcOpenDevice( const ALCchar *devicename );

   204 

   205 ALC_API ALCboolean      ALC_APIENTRY alcCloseDevice( ALCdevice *device );

   206 

   207 

   208 /*

   209  * Error support.

   210  * Obtain the most recent Context error

   211  */

   212 ALC_API ALCenum         ALC_APIENTRY alcGetError( ALCdevice *device );

   213 

   214 

   215 /* 

   216  * Extension support.

   217  * Query for the presence of an extension, and obtain any appropriate

   218  * function pointers and enum values.

   219  */

   220 ALC_API ALCboolean      ALC_APIENTRY alcIsExtensionPresent( ALCdevice *device, const ALCchar *extname );

   221 

   222 ALC_API void  *         ALC_APIENTRY alcGetProcAddress( ALCdevice *device, const ALCchar *funcname );

   223 

   224 ALC_API ALCenum         ALC_APIENTRY alcGetEnumValue( ALCdevice *device, const ALCchar *enumname );

   225 

   226 

   227 /*

   228  * Query functions

   229  */

   230 ALC_API const ALCchar * ALC_APIENTRY alcGetString( ALCdevice *device, ALCenum param );

   231 

   232 ALC_API void            ALC_APIENTRY alcGetIntegerv( ALCdevice *device, ALCenum param, ALCsizei size, ALCint *data );

   233 

   234 

   235 /*

   236  * Capture functions

   237  */

   238 ALC_API ALCdevice*      ALC_APIENTRY alcCaptureOpenDevice( const ALCchar *devicename, ALCuint frequency, ALCenum format, ALCsizei buffersize );

   239 

   240 ALC_API ALCboolean      ALC_APIENTRY alcCaptureCloseDevice( ALCdevice *device );

   241 

   242 ALC_API void            ALC_APIENTRY alcCaptureStart( ALCdevice *device );

   243 

   244 ALC_API void            ALC_APIENTRY alcCaptureStop( ALCdevice *device );

   245 

   246 ALC_API void            ALC_APIENTRY alcCaptureSamples( ALCdevice *device, ALCvoid *buffer, ALCsizei samples );

   247 

   248 /*

   249  * Pointer-to-function types, useful for dynamically getting ALC entry points.

   250  */

   251 typedef ALCcontext *   (ALC_APIENTRY *LPALCCREATECONTEXT) (ALCdevice *device, const ALCint *attrlist);

   252 typedef ALCboolean     (ALC_APIENTRY *LPALCMAKECONTEXTCURRENT)( ALCcontext *context );

   253 typedef void           (ALC_APIENTRY *LPALCPROCESSCONTEXT)( ALCcontext *context );

   254 typedef void           (ALC_APIENTRY *LPALCSUSPENDCONTEXT)( ALCcontext *context );

   255 typedef void           (ALC_APIENTRY *LPALCDESTROYCONTEXT)( ALCcontext *context );

   256 typedef ALCcontext *   (ALC_APIENTRY *LPALCGETCURRENTCONTEXT)( void );

   257 typedef ALCdevice *    (ALC_APIENTRY *LPALCGETCONTEXTSDEVICE)( ALCcontext *context );

   258 typedef ALCdevice *    (ALC_APIENTRY *LPALCOPENDEVICE)( const ALCchar *devicename );

   259 typedef ALCboolean     (ALC_APIENTRY *LPALCCLOSEDEVICE)( ALCdevice *device );

   260 typedef ALCenum        (ALC_APIENTRY *LPALCGETERROR)( ALCdevice *device );

   261 typedef ALCboolean     (ALC_APIENTRY *LPALCISEXTENSIONPRESENT)( ALCdevice *device, const ALCchar *extname );

   262 typedef void *         (ALC_APIENTRY *LPALCGETPROCADDRESS)(ALCdevice *device, const ALCchar *funcname );

   263 typedef ALCenum        (ALC_APIENTRY *LPALCGETENUMVALUE)(ALCdevice *device, const ALCchar *enumname );

   264 typedef const ALCchar* (ALC_APIENTRY *LPALCGETSTRING)( ALCdevice *device, ALCenum param );

   265 typedef void           (ALC_APIENTRY *LPALCGETINTEGERV)( ALCdevice *device, ALCenum param, ALCsizei size, ALCint *dest );

   266 typedef ALCdevice *    (ALC_APIENTRY *LPALCCAPTUREOPENDEVICE)( const ALCchar *devicename, ALCuint frequency, ALCenum format, ALCsizei buffersize );

   267 typedef ALCboolean     (ALC_APIENTRY *LPALCCAPTURECLOSEDEVICE)( ALCdevice *device );

   268 typedef void           (ALC_APIENTRY *LPALCCAPTURESTART)( ALCdevice *device );

   269 typedef void           (ALC_APIENTRY *LPALCCAPTURESTOP)( ALCdevice *device );

   270 typedef void           (ALC_APIENTRY *LPALCCAPTURESAMPLES)( ALCdevice *device, ALCvoid *buffer, ALCsizei samples );

   271 

   272 #if defined(TARGET_OS_MAC) && TARGET_OS_MAC

   273  #pragma export off

   274 #endif

   275 

   276 #if defined(__cplusplus)

   277 }

   278 #endif

   279 

   280 #endif /* AL_ALC_H */
author	Robert McIntyre <rlm@mit.edu>
date	Fri, 18 Nov 2011 16:05:47 -0700
parents	f9476ff7637e
children