openal程序员手册.txt

来自「openal三维声音开发包的权威程序员手册」· 文本 代码 · 共 696 行 · 第 1/2 页

/////////////////////////////////////////////////////
alSourcePause
描述:
    用于暂停.
函数原型:
    ALvoid alSourcePause(ALuint source);
参数:
source                    用于暂停的声源的名字.
/////////////////////////////////////////////////////
alSourcePausev
描述:
    用于暂停一组声源.
函数原型:
    ALvoid alSourcePausev(ALsizei n,ALuint *sources);
参数:
n                         被暂停的声源的个数.
*sources                  指向被暂停的一组声源.
返回值:
    NONE
/////////////////////////////////////////////////////
alSourceStop
描述:
    用于停止一个声源.
函数原型:
    ALvoid alSourceStop(ALuint source);
参数:
source                    被停止的声源的名字
返回值:
    NONE
/////////////////////////////////////////////////////
alSourceStopv
描述:
    用于停止一组声源.
函数原型:
    ALvoid alSourceStopv(ALsizei n,ALuint *sources);
参数:
n                          被停止的声源的个数
*sources                   指向被停止的一组声源
返回值:
    NONE
/////////////////////////////////////////////////////
alSourceRewind
描述:
    停止声源并且设置他的状态为AL_INITIAL.
函数原型:
    ALvoid alSourceRewind(ALuint source);
参数:
source                     被停止的声源的名子
返回值:
    NONE
/////////////////////////////////////////////////////
alSourceRewindv
描述:
    停止一组声源并且设置它们的状态为AL_INITIAL.
函数原型:
    ALvoid alSourceRewindv(ALsizei n,ALuint *sources);
参数:
n                          被停止的声源的个数
*sources                   指向一组被停止的声源
返回值:
    NONE
/////////////////////////////////////////////////////
alSourceQueueBuffers
描述:
    用于把一个声源排列在一列缓冲器中.
函数原型:
    ALvoid alSourceQueueBuffers(ALuint source,ALsizei n,ALuint *buffers);
参数:
source                     被排列的声源的个数
n                          排在第几个缓冲器中
*buffers                   指向一组被排队的缓冲器的名字
返回值:
    NONE
/////////////////////////////////////////////////////
alSourceUnqueueBuffers
描述:
    用于将一个声源所用的一系列缓冲器退出队列.
函数原型:
    ALvoid alSourceUnqueueBuffers(ALuint source,ALsizei n,ALuint *buffers);
参数:
source                     被退出队列的声源的名字
n                          退出的缓冲器的个数
*buffers                   指向用于删除的缓冲器的名字的数组
返回值:
    NONE
评论:
    这个函数只在所有的缓冲器能被删除时 变换位置.
OPENAL程序员手册（四）

与听众有关
/////////////////////////////////////////////////////
alListenerf
描述:
    这个函数为听众设置一个浮点指针.
函数原型:
    ALvoid alListenerf(ALenum pname,ALfloat value);
参数:
pname                      被设置的属性的名字
value                      设置属性为浮点值
返回值:
    NONE
/////////////////////////////////////////////////////
alListenerf
描述:
    这个函数为听众设置浮点指针.
函数原型:
    ALvoid alListenerf(ALenum pname,ALfloat v1,ALfloat v2,ALfloat v3);
参数:
pname                      被设置的属性的名字
   AL_POSITION ,AL_VELOCITY
v1,v2,v3                   被设置的属性的值
返回值:
    NONE
/////////////////////////////////////////////////////
alListenerfv
描述:
    这个函数为听众设置浮点指针矢量.
函数原型:
    ALvoid alListenerfv(ALenum pname,ALfloat *values);
参数:
pname                      被设置的属性的名字
   AL_POSITION
   AL_VELOCITY
   AL_ORIENTATION
*values                    指向浮点指针矢量
返回值:
    NONE
/////////////////////////////////////////////////////
alListeneri
描述:
    这个函数为听众设置一个整型值.
函数原型:
    ALvoid alListeneri(ALenum pname,ALint value);
参数:
pname                      被设置的属性的名字
value                      用整型值设置属性
返回值:
    NONE
评论:
    当前没有整型听众属性.
/////////////////////////////////////////////////////
alGetListenerf
描述:
    这个函数用于取得听众的浮点指针.
函数原型:
    ALvoid alGetListenerf(ALenum pname,ALfloat *value);
参数:
pname                      被取得的属性的名字
   AL_GAIN
*value                     被取得的浮点指针值
返回值:
    NONE
/////////////////////////////////////////////////////
alGetListener3f
描述:
    这个函数取得听众的一列三个浮点指针值.
函数原型:
    ALvoid alGetListener3f(ALenum pname,ALfloat *v1,ALfloat *v2,ALfloat *v3);
参数:
pname                      被取得的参数的名字
   AL_POSITION
   AL_VELOCITY
*v1,*v2,*v3                用于存放三个浮点指针
返回值:
    NONE
/////////////////////////////////////////////////////
alGetListenerfv
描述:
    从听众处取得一个浮点指针矢量.
