2009-01-29 00:18:34 +08:00
|
|
|
#ifndef AL_ALC_H
|
|
|
|
#define AL_ALC_H
|
|
|
|
|
|
|
|
#if defined(__cplusplus)
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
2011-03-27 06:57:10 +08:00
|
|
|
#if defined(AL_LIBTYPE_STATIC)
|
|
|
|
#define ALC_API
|
|
|
|
#elif defined(_WIN32) && !defined(_XBOX)
|
2010-04-07 15:57:32 +08:00
|
|
|
#if defined(AL_BUILD_LIBRARY)
|
2009-01-29 00:18:34 +08:00
|
|
|
#define ALC_API __declspec(dllexport)
|
|
|
|
#else
|
|
|
|
#define ALC_API __declspec(dllimport)
|
|
|
|
#endif
|
|
|
|
#else
|
|
|
|
#if defined(AL_BUILD_LIBRARY) && defined(HAVE_GCC_VISIBILITY)
|
2010-04-07 15:57:32 +08:00
|
|
|
#define ALC_API __attribute__((visibility("protected")))
|
2009-01-29 00:18:34 +08:00
|
|
|
#else
|
|
|
|
#define ALC_API extern
|
|
|
|
#endif
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#if defined(_WIN32)
|
|
|
|
#define ALC_APIENTRY __cdecl
|
|
|
|
#else
|
|
|
|
#define ALC_APIENTRY
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC
|
|
|
|
#pragma export on
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/*
|
|
|
|
* The ALCAPI, ALCAPIENTRY, and ALC_INVALID macros are deprecated, but are
|
|
|
|
* included for applications porting code from AL 1.0
|
|
|
|
*/
|
|
|
|
#define ALCAPI ALC_API
|
|
|
|
#define ALCAPIENTRY ALC_APIENTRY
|
|
|
|
#define ALC_INVALID 0
|
|
|
|
|
|
|
|
|
|
|
|
#define ALC_VERSION_0_1 1
|
|
|
|
|
|
|
|
typedef struct ALCdevice_struct ALCdevice;
|
|
|
|
typedef struct ALCcontext_struct ALCcontext;
|
|
|
|
|
|
|
|
|
|
|
|
/** 8-bit boolean */
|
|
|
|
typedef char ALCboolean;
|
|
|
|
|
|
|
|
/** character */
|
|
|
|
typedef char ALCchar;
|
|
|
|
|
|
|
|
/** signed 8-bit 2's complement integer */
|
2010-04-07 15:57:32 +08:00
|
|
|
typedef signed char ALCbyte;
|
2009-01-29 00:18:34 +08:00
|
|
|
|
|
|
|
/** unsigned 8-bit integer */
|
|
|
|
typedef unsigned char ALCubyte;
|
|
|
|
|
|
|
|
/** signed 16-bit 2's complement integer */
|
|
|
|
typedef short ALCshort;
|
|
|
|
|
|
|
|
/** unsigned 16-bit integer */
|
|
|
|
typedef unsigned short ALCushort;
|
|
|
|
|
|
|
|
/** signed 32-bit 2's complement integer */
|
|
|
|
typedef int ALCint;
|
|
|
|
|
|
|
|
/** unsigned 32-bit integer */
|
|
|
|
typedef unsigned int ALCuint;
|
|
|
|
|
|
|
|
/** non-negative 32-bit binary integer size */
|
|
|
|
typedef int ALCsizei;
|
|
|
|
|
|
|
|
/** enumerated 32-bit value */
|
|
|
|
typedef int ALCenum;
|
|
|
|
|
|
|
|
/** 32-bit IEEE754 floating-point */
|
|
|
|
typedef float ALCfloat;
|
|
|
|
|
|
|
|
/** 64-bit IEEE754 floating-point */
|
|
|
|
typedef double ALCdouble;
|
|
|
|
|
|
|
|
/** void type (for opaque pointers only) */
|
|
|
|
typedef void ALCvoid;
|
|
|
|
|
|
|
|
|
|
|
|
/* Enumerant values begin at column 50. No tabs. */
|
|
|
|
|
|
|
|
/* Boolean False. */
|
|
|
|
#define ALC_FALSE 0
|
|
|
|
|
|
|
|
/* Boolean True. */
|
|
|
|
#define ALC_TRUE 1
|
|
|
|
|
|
|
|
/**
|
|
|
|
* followed by <int> Hz
|
|
|
|
*/
|
|
|
|
#define ALC_FREQUENCY 0x1007
|
|
|
|
|
|
|
|
/**
|
|
|
|
* followed by <int> Hz
|
|
|
|
*/
|
|
|
|
#define ALC_REFRESH 0x1008
|
|
|
|
|
|
|
|
/**
|
|
|
|
* followed by AL_TRUE, AL_FALSE
|
|
|
|
*/
|
|
|
|
#define ALC_SYNC 0x1009
|
|
|
|
|
|
|
|
/**
|
|
|
|
* followed by <int> Num of requested Mono (3D) Sources
|
|
|
|
*/
|
|
|
|
#define ALC_MONO_SOURCES 0x1010
|
|
|
|
|
|
|
|
/**
|
|
|
|
* followed by <int> Num of requested Stereo Sources
|
|
|
|
*/
|
|
|
|
#define ALC_STEREO_SOURCES 0x1011
|
|
|
|
|
|
|
|
/**
|
|
|
|
* errors
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* No error
|
|
|
|
*/
|
|
|
|
#define ALC_NO_ERROR ALC_FALSE
|
|
|
|
|
|
|
|
/**
|
|
|
|
* No device
|
|
|
|
*/
|
|
|
|
#define ALC_INVALID_DEVICE 0xA001
|
|
|
|
|
|
|
|
/**
|
|
|
|
* invalid context ID
|
|
|
|
*/
|
|
|
|
#define ALC_INVALID_CONTEXT 0xA002
|
|
|
|
|
|
|
|
/**
|
|
|
|
* bad enum
|
|
|
|
*/
|
|
|
|
#define ALC_INVALID_ENUM 0xA003
|
|
|
|
|
|
|
|
/**
|
|
|
|
* bad value
|
|
|
|
*/
|
|
|
|
#define ALC_INVALID_VALUE 0xA004
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Out of memory.
|
|
|
|
*/
|
|
|
|
#define ALC_OUT_OF_MEMORY 0xA005
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The Specifier string for default device
|
|
|
|
*/
|
|
|
|
#define ALC_DEFAULT_DEVICE_SPECIFIER 0x1004
|
|
|
|
#define ALC_DEVICE_SPECIFIER 0x1005
|
|
|
|
#define ALC_EXTENSIONS 0x1006
|
|
|
|
|
|
|
|
#define ALC_MAJOR_VERSION 0x1000
|
|
|
|
#define ALC_MINOR_VERSION 0x1001
|
|
|
|
|
|
|
|
#define ALC_ATTRIBUTES_SIZE 0x1002
|
|
|
|
#define ALC_ALL_ATTRIBUTES 0x1003
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Capture extension
|
|
|
|
*/
|
|
|
|
#define ALC_CAPTURE_DEVICE_SPECIFIER 0x310
|
|
|
|
#define ALC_CAPTURE_DEFAULT_DEVICE_SPECIFIER 0x311
|
|
|
|
#define ALC_CAPTURE_SAMPLES 0x312
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Context Management
|
|
|
|
*/
|
|
|
|
ALC_API ALCcontext * ALC_APIENTRY alcCreateContext( ALCdevice *device, const ALCint* attrlist );
|
|
|
|
|
|
|
|
ALC_API ALCboolean ALC_APIENTRY alcMakeContextCurrent( ALCcontext *context );
|
|
|
|
|
|
|
|
ALC_API void ALC_APIENTRY alcProcessContext( ALCcontext *context );
|
|
|
|
|
|
|
|
ALC_API void ALC_APIENTRY alcSuspendContext( ALCcontext *context );
|
|
|
|
|
|
|
|
ALC_API void ALC_APIENTRY alcDestroyContext( ALCcontext *context );
|
|
|
|
|
|
|
|
ALC_API ALCcontext * ALC_APIENTRY alcGetCurrentContext( void );
|
|
|
|
|
|
|
|
ALC_API ALCdevice* ALC_APIENTRY alcGetContextsDevice( ALCcontext *context );
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Device Management
|
|
|
|
*/
|
|
|
|
ALC_API ALCdevice * ALC_APIENTRY alcOpenDevice( const ALCchar *devicename );
|
|
|
|
|
|
|
|
ALC_API ALCboolean ALC_APIENTRY alcCloseDevice( ALCdevice *device );
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Error support.
|
|
|
|
* Obtain the most recent Context error
|
|
|
|
*/
|
|
|
|
ALC_API ALCenum ALC_APIENTRY alcGetError( ALCdevice *device );
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Extension support.
|
|
|
|
* Query for the presence of an extension, and obtain any appropriate
|
|
|
|
* function pointers and enum values.
|
|
|
|
*/
|
|
|
|
ALC_API ALCboolean ALC_APIENTRY alcIsExtensionPresent( ALCdevice *device, const ALCchar *extname );
|
|
|
|
|
|
|
|
ALC_API void * ALC_APIENTRY alcGetProcAddress( ALCdevice *device, const ALCchar *funcname );
|
|
|
|
|
|
|
|
ALC_API ALCenum ALC_APIENTRY alcGetEnumValue( ALCdevice *device, const ALCchar *enumname );
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Query functions
|
|
|
|
*/
|
|
|
|
ALC_API const ALCchar * ALC_APIENTRY alcGetString( ALCdevice *device, ALCenum param );
|
|
|
|
|
|
|
|
ALC_API void ALC_APIENTRY alcGetIntegerv( ALCdevice *device, ALCenum param, ALCsizei size, ALCint *data );
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Capture functions
|
|
|
|
*/
|
|
|
|
ALC_API ALCdevice* ALC_APIENTRY alcCaptureOpenDevice( const ALCchar *devicename, ALCuint frequency, ALCenum format, ALCsizei buffersize );
|
|
|
|
|
|
|
|
ALC_API ALCboolean ALC_APIENTRY alcCaptureCloseDevice( ALCdevice *device );
|
|
|
|
|
|
|
|
ALC_API void ALC_APIENTRY alcCaptureStart( ALCdevice *device );
|
|
|
|
|
|
|
|
ALC_API void ALC_APIENTRY alcCaptureStop( ALCdevice *device );
|
|
|
|
|
|
|
|
ALC_API void ALC_APIENTRY alcCaptureSamples( ALCdevice *device, ALCvoid *buffer, ALCsizei samples );
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Pointer-to-function types, useful for dynamically getting ALC entry points.
|
|
|
|
*/
|
|
|
|
typedef ALCcontext * (ALC_APIENTRY *LPALCCREATECONTEXT) (ALCdevice *device, const ALCint *attrlist);
|
|
|
|
typedef ALCboolean (ALC_APIENTRY *LPALCMAKECONTEXTCURRENT)( ALCcontext *context );
|
|
|
|
typedef void (ALC_APIENTRY *LPALCPROCESSCONTEXT)( ALCcontext *context );
|
|
|
|
typedef void (ALC_APIENTRY *LPALCSUSPENDCONTEXT)( ALCcontext *context );
|
|
|
|
typedef void (ALC_APIENTRY *LPALCDESTROYCONTEXT)( ALCcontext *context );
|
|
|
|
typedef ALCcontext * (ALC_APIENTRY *LPALCGETCURRENTCONTEXT)( void );
|
|
|
|
typedef ALCdevice * (ALC_APIENTRY *LPALCGETCONTEXTSDEVICE)( ALCcontext *context );
|
|
|
|
typedef ALCdevice * (ALC_APIENTRY *LPALCOPENDEVICE)( const ALCchar *devicename );
|
|
|
|
typedef ALCboolean (ALC_APIENTRY *LPALCCLOSEDEVICE)( ALCdevice *device );
|
|
|
|
typedef ALCenum (ALC_APIENTRY *LPALCGETERROR)( ALCdevice *device );
|
|
|
|
typedef ALCboolean (ALC_APIENTRY *LPALCISEXTENSIONPRESENT)( ALCdevice *device, const ALCchar *extname );
|
|
|
|
typedef void * (ALC_APIENTRY *LPALCGETPROCADDRESS)(ALCdevice *device, const ALCchar *funcname );
|
|
|
|
typedef ALCenum (ALC_APIENTRY *LPALCGETENUMVALUE)(ALCdevice *device, const ALCchar *enumname );
|
|
|
|
typedef const ALCchar* (ALC_APIENTRY *LPALCGETSTRING)( ALCdevice *device, ALCenum param );
|
|
|
|
typedef void (ALC_APIENTRY *LPALCGETINTEGERV)( ALCdevice *device, ALCenum param, ALCsizei size, ALCint *dest );
|
|
|
|
typedef ALCdevice * (ALC_APIENTRY *LPALCCAPTUREOPENDEVICE)( const ALCchar *devicename, ALCuint frequency, ALCenum format, ALCsizei buffersize );
|
|
|
|
typedef ALCboolean (ALC_APIENTRY *LPALCCAPTURECLOSEDEVICE)( ALCdevice *device );
|
|
|
|
typedef void (ALC_APIENTRY *LPALCCAPTURESTART)( ALCdevice *device );
|
|
|
|
typedef void (ALC_APIENTRY *LPALCCAPTURESTOP)( ALCdevice *device );
|
|
|
|
typedef void (ALC_APIENTRY *LPALCCAPTURESAMPLES)( ALCdevice *device, ALCvoid *buffer, ALCsizei samples );
|
|
|
|
|
|
|
|
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC
|
|
|
|
#pragma export off
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#if defined(__cplusplus)
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#endif /* AL_ALC_H */
|