SDL_image无法解码WebP图片求助（VS2019+C++环境）

问题情况 #

在Visual Studio 2019环境下用C++开发，SDL_image加载GIF、JPG、PNG格式图片均正常，但加载WebP格式图片时无任何效果，控制台提示Failed to decode WEBP。已完成SDL、SDL_image、WebP的头文件、库文件及DLL配置。

相关代码 #

#include <iostream>

#include <SDL.h>
#include <SDL_image.h>

const int WIDTH = 640, HEIGHT = 360;

int main(int argc, char* argv[])
{
    SDL_Surface* imageSurface = NULL;
    SDL_Surface* windowSurface = NULL;

    SDL_Init(SDL_INIT_EVERYTHING);

    SDL_Window* window = SDL_CreateWindow("Hello SDL World", SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED, WIDTH, HEIGHT, SDL_WINDOW_ALLOW_HIGHDPI);
    windowSurface = SDL_GetWindowSurface(window);

    // 检查窗口是否创建成功
    if (NULL == window)
    {
        std::cout << "无法创建窗口: " << SDL_GetError() << std::endl;
        return 1;
    }

    // 初始化WebP支持
    if (!(IMG_Init(IMG_INIT_WEBP) & IMG_INIT_WEBP))
    {
        std::cout << "无法初始化WebP支持: " << IMG_GetError() << std::endl;
        return 1;
    }

    SDL_Event windowEvent;

    // 加载WebP图片
    imageSurface = IMG_Load("logo.webp");

    if (NULL == imageSurface)
    {
        std::cout << "SDL无法加载图片! SDL错误: " << SDL_GetError() << std::endl;
    }

    while (true)
    {
        if (SDL_PollEvent(&windowEvent))
        {
            if (SDL_QUIT == windowEvent.type)
            {
                break;
            }
        }

        SDL_BlitSurface(imageSurface, NULL, windowSurface, NULL);

        SDL_UpdateWindowSurface(window);
    }

    // 资源释放
    SDL_FreeSurface(imageSurface);
    SDL_FreeSurface(windowSurface);

    imageSurface = NULL;
    windowSurface = NULL;

    SDL_DestroyWindow(window);
    SDL_Quit();

    return EXIT_SUCCESS;
}

排查与解决步骤 #

1. 修正错误信息获取方式 #

代码中加载WebP失败时调用SDL_GetError()，但SDL_image的解码错误需用IMG_GetError()才能获取真实原因。同时加载失败后应直接退出，避免后续空指针操作，修改代码如下：

if (NULL == imageSurface)
{
    std::cout << "无法加载WebP图片! IMG错误: " << IMG_GetError() << std::endl;
    return 1;
}

另外，IMG_Init的错误提示描述需修正为“无法初始化WebP支持”，避免误导。

2. 确认SDL_image的WebP支持性 #

部分预编译版SDL_image默认未包含WebP解码模块，需下载SDL官方提供的带WebP支持的SDL_image包，或自行编译SDL_image时开启WebP编译选项。

3. 验证WebP文件与路径 #

• 用图片查看器确认logo.webp文件未损坏，换用已知正常的WebP文件测试。
• 若使用相对路径，需确保图片位于程序运行的工作目录（如项目的Debug/Release文件夹），或直接使用绝对路径加载。

4. 核对DLL文件部署 #

运行时目录需存在SDL2_image.dll及对应版本的WebP相关DLL（如libwebp-7.dll、libwebpdemux-2.dll，具体取决于WebP版本），将这些文件直接复制到项目的Debug/Release目录即可避免路径问题。

5. 检查编译架构与链接库 #

• 项目编译架构（x86/x64）需与SDL、SDL_image、WebP库的架构完全一致，混编会导致隐性错误。
• 项目附加依赖项需包含SDL2.lib、SDL2main.lib、SDL2_image.lib及WebP库文件（如libwebp.lib）。

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