SDL2播放动图异常：GIF正常但WebP动图解码失败求助

问题现象 #

代码可正常播放GIF动图、静态GIF及静态WebP，但加载WebP动图时控制台提示解码失败，错误信息：

Couldn't load Failed to decode WEBP: �w♥☺

环境与疑问点 #

• 使用SDL2最新版本搭配SDL_image，原依赖SDL_image发行版自带的libwebp-7.dll，自行编译WebP后得到libwebpdecoder.dll、libwebpdemux.dll及对应lib文件，不确定DLL命名差异（发行版为libwebp-7.dll，自行编译为libwebp.dll）是否引发问题。
• 采用VS2019编译，尝试过官网示例与VS2019控制台编译方式，不清楚是否需额外编译选项让SDL_image支持WebP动图，也不了解Windows下编译SDL_image时如何添加webp/extra目录。

相关代码片段 #

#include <SDL.h> 
#include <SDL_image.h>
#include<iostream>
#include <decode.h>
#include <demux.h>
#include "SDL_endian.h"

SDL_Window* window;
SDL_Renderer* renderer;
IMG_Animation* anim;
SDL_Texture** textures;

//anim = IMG_LoadAnimation("logo.gif");  // 动图/静态图均可正常播放
anim = IMG_LoadAnimation("anim.webp"); // 静态WebP正常，动图解码失败

解决方案 #

1. 统一WebP库命名与依赖 #

SDL_image发行版依赖命名为libwebp-7.dll的库，自行编译生成的拆分库（libwebpdecoder.dll、libwebpdemux.dll）命名不匹配，会导致SDL_image无法调用WebP动图解码所需的解复用组件。解决方式：

• 直接使用SDL_image官方发行版配套的libwebp-7.dll，确保版本与SDL_image兼容，无需自行编译WebP。
• 若必须自行编译WebP，需将编译生成的libwebpdecoder.dll、libwebpdemux.dll合并或重命名为SDL_image期望的libwebp-7.dll（注意版本号对应），并将所有相关DLL放入程序运行目录。

2. 编译SDL_image时开启WebP动图支持 #

Windows下用VS2019编译SDL_image时，需正确配置WebP依赖并开启动图支持：

• 下载SDL_image源码，将WebP源码（包含webp/extra目录）放入SDL_image的依赖目录。
• 在VS2019项目中添加WebP头文件路径（包含decode.h、demux.h的目录）。
• 链接WebP的静态库（libwebpdecoder.lib、libwebpdemux.lib）或动态库导入库。
• 编译SDL_image时，定义宏IMG_WEBP和IMG_WEBP_ANIMATION，确保启用WebP动图解码功能。

3. 验证WebP动图文件完整性 #

确认测试用的anim.webp为标准WebP动图文件，可通过WebP官方工具（如webpinfo）检查文件是否损坏或不符合动图格式规范。

内容的提问来源于stack exchange，提问作者RFS Vieira