01_使用SDL2创建一个窗口

01_使用SDL2创建一个窗口

SDL2维基文档地址：SDL2_WIKI

现在正是开始SDL2的C语言教程，我写的教程是基于SDL2维基文档提供的C++教程：A collection of detailed tutorials for game programming using SDL 2.0 with C++；

程序以及相关文档保存在百度网盘：SDL2文件

基于我的理解转换的C语言教程，如果出现哪些错误，请大佬多加指正，谢谢！！

让我们开始我们的教程。

SDL2创建一个窗口

首先我们先创建一个SDL2的窗口，这是SDL2显示的基础。

我们先要使用SDL2做出的东西都要在窗口上面进行显示，这是一切程序的基础。

完整代码：

#include <SDL2/SDL.h>
#include <stdio.h>

int main(int argc, char *argv[])
{
    // 初始化SDL2
    if(SDL_Init(SDL_INIT_VIDEO) != 0)
    {
        printf("SDL_Init Error: %s\n", SDL_GetError());
        return 1;
    }

    // 创建窗口
    SDL_Window *win = SDL_CreateWindow("SDL2 Window", 100, 100, 640, 480, SDL_WINDOW_SHOWN);
    if(win == NULL)
    {
        printf("SDL_CreateWindow Error: %s\n", SDL_GetError());
        SDL_Quit();
        return 1;
    }

    // 延时3秒
    SDL_Delay(3000);

    // 销毁窗口
    SDL_DestroyWindow(win);

    // 退出SDL2
    SDL_Quit();

    return 0;
}

接下来我们来解释使用的函数。

01：初始化

使用SDL2前，首先得进行SDL2的初始化。下面是初始化函数，用于初始化SDL2d的各个子系统：

extern DECLSPEC int SDLCALL SDL_Init(Uint32 flags);

参数:

• flags：一个或多个子系统的 位掩码（bitmask），用按位或（|）组合。常见子系统包括：
  • SDL_INIT_VIDEO：视频子系统（窗口、渲染器、事件等）。
  • SDL_INIT_AUDIO：音频子系统。
  • SDL_INIT_TIMER：定时器子系统。
  • SDL_INIT_JOYSTICK：游戏手柄子系统。
  • SDL_INIT_HAPTIC：力反馈（如震动）子系统。
  • SDL_INIT_GAMECONTROLLER：高级游戏控制器支持。
  • SDL_INIT_EVENTS：事件处理子系统（通常隐含在其他子系统中）。
  • SDL_INIT_EVERYTHING：初始化所有子系统。

返回值：

• 成功：返回 0。
• 失败：返回负值，可通过 SDL_GetError() 获取错误信息。

我们在这里只需要创建一个窗口，所以使用：SDL_INIT_VIDEO

// 初始化SDL2
    if(SDL_Init(SDL_INIT_VIDEO) != 0)
    {
        printf("SDL_Init Error: %s\n", SDL_GetError());
        return 1;
    }

如果返回0则成功，如果返回非0则失败，退出程序！

02：创建窗口

创建窗口函数原型：

extern DECLSPEC SDL_Window * SDLCALL SDL_CreateWindow(const char *title,
                                                      int x, int y, int w,
                                                      int h, Uint32 flags);

参数：

常用标志：

返回值：

• 成功：返回指向 SDL_Window 的指针。
• 失败：返回 NULL，通过 SDL_GetError() 获取错误信息。

我们创建一个标题为 “SDL2 Window” ，大小为640*480的窗口，位置处于 x=100， y=100，标志位默认就行。

SDL_Window *win = SDL_CreateWindow("SDL2 Window", 100, 100, 640, 480,SDL_WINDOW_SHOWN);
if(win == NULL)
    {
        printf("SDL_CreateWindow Error: %s\n", SDL_GetError());
        SDL_Quit();
        return 1;
    }

03：延时等待

延时函数原型：

extern DECLSPEC void SDLCALL SDL_Delay(Uint32 ms);

参数：

• Uint32 ms：毫秒。

我们这里延时个3秒就行了，如果没有延时函数，那么窗口只会在桌面上一闪而逝，那肯定是不行的。

 SDL_Delay(3000);

04：销毁窗口

函数原型:

extern DECLSPEC void SDLCALL SDL_DestroyWindow(SDL_Window * window);

作用：

• 销毁由 SDL_CreateWindow 创建的窗口。
• 释放相关的图形资源（如 OpenGL 上下文、渲染器等）。
• 不会释放指针本身，但 不再安全使用，应手动置空。

参数：

• SDL_Window * window：一个指向SDL2窗口指针。

注意事项：

当程序退出时，最终都需要调用SDL_Destorywindow()函数释放你创建的窗口，否则会造成内存泄漏！

05：退出程序

函数原型：

extern DECLSPEC void SDLCALL SDL_Quit(void);

作用：

• 程序结束前 只调用一次。
• 退出SDL2程序
• 与 SDL_Init 成对出现。
• 不会 自动销毁你手动创建的 SDL_Window、SDL_Renderer 等。

每当你的SDL2程序退出前，必须调用，告诉系统要退出。

 SDL_Quit();

05：编译程序

选中main.c文件，右键从集成终端打开

在终端中相应输入：

gcc -g -o show main.o -Lsrc/include -Lsrc/lib -lmingw32 -lSDL2main -lSDL2

gcc -g -c main.c -Isrc/include -lsrc/lib -lmingw32 -lSDL2main -lSDL2

.\show.exe

然后可以看见桌面上打开一个窗口，3秒后消失

总结

以上，就是如何使用SDL2创建一个窗口的教程。