109 lines
4.8 KiB
C
109 lines
4.8 KiB
C
|
//--------------------------------------------------------------------------------------------------
|
|||
|
|
// OpenAL ExtEdition SDK
|
|||
|
|
//
|
|||
|
|
// 这是一个根据标准OpenAL SDK所编写的特殊增强版本，它支持目前所有的OpenAL扩展。
|
|||
|
|
//
|
|||
|
|
// 作者: 胡颖卓
|
|||
|
|
// 版本: 1.15
|
|||
|
|
// 对应OpenAL版本: 1.1
|
|||
|
|
// 对应语言: C/C++
|
|||
|
|
// 对应操作系统: Windows,MacOSX,iOS,Linux,BSD,Android
|
|||
|
|
//
|
|||
|
|
// 第一版编写时间: 2003年10月5日
|
|||
|
|
// 当前版完成时间: 2015年7月6日
|
|||
|
|
//
|
|||
|
|
// 官方网站: http://www.hyzgame.com.cn
|
|||
|
|
// OpenAL官方网站: http://www.openal.org
|
|||
|
|
//--------------------------------------------------------------------------------------------------
|
|||
|
|
#ifndef OpenALH
|
|||
|
|
#define OpenALH
|
|||
|
|
|
|||
|
|
#ifdef __al_h_
|
|||
|
|
#error 请不要使用原始的OpenAL头文件
|
|||
|
|
#else
|
|||
|
|
#define __al_h_
|
|||
|
|
#endif //__al_h_
|
|||
|
|
|
|||
|
|
#include<hgl/platform/Platform.h>
|
|||
|
|
#include<hgl/type/List.h>
|
|||
|
|
|
|||
|
|
#include<hgl/al/al.h>
|
|||
|
|
#include<hgl/al/alc.h>
|
|||
|
|
#include<hgl/al/xram.h>
|
|||
|
|
#include<hgl/al/efx.h>
|
|||
|
|
|
|||
|
|
namespace openal ///OpenAL EE所使用的名字空间
|
|||
|
|
{
|
|||
|
|
bool LoadOpenAL(const os_char *driver_name=nullptr); ///<加载OpenAL,参数为驱动名称
|
|||
|
|
|
|||
|
|
#define AL_DEVICE_NAME_MAX_LEN 256 ///<音频设备名称最大长度
|
|||
|
|
|
|||
|
|
struct OpenALDevice
|
|||
|
|
{
|
|||
|
|
char name[AL_DEVICE_NAME_MAX_LEN]; ///<设备名称
|
|||
|
|
char specifier[AL_DEVICE_NAME_MAX_LEN]; ///<设备技术名称
|
|||
|
|
int major,minor; ///<设备版本号
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
bool alcGetDefaultDevice(OpenALDevice &); ///<取得缺省设备
|
|||
|
|
int alcGetDeviceList(hgl::List<OpenALDevice> &); ///<取得设备列表
|
|||
|
|
|
|||
|
|
void alcSetDefaultContext(); ///<设置缺省上下文
|
|||
|
|
|
|||
|
|
const char *alGetErrorInfo(const char *,const int); ///<取得最近的错误
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 初始化OpenAL驱动
|
|||
|
|
* @param driver_name 驱动名称
|
|||
|
|
* @return 是否成功
|
|||
|
|
*/
|
|||
|
|
bool InitOpenALDriver(const os_char *driver_name=nullptr); ///<初始化OpenAL驱动
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 初始化OpenAL设备
|
|||
|
|
* @param device 设备名称
|
|||
|
|
* @return 是否成功
|
|||
|
|
*/
|
|||
|
|
bool InitOpenALDevice(const OpenALDevice *device=nullptr);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 初始化OpenAL驱动与设备(使用本函数等同于依次调用InitOpenALDriver,InitOpenALDevice)
|
|||
|
|
*/
|
|||
|
|
bool InitOpenAL(const os_char *driver_name=nullptr,
|
|||
|
|
const char *device_name=nullptr,
|
|||
|
|
bool out_info=false,
|
|||
|
|
bool enum_device=false);
|
|||
|
|
|
|||
|
|
void CloseOpenAL(); ///<关闭OpenAL
|
|||
|
|
|
|||
|
|
unsigned int AudioTime(ALenum,ALsizei);
|
|||
|
|
double AudioDataTime(ALuint,ALenum,ALsizei);
|
|||
|
|
|
|||
|
|
bool IsSupportFloatAudioData(); ///<是否支持浮点音频数据
|
|||
|
|
|
|||
|
|
// #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 //钳位指数距离
|
|||
|
|
bool SetDistanceModel(ALenum dm = AL_INVERSE_DISTANCE_CLAMPED); ///<设置距离模型
|
|||
|
|
|
|||
|
|
bool SetSpeedOfSound(const float ss = 1.0f); ///<设置声音速度比值
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 根据海拔和温度设置音速
|
|||
|
|
* @param height 海拔高度
|
|||
|
|
* @param temperature 温度(摄氏度)
|
|||
|
|
* @param humidity 相对湿度
|
|||
|
|
* @return 音速(米/秒)
|
|||
|
|
*/
|
|||
|
|
double SetSpeedOfSound(const double height=0,const double temperature=15,const double humidity=0.5); ///<根据海拔和温度设置音速
|
|||
|
|
|
|||
|
|
bool SetDopplerFactor(const float); ///<设置多普勒缩放倍数
|
|||
|
|
bool SetDopplerVelocity(const float); ///<设置多普勒速度
|
|||
|
|
//--------------------------------------------------------------------------------------------------
|
|||
|
|
#define alLastError() alGetErrorInfo(__FILE__,__LINE__)
|
|||
|
|
}//namespace openal
|
|||
|
|
#endif //OpenALH
|