SDL2窗口无法正常显示内容（C++）问题排查求助

问题描述 #

我编写了一段C++代码用于创建SDL2窗口并填充为红色，代码参考自可靠来源：

// test.cpp
#include <SDL2/SDL.h>

int main(int argc, char** argv)
{
    SDL_Init(SDL_INIT_EVERYTHING);

    SDL_Window* window = NULL;
    window = SDL_CreateWindow(
            "Title",
            SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED,
            640, 480,
            SDL_WINDOW_SHOWN
            );

    SDL_Renderer* renderer = NULL;
    renderer = SDL_CreateRenderer(window, -1, SDL_RENDERER_ACCELERATED);

    SDL_SetRenderDrawColor(renderer, 255, 0, 0, 255);
    
    SDL_RenderClear(renderer);
    SDL_RenderPresent(renderer);

    SDL_Delay(5000);

    SDL_DestroyWindow(window);
    SDL_Quit();

    return EXIT_SUCCESS;
}

使用命令 g++ -std=c++20 test.cpp -lSDL2 编译无报错，但运行后仅显示窗口框架，尺寸和红色内容均不显示，持续5秒后退出。使用系统为Ubuntu Studio 22.04。

编辑后情况：
将SDL_RenderPresent(renderer);替换为包含事件循环的代码块：

SDL_bool quit = SDL_FALSE;
while(!quit)
{
    SDL_RenderPresent(renderer);
    SDL_Event event;
    SDL_WaitEvent(&event);
    if(event.type == SDL_QUIT)
        quit = SDL_TRUE;
}

现在鼠标移入窗口时显示红色，移出时窗口变为黑色，不符合预期，需排查问题。

问题根源与解决方案 #

1. 初始代码问题原因 #

• 调用SDL_Delay会阻塞线程，导致SDL无法处理窗口初始化事件（如尺寸布局、渲染同步），窗口管理器无法完成窗口内容的渲染，因此仅显示框架。
• SDL_INIT_EVERYTHING初始化了所有SDL模块，属于冗余操作，建议仅初始化必要的SDL_INIT_VIDEO模块。

2. 编辑后代码问题原因 #

• SDL_WaitEvent会阻塞线程直到事件触发，仅在有事件时才调用SDL_RenderPresent，无法处理窗口重绘需求（如鼠标移入移出触发的窗口暴露事件）。当窗口需要重绘时，渲染缓冲区内容已丢失，未重新填充红色，导致窗口变黑。

正确代码实现 #

修改后的完整代码如下：

// test.cpp
#include <SDL2/SDL.h>
#include <cstdlib> // 用于EXIT_SUCCESS宏

int main(int argc, char** argv)
{
    // 仅初始化视频模块
    if (SDL_Init(SDL_INIT_VIDEO) != 0) {
        return EXIT_FAILURE;
    }

    SDL_Window* window = SDL_CreateWindow(
            "Title",
            SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED,
            640, 480,
            SDL_WINDOW_SHOWN
            );
    if (!window) {
        SDL_Quit();
        return EXIT_FAILURE;
    }

    // 添加垂直同步标志，避免画面撕裂
    SDL_Renderer* renderer = SDL_CreateRenderer(window, -1, SDL_RENDERER_ACCELERATED | SDL_RENDERER_PRESENTVSYNC);
    if (!renderer) {
        SDL_DestroyWindow(window);
        SDL_Quit();
        return EXIT_FAILURE;
    }

    SDL_bool quit = SDL_FALSE;
    while (!quit) {
        SDL_Event event;
        // 处理所有待处理事件，避免事件堆积
        while (SDL_PollEvent(&event)) {
            if (event.type == SDL_QUIT) {
                quit = SDL_TRUE;
            }
            // 处理窗口暴露事件，触发重绘
            else if (event.type == SDL_WINDOWEVENT) {
                if (event.window.event == SDL_WINDOWEVENT_EXPOSED) {
                    SDL_SetRenderDrawColor(renderer, 255, 0, 0, 255);
                    SDL_RenderClear(renderer);
                    SDL_RenderPresent(renderer);
                }
            }
        }

        // 持续执行渲染操作，确保窗口始终显示红色
        SDL_SetRenderDrawColor(renderer, 255, 0, 0, 255);
        SDL_RenderClear(renderer);
        SDL_RenderPresent(renderer);
    }

    // 按顺序清理资源
    SDL_DestroyRenderer(renderer);
    SDL_DestroyWindow(window);
    SDL_Quit();

    return EXIT_SUCCESS;
}

关键修改说明 #

• 使用SDL_PollEvent替代SDL_WaitEvent：非阻塞处理所有待处理事件，保证渲染循环持续运行。
• 处理SDL_WINDOWEVENT_EXPOSED事件：当窗口需要重绘时，重新执行渲染操作，确保红色背景始终显示。
• 添加错误检查：对SDL初始化、窗口和渲染器创建的返回值进行校验，便于排查初始化失败问题。
• 添加SDL_RENDERER_PRESENTVSYNC标志：让渲染与显示器垂直同步，优化显示效果。
• 规范资源清理顺序：先销毁渲染器，再销毁窗口，避免资源泄漏。

内容的提问来源于stack exchange，提问作者Jo Mo