openal 基础知识4

二函数

1. buffer函数

void alGenBuffers(ALsizei n /* buffer数*/, ALuint * buffers /* buffer ID数组*/);

void alDeleteBuffers(ALsizei n /* buffer数*/, ALuint * buffers /* buffer ID 数组*/);

ALboolean alIsBuffer(ALuint buffer);

// 为buffer填充数据

void alBufferData(ALuint buffer, ALenum format/*声音格式*/,const ALvoid *data/*数据地址*/

                        , ALsizei size/*数据字节数*/,ALsizei freq/*声音频率*/);

                声音格式:AL_FORMAT_[MONO8, MONO16, STEREO8, STEREO16]

// 设置buffer的浮点数属性

void alBufferf (ALuintbuffer, ALenum param/*属性名*/,ALfloat value/*属性值*/);

void alBuffer3f (ALuintbuffer, ALenum param, ALfloat v1, ALfloat v2, ALfloat v3);

void alBufferfv (ALuintbuffer, ALenum param, ALfloat *values);

// 设置buffer的整数属性

void alBufferi (ALuintbuffer, ALenum param, ALint value);

void alBuffer3i (ALuintbuffer, ALenum param, ALint v1, ALint v2, ALint v3);

void alBufferiv (ALuintbuffer, ALenum param, ALint *values);

// 获取buffer属性值

void alGetBufferf(ALuint buffer, ALenum param, ALfloat *value);

void alGetBuffer3f(ALuint buffer, ALenum param, ALfloat *v1, ALfloat *v2, ALfloat *v3);

void alGetBufferfv(ALuint buffer, ALenum param, ALfloat *values);

void alGetBufferi(ALuint buffer, ALenum param, ALint *value);

void alGetBuffer3i(ALuint buffer, ALenum param, ALint *v1, ALint *v2, ALint *v3);

void alGetBufferiv(ALuint buffer, ALenum param, ALint *values);

 

2. source函数

void alGenSources(ALsizei n, ALuint *sources);

void alDeleteSources(ALsizei n, ALuint *sources);

ALboolean alIsSource(ALuint source);

 

void alSourcef (ALuintsource, ALenum param, ALfloat value);

void alSource3f (ALuintsource, ALenum param, ALfloat v1, ALfloat v2, ALfloat v3);

void alSourcefv (ALuintsource, ALenum param, ALfloat *values);

void alSourcei (ALuintsource, ALenum param, ALint value);

void alSource3i (ALuintsource, ALenum param, ALint v1, ALint v2, ALint v3);

void alSourceiv (ALuintsource, ALenum param, ALint *values);

 

void alGetSourcef(ALuint source, ALenum param, ALfloat *value);

void alGetSource3f(ALuint source, ALenum param, ALfloat *v1, ALfloat *v2, ALfloat *v3);

void alGetSourcefv(ALuint source, ALenum param, ALfloat *values);

void alGetSourcei(ALuint source, ALenum param, ALint *value);

void alGetSource3i(ALuint source, ALenum param, ALint *v1, ALint *v2, ALint *v3);

void alGetSourceiv(ALuint source, ALenum param, ALint *values);

 

void alSourcePlay(ALuint source);

void alSourcePause(ALuint source);

void alSourceStop(ALuint source);

void alSourceRewind(ALuint source); //停止source并将其状态设置为AL_INITIAL

void alSourcePlayv(ALsizei n, ALuint *sources); //播放一系列source

void alSourcePausev(ALsizei n, ALuint *sources);

void alSourceStopv(ALsizei n, ALuint *sources);

void alSourceRewindv(ALsizei n, ALuint *sources);

 

voidalSourceQueueBuffers (ALuint source, ALsizei n, ALuint *buffers); //alGetSourcei(source,

                AL_BUFFERS_PROCESSED,&x)获取已经处理了的buffer数

voidalSourceUnqueueBuffers (ALuint source, ALsizei n, ALuint *buffers);

 

3. listener函数

void alListenerf(ALenum param, ALfloat value);

void alListener3f(ALenum param, ALfloat v1, ALfloat v2, ALfloat v3);

void alListenerfv(ALenum param, ALfloat *values);

void alListeneri(ALenum param, ALint value);

void alListener3i(ALenum param, ALint v1, ALint v2, ALint v3);

void alListeneriv(ALenum param, ALint *values);

void alGetListenerf(ALenum param, ALfloat *value);

void alGetListener3f(ALenum param, ALfloat *v1, ALfloat *v2, ALfloat *v3);

void alGetListenerfv(ALenum param, ALfloat *values);

void alGetListeneri(ALenum param, ALint *value);

void alGetListener3i(ALenum param, ALint *v1, ALint *v2, ALint *v3);

void alGetListeneriv(ALenum param, ALint *values);

 

