当前位置：首页 > C++ > 正文

C++ SDL2图像加载（从零开始学会在SDL2中加载并显示图片）

主机测评网
C++
2025-12-19
229

在使用C++进行游戏开发或图形应用开发时，SDL2（Simple DirectMedia Layer 2）是一个非常流行且功能强大的跨平台多媒体库。本教程将手把手教你如何在C++ SDL2图像加载过程中加载并显示一张图片，即使你是编程小白也能轻松上手！

为什么选择SDL2？

SDL2支持窗口创建、输入处理、音频播放以及最重要的——图像加载与渲染。它被广泛应用于C++游戏开发中，比如《Minecraft》早期版本就使用了SDL。

准备工作

在开始之前，请确保你已完成以下步骤：

安装了C++编译器（如GCC、Clang或MSVC）
正确配置了SDL2开发库（包括头文件和动态链接库）
准备一张测试图片（例如 test.png）放在项目目录下

C++ SDL2图像加载（从零开始学会在SDL2中加载并显示图片） SDL2图像加载 SDL2教程 C++游戏开发 SDL2图片显示第1张

第一步：初始化SDL2

首先，我们需要初始化SDL的视频子系统，这样才能创建窗口和渲染器。

#include <iostream>#include <SDL2/SDL.h>int main(int argc, char* argv[]) {    // 初始化SDL视频子系统    if (SDL_Init(SDL_INIT_VIDEO) != 0) {        std::cerr << "SDL初始化失败: " << SDL_GetError() << std::endl;        return -1;    }    // 创建窗口    SDL_Window* window = SDL_CreateWindow(        "SDL2图像加载示例",        SDL_WINDOWPOS_CENTERED,        SDL_WINDOWPOS_CENTERED,        800, 600,        SDL_WINDOW_SHOWN    );    if (!window) {        std::cerr << "窗口创建失败: " << SDL_GetError() << std::endl;        SDL_Quit();        return -1;    }    // 创建渲染器    SDL_Renderer* renderer = SDL_CreateRenderer(window, -1, SDL_RENDERER_ACCELERATED);    if (!renderer) {        std::cerr << "渲染器创建失败: " << SDL_GetError() << std::endl;        SDL_DestroyWindow(window);        SDL_Quit();        return -1;    }    // 后续代码将在这里添加...    // 清理资源    SDL_DestroyRenderer(renderer);    SDL_DestroyWindow(window);    SDL_Quit();    return 0;}

第二步：加载图片（使用SDL_image扩展库）

SDL2本身不直接支持PNG、JPG等格式，需要借助SDL_image扩展库。请确保你已安装SDL2_image。

首先包含头文件：

#include <SDL2/SDL_image.h>

然后初始化SDL_image并加载图片：

    // 初始化SDL_image，支持PNG和JPG    int imgFlags = IMG_INIT_PNG | IMG_INIT_JPEG;    if (!(IMG_Init(imgFlags) & imgFlags)) {        std::cerr << "SDL_image初始化失败: " << IMG_GetError() << std::endl;        SDL_DestroyRenderer(renderer);        SDL_DestroyWindow(window);        SDL_Quit();        return -1;    }    // 加载图片为SDL_Texture    SDL_Texture* texture = IMG_LoadTexture(renderer, "test.png");    if (!texture) {        std::cerr << "图片加载失败: " << IMG_GetError() << std::endl;        IMG_Quit();        SDL_DestroyRenderer(renderer);        SDL_DestroyWindow(window);        SDL_Quit();        return -1;    }

第三步：渲染图片到窗口

现在我们有了纹理（texture），可以将其绘制到屏幕上。通常在一个主循环中完成渲染：

    bool quit = false;    SDL_Event e;    while (!quit) {        while (SDL_PollEvent(&e)) {            if (e.type == SDL_QUIT) {                quit = true;            }        }        // 清空屏幕为白色        SDL_SetRenderDrawColor(renderer, 255, 255, 255, 255);        SDL_RenderClear(renderer);        // 渲染图片（居中显示）        int texW = 0, texH = 0;        SDL_QueryTexture(texture, nullptr, nullptr, &texW, &texH);        SDL_Rect dstRect = {            (800 - texW) / 2,            (600 - texH) / 2,            texW,            texH        };        SDL_RenderCopy(renderer, texture, nullptr, &dstRect);        // 更新屏幕        SDL_RenderPresent(renderer);    }

第四步：完整代码整合

以下是完整的可运行代码：

#include <iostream>#include <SDL2/SDL.h>#include <SDL2/SDL_image.h>int main(int argc, char* argv[]) {    if (SDL_Init(SDL_INIT_VIDEO) != 0) {        std::cerr << "SDL初始化失败: " << SDL_GetError() << std::endl;        return -1;    }    SDL_Window* window = SDL_CreateWindow(        "SDL2图像加载示例",        SDL_WINDOWPOS_CENTERED,        SDL_WINDOWPOS_CENTERED,        800, 600,        SDL_WINDOW_SHOWN    );    if (!window) {        std::cerr << "窗口创建失败: " << SDL_GetError() << std::endl;        SDL_Quit();        return -1;    }    SDL_Renderer* renderer = SDL_CreateRenderer(window, -1, SDL_RENDERER_ACCELERATED);    if (!renderer) {        std::cerr << "渲染器创建失败: " << SDL_GetError() << std::endl;        SDL_DestroyWindow(window);        SDL_Quit();        return -1;    }    int imgFlags = IMG_INIT_PNG | IMG_INIT_JPEG;    if (!(IMG_Init(imgFlags) & imgFlags)) {        std::cerr << "SDL_image初始化失败: " << IMG_GetError() << std::endl;        SDL_DestroyRenderer(renderer);        SDL_DestroyWindow(window);        SDL_Quit();        return -1;    }    SDL_Texture* texture = IMG_LoadTexture(renderer, "test.png");    if (!texture) {        std::cerr << "图片加载失败: " << IMG_GetError() << std::endl;        IMG_Quit();        SDL_DestroyRenderer(renderer);        SDL_DestroyWindow(window);        SDL_Quit();        return -1;    }    bool quit = false;    SDL_Event e;    while (!quit) {        while (SDL_PollEvent(&e)) {            if (e.type == SDL_QUIT) {                quit = true;            }        }        SDL_SetRenderDrawColor(renderer, 255, 255, 255, 255);        SDL_RenderClear(renderer);        int texW = 0, texH = 0;        SDL_QueryTexture(texture, nullptr, nullptr, &texW, &texH);        SDL_Rect dstRect = { (800 - texW) / 2, (600 - texH) / 2, texW, texH };        SDL_RenderCopy(renderer, texture, nullptr, &dstRect);        SDL_RenderPresent(renderer);    }    // 清理资源    SDL_DestroyTexture(texture);    IMG_Quit();    SDL_DestroyRenderer(renderer);    SDL_DestroyWindow(window);    SDL_Quit();    return 0;}