SDL2开发游戏时SDL2_image显示黑屏无报错问题求助

我在使用SDL开发游戏时遇到了问题：本该显示图片的区域始终是黑屏状态，且没有任何报错信息。但奇怪的是，我单独创建了一个仅包含main.cpp的测试项目，使用完全相同的图片加载逻辑却能正常显示图片。

游戏项目代码 #

main.cpp #

#include <SDL2\SDL.h>
#include <SDL2\SDL_image.h>
#include <iostream>
#include <stdio.h>
#include "RenderWindow.hpp"

int main(int argc, char** argv){
    if (SDL_Init(SDL_INIT_VIDEO) > 0)
        std::cout << "SDL_init has crushed" << SDL_GetError() << std::endl;

    if (!(IMG_Init(IMG_INIT_PNG)))
        std::cout << "IMG_init has failed. Error: " << IMG_GetError() << std::endl;

    RenderWindow window("Game",640,480);

    SDL_Texture* grassTexture = window.loadTexture("images/ground_grass_1.png");

    bool gameRunning = true;

    SDL_Event event;

    while(gameRunning)
    {
        while(SDL_PollEvent(&event))
        {
            if(event.type == SDL_QUIT)
                gameRunning = false;
        }

        window.clear();
        window.render(grassTexture);
        window.display();
    }


    window.cleanUp();
    IMG_Quit();
    SDL_Quit();

    return 0;
}

RenderWindow.hpp #

#pragma once 
#include <SDL2\SDL.h>
#include <SDL2\SDL_image.h>

class RenderWindow
{
    public:
        RenderWindow(const char* p_title, int p_w, int p_h);
        SDL_Texture* loadTexture(const char* p_filePath);
        void cleanUp();
        void clear();
        void render(SDL_Texture* p_text);
        void display();
    private:
        SDL_Window* window; 
        SDL_Renderer* renderer; 
}; 

renderwindow.cpp #

#include <SDL2\SDL.h>
#include <SDL2\SDL_image.h>
#include <iostream>

#include "RenderWindow.hpp"

RenderWindow::RenderWindow(const char* p_title, int p_w, int p_h)
    :window(NULL), renderer(NULL)
{
    window = SDL_CreateWindow(p_title,SDL_WINDOWPOS_UNDEFINED,SDL_WINDOWPOS_UNDEFINED,p_w,p_h,SDL_WINDOW_SHOWN);

    if(window == NULL)
        std::cout << "Window failed to init" << SDL_GetError() << std::endl; 

    renderer = SDL_CreateRenderer(window,-1,SDL_RENDERER_ACCELERATED);

    if(renderer == NULL)
        std::cout << "Renderer failed to init" << SDL_GetError() << std::endl;
}

SDL_Texture* RenderWindow::loadTexture(const char* p_filePath)
{
    SDL_Texture* texture = NULL;
    texture = IMG_LoadTexture(renderer,p_filePath);

    if(texture = NULL)
        std::cout << "Failed to load texture. Error: " << SDL_GetError() << std::endl;

    return texture; 
}

void RenderWindow::cleanUp()
{
    SDL_DestroyWindow(window);
}

void RenderWindow::clear()
{
    SDL_RenderClear(renderer);
}

void RenderWindow::render(SDL_Texture* p_tex)
{
    SDL_RenderCopy(renderer,p_tex,NULL,NULL);
}

void RenderWindow::display()
{
    SDL_RenderPresent(renderer);
}

测试项目代码 #

main.cpp #

#include <SDL2/SDL.h>  // include the SDL library
#include <SDL2/SDL_image.h>  // include the SDL_image library for loading image files
#include <iostream>


int main(int argc, char* argv[]) {
  // initialize SDL
  if (SDL_Init(SDL_INIT_VIDEO) < 0) {
    std::cout << "SDL initialization failed: " << SDL_GetError() << std::endl;
    return 1;
  }

  // create the window
  SDL_Window* window = SDL_CreateWindow("My Window", SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED, 640, 480, SDL_WINDOW_SHOWN);
  if (window == NULL) {
    std::cout << "Failed to create window: " << SDL_GetError() << std::endl;
    return 1;
  }

  // create the renderer
  SDL_Renderer* renderer = SDL_CreateRenderer(window, -1, SDL_RENDERER_ACCELERATED);
  if (renderer == NULL) {
    std::cout << "Failed to create renderer: " << SDL_GetError() << std::endl;
    return 1;
  }

  // load the image file    
  SDL_Texture* texture = IMG_LoadTexture(renderer, "ground_grass_1.png");
  if (texture == NULL) {
    std::cout << "Failed to load image: " << SDL_GetError() << std::endl;
    return 1;
  }

  // render the image
  SDL_RenderCopy(renderer, texture, NULL, NULL);
  SDL_RenderPresent(renderer);

  // wait for 5 seconds
  SDL_Delay(5000);

  // clean up
  SDL_DestroyTexture(texture);
  SDL_DestroyRenderer(renderer);
  SDL_DestroyWindow(window);
  SDL_Quit();

  return 0;
}

问题排查与解决 #

1. 核心错误：赋值操作混淆为相等判断 #

在renderwindow.cpp的loadTexture函数中，存在致命语法错误：

if(texture = NULL)  // 此处是赋值操作，而非相等判断

这行代码会强制将NULL赋值给texture，无论IMG_LoadTexture是否成功加载纹理。赋值表达式结果为NULL，会触发错误提示，但此时texture已被设为无效值，后续渲染时传入空纹理导致黑屏。

修复方法：改为相等判断：

if(texture == NULL)

2. 图片路径不一致 #

游戏项目加载路径为"images/ground_grass_1.png"，测试项目为"ground_grass_1.png"。需确认游戏项目执行目录下是否存在images文件夹，且内部包含目标图片。路径错误会导致纹理加载失败，即使修复判断逻辑也无法显示图片。

3. SDL初始化判断逻辑错误 #

游戏项目中SDL初始化的判断条件错误：

if (SDL_Init(SDL_INIT_VIDEO) > 0)

SDL初始化成功返回0，失败返回负数，正确判断应为：

if (SDL_Init(SDL_INIT_VIDEO) != 0)
// 或
if (SDL_Init(SDL_INIT_VIDEO) < 0)

原逻辑会导致SDL初始化失败时无法触发正确的错误提示。

4. 资源清理不完整 #

RenderWindow的cleanUp函数仅销毁窗口，未销毁渲染器，需补充：

void RenderWindow::cleanUp()
{
    SDL_DestroyRenderer(renderer);
    SDL_DestroyWindow(window);
}

同时在main函数中手动销毁加载的纹理：

SDL_DestroyTexture(grassTexture);

完成以上修复后，重新编译运行游戏项目，图片即可正常显示。

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