4. 状态函数

        AL_DOPPLER_FACTOR f 全局多普勒系数

        AL_SPEED_OF_SOUND f 声音的每秒传播速度

        AL_DISTANCE_MODEL i 距离模型枚举值

void alEnable (ALenumcapability); //使能某项功能

void alDisable (ALenumcapability);

ALboolean alIsEnabled(ALenum capability);

 

// FIXME:这一堆不知道是干吗的。。。

ALboolean alGetBoolean(ALenum param);

ALdouble alGetDouble(ALenum param);

ALfloat alGetFloat(ALenum param);

ALint alGetInteger(ALenum param);

void alGetBooleanv(ALenum param, ALboolean *data);

void alGetDoublev(ALenum param, ALdouble *data);

void alGetFloatv(ALenum param, ALfloat *data);

void alGetIntegerv(ALenum param, ALint *data);

 

const Alchar *alGetString (ALenum param); // param为

                AL_VENDOR,AL_VERSION, AL_RENDERER, AL_EXTENSIONS

 

void alDopplerFactor(ALfloat value); //设置多普勒因子，默认1.0

void alSpeedOfSound(ALfloat value); //默认343.3

void alDistanceModel(ALenum value); //设置OpenAL的距离模型

                AL_INVERSE_DISTANCE//倒数距离

                AL_INVERSE_DISTANCE_CLAMPED//默认值

                AL_LINEAR_DISTANCE //线性距离

                AL_LINEAR_DISTANCE_CLAMPED

                AL_EXPONENT_DISTANCE//指数距离

                AL_EXPONENT_DISTANCE_CLAMPED

                AL_NONE

                //这两个参数是计算距离中用的，公式参考原版文档，总之越近增益越大

                AL_REFERENCE_DISTANCE//参考距离

                AL_ROLLOFF_FACTOR //衰减因子

 

5. 错误函数

ALenum alGetError(ALvoid);

 

6. extension函数

ALbooleanalIsExtensionPresent (const ALchar *extname); //extension有效时返回AL_TRUE

void * alGetProcAddress(const ALchar *fname); //返回指定的函数指针或者NULL

ALenum alGetEnumValue(const ALchar *ename); //返回ename描述的ALenum或者NULL

 

7. context函数

ALC_FREQUENCY l 输出频率

ALC_MONO_SOURCES l 请求的单声道source数

ALC_STEREO_SOURCES l 请求的双声道source数

ALC_REFRESH l context运行的刷新率

ALC_SYNC i 同步context的标志位

ALContext *alcCreateContext (ALCdevice *device, ALCint *attrlist);

                attrlist:上述属性集的指针，可以是NULL或以0结尾的列表，列表中每一项是属性名和属性值组成的数对

ALCbooleanalcMakeContextCurrent (ALCcontext *context);

void alcProcessContext(ALCcontext *context); //通知指定context开始运行

void alcSuspendContext(ALCcontext *context); //这两个组合使用可以使状态的改变迅速生效

void alcDestroyContext(ALCcontext *context); //关闭非当前的context

ALCcontext*alcGetCurrentContext (ALCvoid);

ALCdevice*alcGetContextDevice (ALCcontext *context);

 

 

8. context错误函数

ALCenum alcGetError(ALCdevice *device);

 

9. contextdevice函数

ALCdevice*alcOpenDevice (const ALCchar *devicename);

ALCbooleanalcCloseDevice (ALCdevice *device);

 

10. contextextension函数

ALCbooleanalcIsExtensionPresent (ALCdevice *device, const ALCchar *extName);

void* alcGetProcAddress(ALCdevice *device, const ALCchar *funcName);

ALCenum alcGetEnumValue(ALCdevice *device, const ALCchar *enumName);

 

11. context状态函数

const ALCchar *alcGetString (ALCdevice *device, ALenum param);

                属性： ALC_DEFAULT_DEVICE_SPECIFIER

                        ALC_CAPTURE_DEFAULT_DEVICE_SPECIFIER

                        ALC_DEVICE_SPECIFIER

                        ALC_CAPTURE_DEVICE_SPECIFIER

                        ALC_EXTENSIONS

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

                param: ALC_MAJOR_VERSION,ALC_MINOR_VERSION,

                        ALC_ATTRIBUTES_SIZE,ALC_ALL_ATTRIBUTES

                size: 传入的目标buffer的大小

 

12. context 捕捉函数

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

                  frequency: 捕捉的频率

ALCbooleanalcCaptureCloseDevice (ALCdevice *device);

void alcCaptureStart(ALCdevice *device); //启动捕捉，数据存入一个内部环形buffer，buffer大小是opendevice时候传入。通过alcGetIntegerv和ALC_CAPTURE_SAMPLES可以获得当前有效采样数，然后可用alcCaptureSamples获得已经采样的样本。

void alcCaptureStop(ALCdevice *device);

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