SDL C++渲染.bmp图片黑屏问题求助

核心问题 #

你的代码把SDL_BlitSurface和SDL_UpdateWindowSurface放在了事件循环之后——这意味着只有当你关闭窗口触发SDL_QUIT后，才会执行图像绘制和窗口更新，但此时程序马上就会进入延迟并退出，所以你根本看不到图片显示。

修复后的完整代码 #

#include <SDL.h>
#include "engine.cpp"
#include <iostream>

using namespace std;

int main(int argc, char* argv[]) {
    bool quit = false;
    SDL_Event event;

    // 仅初始化视频模块即可，无需初始化所有模块
    if (SDL_Init(SDL_INIT_VIDEO) != 0) {
        cerr << "SDL初始化失败: " << SDL_GetError() << endl;
        return 1;
    }

    SDL_Surface *imageSurface = NULL;
    SDL_Surface* windowSurface = NULL;

    SDL_Window* window = SDL_CreateWindow("SDL2 Displaying Image", 
                                         SDL_WINDOWPOS_UNDEFINED, 
                                         SDL_WINDOWPOS_UNDEFINED, 
                                         640, 480, 0);
    if (!window) {
        cerr << "创建窗口失败: " << SDL_GetError() << endl;
        SDL_Quit();
        return 1;
    }

    // 你创建了Renderer但未使用，若用Surface渲染可删除该行
    // SDL_Renderer* renderer = SDL_CreateRenderer(window, -1, 0);

    windowSurface = SDL_GetWindowSurface(window);
    imageSurface = SDL_LoadBMP("hello.bmp");
    
    // 检查图片加载是否成功
    if (!imageSurface) {
        cerr << "加载图片失败: " << SDL_GetError() << endl;
        SDL_DestroyWindow(window);
        SDL_Quit();
        return 1;
    }

    // 将绘制逻辑移入事件循环内部
    while (!quit) {
        // 用SDL_PollEvent替代SDL_WaitEvent，避免阻塞导致画面无法更新
        while (SDL_PollEvent(&event)) {
            switch (event.type) {
            case SDL_QUIT:
                quit = true;
                break;
            }
        }

        // 把图片绘制到窗口Surface
        SDL_BlitSurface(imageSurface, NULL, windowSurface, NULL);
        // 更新窗口显示
        SDL_UpdateWindowSurface(window);
    }

    // 释放资源
    SDL_FreeSurface(imageSurface);
    SDL_DestroyWindow(window);
    SDL_Quit();
    return 0;
}

关键修改说明 #

• 绘制逻辑移至事件循环内：确保每次循环都会执行绘制和窗口更新，图片能持续显示
• 替换事件处理函数：SDL_WaitEvent会阻塞到有事件发生，导致画面无法正常刷新；SDL_PollEvent会处理所有待处理事件后立即返回，保证绘制流程持续运行
• 添加错误检查：对SDL初始化、窗口创建、图片加载等步骤增加校验，方便快速定位问题
• 清理冗余代码：移除未使用的Renderer对象，若后续要切换到硬件加速渲染，需改用SDL_CreateTextureFromSurface等Renderer相关API

额外注意事项 #

• 确认hello.bmp路径正确：相对路径需放在程序工作目录下，或直接使用绝对路径
• 注意BMP格式兼容性：SDL_LoadBMP默认支持24/32位无alpha通道的BMP，若需加载带透明通道的BMP，需使用SDL_image扩展库

内容的提问来源于stack exchange，提问作者Hudson Rocke