SDL2纹理无法复制到渲染器：添加光照后屏幕黑屏求助

核心问题分析 #

你的主项目与测试项目的核心差异在于渲染目标的清理时机、渲染流程顺序，且未对SDL API调用做错误检查，导致问题无法被快速定位。

排查与修复步骤 #

1. 强制检查所有SDL调用的错误返回值 #

SDL多数失败不会触发崩溃，但会静默失效，必须添加错误检查来定位问题：

// 检查纹理创建是否成功
this->background = SDL_CreateTexture(renderer, SDL_PIXELFORMAT_RGBA8888, SDL_TEXTUREACCESS_TARGET, this->dimensions.w, this->dimensions.h);
if (!this->background) {
    printf("创建背景纹理失败: %s\n", SDL_GetError());
    // 此处添加错误处理逻辑
}

// 检查RenderCopy调用是否成功
if (SDL_RenderCopy(this->renderer, entity.getTexture(), &src, &dest) < 0) {
    printf("精灵渲染失败: %s\n", SDL_GetError());
}

2. 修正渲染流程顺序错误 #

你的主项目present()函数存在提前清空background纹理的致命问题：在将resultLayer渲染到窗口并present后，立刻清空了background纹理，导致下次渲染时background为空。

正确的渲染流程应遵循：清空渲染目标 → 渲染内容到目标纹理 → 合成图层 → 渲染到窗口并present

修正后的present()函数示例：

void Game::present() {
    // 1. 提前清空所有渲染目标
    SDL_SetRenderTarget(this->renderer, this->background);
    SDL_SetRenderDrawColor(this->renderer, 0x00, 0x00, 0x00, 0xff);
    SDL_RenderClear(this->renderer);

    SDL_SetRenderTarget(this->renderer, this->lightLayer);
    SDL_SetRenderDrawColor(this->renderer, 0x00, 0x00, 0x00, 0xff);
    SDL_RenderClear(this->renderer);

    SDL_SetRenderTarget(this->renderer, this->resultLayer);
    SDL_SetRenderDrawColor(this->renderer, 0x00, 0x00, 0x00, 0xff);
    SDL_RenderClear(this->renderer);

    // 2. 合成background到resultLayer（后续可添加lightLayer合成）
    SDL_SetRenderTarget(this->renderer, this->resultLayer);
    SDL_RenderCopy(this->renderer, this->background, NULL, &this->dimensions);

    // 3. 渲染到窗口并显示
    SDL_SetRenderTarget(this->renderer, NULL);
    SDL_RenderClear(this->renderer);
    SDL_RenderCopy(this->renderer, this->resultLayer, NULL, &this->dimensions);
    SDL_RenderPresent(this->renderer);
}

3. 修正renderSprite函数的逻辑混乱 #

你的renderSprite函数参数传入了renderSurface但未使用，硬编码渲染目标为background，导致逻辑冗余且易出错：

void Game::renderSprite(Entity& entity, SDL_Texture* renderSurface)
{
    SDL_SetRenderTarget(this->renderer, renderSurface); // 使用传入的渲染目标

    SDL_Rect src = entity.getSpriteSheetRect();
    SDL_Rect dest = entity.getDimensions();

    SDL_RenderCopy(this->renderer, entity.getTexture(), &src, &dest);
}

4. 规范主循环的渲染顺序 #

主循环必须严格遵循流程，避免乱序操作：

while (!quit) {
    // 处理事件...

    // 1. 清空所有渲染目标
    game.clearRenderTargets(); // 可将之前的清空逻辑封装为单独函数

    // 2. 渲染所有tiles到background
    for (Chunk& chunk : *renderVec) {
        for (Tile& tile : chunk.getTiles()) {
            game.renderSprite(tile, game.background);
        }
    }

    // 3. 合成并显示
    game.present();
}

5. 验证渲染器与纹理格式兼容性 #

• 检查渲染器是否支持目标纹理与指定像素格式：

SDL_RendererInfo info;
SDL_GetRendererInfo(renderer, &info);
for (int i = 0; i < info.num_texture_formats; i++) {
    if (info.texture_formats[i] == SDL_PIXELFORMAT_RGBA8888) {
        printf("RGBA8888 格式已支持\n");
        break;
    }
}

• 创建渲染器时必须开启目标纹理支持：

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

测试项目正常运行的原因 #

测试项目的流程是：渲染内容到图层 → 合成到resultLayer → 渲染到窗口并present → 清空图层，顺序完全正确；而你的主项目是先present再清空background，导致下次渲染时background为空，最终出现黑屏。

内容的提问来源于stack exchange，提问作者Joeger-Bahar