备忘错误解决的过程,前人栽树,后人乘凉。
适合阅读:刚配置完OpenAL的新手
平台:VS2013,OpenAL
错误描述:error C4996: ‘alutLoadWAVFile’: 被声明为已否决
使用工具包ALUT的版本比较新,在新版本中以下三个函数已经弃用!
下面是错误过程分析,授人以渔。直接看解决跳至页尾。
//源代码在alut.h中
ALUT_API ALUT_ATTRIBUTE_DEPRECATED void ALUT_APIENTRY alutLoadWAVFile (ALbyte *fileName, ALenum *format, void **data, ALsizei *size, ALsizei *frequency, ALboolean *loop);
ALUT_API ALUT_ATTRIBUTE_DEPRECATED void ALUT_APIENTRY alutLoadWAVMemory (ALbyte *buffer, ALenum *format, void **data, ALsizei *size, ALsizei *frequency, ALboolean *loop);
#endif
ALUT_API ALUT_ATTRIBUTE_DEPRECATED void ALUT_APIENTRY alutUnloadWAV (ALenum format, ALvoid *data, ALsizei size, ALsizei frequency);
找错误过程说明:一开始以为是VS的问题,查了很多无果,最后F12进去看 alutLoadWAVFile 函数声明看到了前面的 ALUT_ATTRIBUTE_DEPRECATED 进一步F12进入看这个宏的定义如下:
//源代码在alut.h中
/* Flag deprecated functions if possible (VisualC++ .NET and GCC >= 3.1.1). */
#if defined(_MSC_VER) && _MSC_VER >= 1300 && !defined(MIDL_PASS)
#define ALUT_ATTRIBUTE_DEPRECATED __declspec(deprecated)
#elif defined(__GNUC__) && (__GNUC__ > 3 || (__GNUC__ == 3 && (__GNUC_MINOR__ > 1 || (__GNUC_MINOR__ == 1 && __GNUC_PATCHLEVEL__ >= 1))))
#define ALUT_ATTRIBUTE_DEPRECATED __attribute__((deprecated))
#else
#define ALUT_ATTRIBUTE_DEPRECATED
#endif
简单来说此宏是用于弃用接口的,当工具库中有更新,需要淘汰一些老旧的接口,可以使用此宏,此时调用这些旧接口,不同的编译器均会报警,这是为了兼容之前的库。对于VS2013,调节报警级别后仍然是报错,所以也没有细究VS的问题,从ALUT库入手解决。
其实写到这里,也想提醒看文章的朋友包括自己,这个问题如果在通读了ALUT的使用文档情况下是不会发生的,所以工欲善其事的道理,学习一个新的语言,新的库还是不能跳过基础的部分,否则有的错其实很简单很基础,但是不知道就是发现不了。
(1)修改alut.h(不推荐),把其中的弃用宏删去,如下所示:
//源代码
//=============================================================打开弃用
#else
ALUT_API /*ALUT_ATTRIBUTE_DEPRECATED*/ void ALUT_APIENTRY alutLoadWAVFile(ALbyte *fileName, ALenum *format, void **data, ALsizei *size, ALsizei *frequency, ALboolean *loop);
ALUT_API /*ALUT_ATTRIBUTE_DEPRECATED*/ void ALUT_APIENTRY alutLoadWAVMemory(ALbyte *buffer, ALenum *format, void **data, ALsizei *size, ALsizei *frequency, ALboolean *loop);
#endif
ALUT_API /*ALUT_ATTRIBUTE_DEPRECATED*/ void ALUT_APIENTRY alutUnloadWAV(ALenum format, ALvoid *data, ALsizei size, ALsizei frequency);
//==============================================================打开弃用
只是把中间弃用宏给注释了,然后上面的代码放在原来的位置,原来的注释掉,这样从大多数介绍OpenAL博客的文章中直接黏贴过来的代码基本可以运行,因为这些文章大多写的比较早,而且有些重复很多。但这种方法是违背ALUT的理念的,通过查看文档,有更好的方法。
(2)使用新的加载音源函数(推荐)
其实ALUT中说的很明白,有一些新的用于加载音源的函数,比如这个:
ALuint alutCreateBufferFromFile (const char *filename);
函数说明:该函数尝试通过文件名来确定声音数据格式并将其加载到OpenAL的缓冲器中,返回一个指向包含加载的音源的缓冲器的句柄。也就是说此函数一次性做了如下三个工作。
alGenSources();//申请缓冲器
alutLoadWAVFile();//加载音源文件
alBufferData();//将音源放入缓冲器
ALUT做了很多类似的封装工作来方便我们操作OpenAL,具体的使用见另一篇文章。
至此,问题得以解决。