mirror of
https://github.com/ioquake/ioq3.git
synced 2024-11-14 17:01:13 +00:00
1b314e8934
* Added a Makefile option USE_LOCAL_HEADERS which can be disabled to use system headers if desired
352 lines
8.9 KiB
C
352 lines
8.9 KiB
C
#ifndef _AL_TYPES_H_
|
|
#define _AL_TYPES_H_
|
|
|
|
/* define platform type */
|
|
#if !defined(MACINTOSH_AL) && !defined(LINUX_AL) && !defined(WINDOWS_AL)
|
|
#ifdef __APPLE__
|
|
#define MACINTOSH_AL
|
|
#else
|
|
#ifdef _WIN32
|
|
#define WINDOWS_AL
|
|
#else
|
|
#define LINUX_AL
|
|
#endif
|
|
#endif
|
|
#endif
|
|
|
|
/** OpenAL bool type. */
|
|
typedef char ALboolean;
|
|
|
|
/** OpenAL 8bit signed byte. */
|
|
typedef char ALbyte;
|
|
|
|
/** OpenAL 8bit unsigned byte. */
|
|
typedef unsigned char ALubyte;
|
|
|
|
/** OpenAL 8bit char */
|
|
typedef char ALchar;
|
|
|
|
/** OpenAL 16bit signed short integer type. */
|
|
typedef short ALshort;
|
|
|
|
/** OpenAL 16bit unsigned short integer type. */
|
|
typedef unsigned short ALushort;
|
|
|
|
/** OpenAL 32bit unsigned integer type. */
|
|
typedef unsigned int ALuint;
|
|
|
|
/** OpenAL 32bit signed integer type. */
|
|
typedef int ALint;
|
|
|
|
/** OpenAL 32bit floating point type. */
|
|
typedef float ALfloat;
|
|
|
|
/** OpenAL 64bit double point type. */
|
|
typedef double ALdouble;
|
|
|
|
/** OpenAL 32bit type. */
|
|
typedef int ALsizei;
|
|
|
|
/** OpenAL void type (for params, not returns). */
|
|
typedef void ALvoid;
|
|
|
|
/** OpenAL enumerations. */
|
|
typedef int ALenum;
|
|
|
|
/** OpenAL bitfields. */
|
|
typedef unsigned int ALbitfield;
|
|
|
|
/** OpenAL clamped float. */
|
|
typedef ALfloat ALclampf;
|
|
|
|
/** Openal clamped double. */
|
|
typedef ALdouble ALclampd;
|
|
|
|
/* Enumerant values begin at column 50. No tabs. */
|
|
|
|
/* bad value */
|
|
#define AL_INVALID -1
|
|
|
|
#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
|
|
|
|
|
|
|
|
/**
|
|
* Directional source, inner cone angle, in degrees.
|
|
* Range: [0-360]
|
|
* Default: 360
|
|
*/
|
|
#define AL_CONE_INNER_ANGLE 0x1001
|
|
|
|
/**
|
|
* Directional source, outer cone angle, in degrees.
|
|
* Range: [0-360]
|
|
* Default: 360
|
|
*/
|
|
#define AL_CONE_OUTER_ANGLE 0x1002
|
|
|
|
/**
|
|
* Specify the pitch to be applied, either at source,
|
|
* or on mixer results, at listener.
|
|
* Range: [0.5-2.0]
|
|
* Default: 1.0
|
|
*/
|
|
#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
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
#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
|
|
|
|
/**
|
|
* Specify the channel mask. (Creative)
|
|
* Type: ALuint
|
|
* Range: [0 - 255]
|
|
*/
|
|
#define AL_CHANNEL_MASK 0x3000
|
|
|
|
|
|
/**
|
|
* 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
|
|
|
|
/**
|
|
* 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
|
|
*
|
|
* At 0.0, no distance attenuation occurs. Default is
|
|
* 1.0.
|
|
*/
|
|
#define AL_REFERENCE_DISTANCE 0x1020
|
|
|
|
/**
|
|
* source specific rolloff factor
|
|
* Type: ALfloat
|
|
* Range: 0.0 - +inf
|
|
*
|
|
*/
|
|
#define AL_ROLLOFF_FACTOR 0x1021
|
|
|
|
/**
|
|
* Directional source, outer cone gain.
|
|
*
|
|
* Default: 0.0
|
|
* Range: [0.0 - 1.0]
|
|
* Logarithmic
|
|
*/
|
|
#define AL_CONE_OUTER_GAIN 0x1022
|
|
|
|
/**
|
|
* Indicate distance above which sources are not
|
|
* attenuated using the inverse clamped distance model.
|
|
*
|
|
* Default: +inf
|
|
* Type: ALfloat
|
|
* Range: 0.0 - +inf
|
|
*/
|
|
#define AL_MAX_DISTANCE 0x1023
|
|
|
|
/**
|
|
* 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
|
|
#define AL_DATA 0x2005
|
|
|
|
/**
|
|
* 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
|
|
|
|
/**
|
|
* Invalid Name paramater passed to AL call.
|
|
*/
|
|
#define AL_INVALID_NAME 0xA001
|
|
|
|
/**
|
|
* Invalid parameter passed to AL call.
|
|
*/
|
|
#define AL_ILLEGAL_ENUM 0xA002
|
|
#define AL_INVALID_ENUM 0xA002
|
|
|
|
/**
|
|
* Invalid enum parameter value.
|
|
*/
|
|
#define AL_INVALID_VALUE 0xA003
|
|
|
|
/**
|
|
* Illegal call.
|
|
*/
|
|
#define AL_ILLEGAL_COMMAND 0xA004
|
|
#define AL_INVALID_OPERATION 0xA004
|
|
|
|
|
|
/**
|
|
* No mojo.
|
|
*/
|
|
#define AL_OUT_OF_MEMORY 0xA005
|
|
|
|
|
|
/** Context strings: Vendor Name. */
|
|
#define AL_VENDOR 0xB001
|
|
#define AL_VERSION 0xB002
|
|
#define AL_RENDERER 0xB003
|
|
#define AL_EXTENSIONS 0xB004
|
|
|
|
/** Global tweakage. */
|
|
|
|
/**
|
|
* Doppler scale. Default 1.0
|
|
*/
|
|
#define AL_DOPPLER_FACTOR 0xC000
|
|
|
|
/**
|
|
* Tweaks speed of propagation.
|
|
*/
|
|
#define AL_DOPPLER_VELOCITY 0xC001
|
|
|
|
/**
|
|
* Speed of Sound in units per second
|
|
*/
|
|
#define AL_SPEED_OF_SOUND 0xC003
|
|
|
|
/**
|
|
* 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
|
|
|
|
#endif
|