函数原型:
    ALvoid alGetListenerfv(ALenum pname,ALfloat *values);
参数:
pname                      被取得的属性的名字
   AL_POSITION
   AL_VELOCITY
   AL_ORIENTATION
*values                    用于存放浮点指针矢量
返回值:
    NONE
/////////////////////////////////////////////////////
alGetListeneri
描述:
    从听众处取得一个整型值.
函数原型:
    ALvoid alGetListeneri(ALenum pname,ALint *value);
参数:
pname                      被取得的属性的名字
*value                     用于存放整型值
返回值:
    NONE
评论:
    当前没有整型听众属性.

 OPENAL程序员手册（五）

与状态有关
/////////////////////////////////////////////////////
alEnable
描述:
    能使用OPENAL设备的功能.
函数原型:
    ALvoid alEnable(ALenum capability);
参数:
capability                 被使用的功能的名字
返回值:
    NONE
评论:
    当前,用这个函数不能释放功能,因此,当 被调用时有错误AL_INVALID_ENUM被引起.
/////////////////////////////////////////////////////
alDisable
描述:
    用于释放OPENAL的功能.
函数原型:
    ALvoid alDisable(ALenum capability);
参数:
capability                 被释放的功能的名字
返回值:
    NONE
评论:
    当前,没有一个功能能被这个函数释放,因此,当 被调用时有错误AL_INVALID_ENUM被引起.
/////////////////////////////////////////////////////
allsEnabled
描述:
    当一个特别的功能能被OPENAL设置启用时,返回一个boolean标识.
函数原型:
    ALboolean allsEnabled(ALenum capability);
参数:
capability                 被启用的功能的名字
返回值:
    AL_TRUE                表示功能启用
    AL_FLASE               表示功能释放
评论:
    当前,这个函数总是返回AL_FLASE,也没有功能定义.当 被调用时有错误AL_INVALID_ENUM被设置.
/////////////////////////////////////////////////////
alGetBoolean
描述:
    返回boolean openal状态.
函数原型:
    ALboolean alGetBoolean(ALenum pname);
参数:
pname                      被质问的状态
返回值:
    返回值用pname来描述.
评论:
    当前,没有任何的boolean状态被定义,因此这个函数总是发生AL_INVALID_ENUM错误.
/////////////////////////////////////////////////////
alGetDouble
描述:
    返回两个精确的浮点值指向OPENAL状态.
函数原型:
    ALdouble alGetDouble(ALenum pname);
参数:
pname                      被质问的状态
返回值:
    用pname指定两个值.
评论:
    当前没有任何东西,因此将产生错误.
/////////////////////////////////////////////////////
alGetFloat
描述:
    返回一个浮点值指向OPENAL状态.
函数原型:
    ALfloat alGetFloat(ALenum pname);
参数:
pname                      被质问的状态
   AL_DOPPLER_FACTOR
   AL_DOPPLER_VELOCITY
返回值:
    用pname来描述.
/////////////////////////////////////////////////////
alGetInteger
描述:
    返回一个指向OPENAL状态的整型值.
函数原型:
    ALint alGetIneger(ALenum pname);
参数:
pname                      被质问的状态
   AL_DISTANCE_MODEL
返回值:
    用pname来描述.
/////////////////////////////////////////////////////
alGetBooleanv
描述:
    用boolean值描述OPENAL的状态.
函数原型:
    ALvoid alGetBooleanv(ALenum pname,ALboolean *data);
参数:
pname                      返回的状态
*data                      指向状态存放的位置
返回值:
    NONE
评论:
    当前,没有任何描述,因此总是返回错误.
/////////////////////////////////////////////////////
alGetDoublev
描述:
    得到指向OPENAL状态的两个精确浮点值.
函数原型:
    ALvoid alGetDoublev(ALenum pname,ALdouble *data);
参数:
pname                      返回的状态
*data                      指向状态存放的位置
返回值:
    NONE
评论:
    (同上)
/////////////////////////////////////////////////////
alGetFloatv
描述:
    得到指向OPENAL状态的浮点值.
函数原型:
    ALvoid alGetFloatv(ALenum pname,ALfloat *data);
参数:
pname                      得到的状态
   AL_DOPPLER_FACTOR
   AL_DOPPLER_VELOCITY
*data                      指向状态存放的位置
返回值:
    NONE
/////////////////////////////////////////////////////
alGetIntegerv
描述:
    得到一个指向OPENAL状态的整型数组.
函数原型:
    ALvoid alGetIntegerv(ALenum pname,ALint *data);
参数:
pname                      返回的状态
   AL_DISTANCE_MODEL
*data                      指向状态存放的位置
返回值:
    NONE
/////////////////////////////////////////////////////
alGetString
描述:
    得到一个OPENAL字符串.
函数原型:
    ALubyte *alGetString(ALenum pname);
参数:
pname                      返回的值
   AL_VENDOR
   AL_VERSION
   AL_RENDERER
   AL_EXTENSIONS
返回值:
    NONE