444 lines
9.5 KiB
Markdown
444 lines
9.5 KiB
Markdown
好问题，这两个点你问得**非常“C/系统向”**，而且正好卡在很多人学 SDL 时的认知断层上 👍
|
||
我分两块讲：**SDL_Window 从哪来 + 它到底干嘛**，然后给你一份**实用取向的 SDL 常用函数清单**。
|
||
|
||
---
|
||
|
||
## 一、`SDL_Window` 是从哪个文件来的？
|
||
|
||
### 1️⃣ 定义来源（最直接的答案）
|
||
|
||
```c
|
||
#include <SDL.h>
|
||
```
|
||
|
||
你在代码里看到的：
|
||
|
||
```c
|
||
SDL_Window* window;
|
||
```
|
||
|
||
**真正的定义在：**
|
||
|
||
```c
|
||
SDL_video.h
|
||
```
|
||
|
||
更准确地说是：
|
||
|
||
```c
|
||
// SDL_video.h
|
||
typedef struct SDL_Window SDL_Window;
|
||
```
|
||
|
||
👉 **注意：这里只是“前向声明”**
|
||
|
||
也就是说：
|
||
|
||
* SDL **故意不暴露 `struct SDL_Window` 的内部结构**
|
||
* 你只能用指针 `SDL_Window*`
|
||
* 不能 `sizeof(SDL_Window)`
|
||
* 不能 `window->xxx`
|
||
|
||
这是一种非常典型的 **C 风格封装（opaque type，不透明类型）**
|
||
|
||
---
|
||
|
||
### 2️⃣ 那 SDL_Window 里面到底是什么？
|
||
|
||
你可以把它理解成：
|
||
|
||
> 一个**跨平台的“窗口句柄封装”**
|
||
|
||
在不同平台上，内部可能是：
|
||
|
||
| 平台 | 内部可能包含 |
|
||
| ----------- | ---------------- |
|
||
| Windows | `HWND` |
|
||
| Linux (X11) | `Window` |
|
||
| Wayland | `wl_surface` |
|
||
| macOS | `NSWindow*` |
|
||
| Android | `ANativeWindow*` |
|
||
|
||
👉 SDL 把这些 **平台相关的脏活** 全吞了
|
||
👉 你只用 `SDL_Window*` 跟它打交道
|
||
|
||
---
|
||
|
||
## 二、`SDL_Window` 有什么用？
|
||
|
||
一句话总结：
|
||
|
||
> **SDL_Window = 所有图形输出与输入事件的“物理载体”**
|
||
|
||
### 具体用途
|
||
|
||
### ✅ 1️⃣ 创建一个真正的系统窗口
|
||
|
||
```c
|
||
SDL_Window* window = SDL_CreateWindow(
|
||
"Hello SDL",
|
||
SDL_WINDOWPOS_CENTERED,
|
||
SDL_WINDOWPOS_CENTERED,
|
||
800,
|
||
600,
|
||
SDL_WINDOW_SHOWN
|
||
);
|
||
```
|
||
|
||
没有 `SDL_Window`：
|
||
|
||
* 不能显示画面
|
||
* 不能接收键盘 / 鼠标
|
||
* 不能用 OpenGL / Vulkan / Metal
|
||
|
||
---
|
||
|
||
### ✅ 2️⃣ 图形渲染的绑定对象
|
||
|
||
| 渲染方式 | 依赖 |
|
||
| ------------ | ------------------------------ |
|
||
| SDL_Renderer | 绑定到 `SDL_Window` |
|
||
| OpenGL | `SDL_GL_CreateContext(window)` |
|
||
| Vulkan | `SDL_Vulkan_CreateSurface` |
|
||
|
||
---
|
||
|
||
### ✅ 3️⃣ 事件系统的窗口目标
|
||
|
||
SDL 事件里很多都**带 window id**：
|
||
|
||
```c
|
||
event.window.windowID
|
||
event.key.windowID
|
||
event.motion.windowID
|
||
```
|
||
|
||
这让 SDL 支持：
|
||
|
||
* 多窗口
|
||
* 窗口独立输入
|
||
|
||
---
|
||
|
||
### ✅ 4️⃣ 窗口管理（最常用）
|
||
|
||
```c
|
||
SDL_SetWindowTitle(window, "New Title");
|
||
SDL_SetWindowSize(window, 1024, 768);
|
||
SDL_MaximizeWindow(window);
|
||
SDL_MinimizeWindow(window);
|
||
SDL_SetWindowFullscreen(window, SDL_WINDOW_FULLSCREEN);
|
||
```
|
||
|
||
---
|
||
|
||
## 三、常用 SDL 函数「实战向」分类表
|
||
|
||
下面这份是 **你写 SDL 程序 80% 会用到的函数**
|
||
不是 API dump，是**真·常用**
|
||
|
||
---
|
||
|
||
## ① 初始化 / 退出
|
||
|
||
```c
|
||
SDL_Init(Uint32 flags);
|
||
SDL_InitSubSystem(Uint32 flags);
|
||
SDL_Quit();
|
||
SDL_QuitSubSystem(Uint32 flags);
|
||
```
|
||
|
||
常用 flag：
|
||
|
||
```c
|
||
SDL_INIT_VIDEO
|
||
SDL_INIT_AUDIO
|
||
SDL_INIT_EVENTS
|
||
SDL_INIT_TIMER
|
||
```
|
||
|
||
---
|
||
|
||
## ② 窗口（SDL_Window）
|
||
|
||
```c
|
||
SDL_CreateWindow(...)
|
||
SDL_DestroyWindow(SDL_Window*)
|
||
|
||
SDL_SetWindowTitle
|
||
SDL_GetWindowSize
|
||
SDL_SetWindowSize
|
||
SDL_SetWindowPosition
|
||
SDL_ShowWindow
|
||
SDL_HideWindow
|
||
SDL_RaiseWindow
|
||
SDL_MaximizeWindow
|
||
SDL_MinimizeWindow
|
||
SDL_RestoreWindow
|
||
SDL_SetWindowFullscreen
|
||
```
|
||
|
||
---
|
||
|
||
## ③ 渲染（SDL_Renderer，**2D 核心**）
|
||
|
||
```c
|
||
SDL_CreateRenderer
|
||
SDL_DestroyRenderer
|
||
|
||
SDL_SetRenderDrawColor
|
||
SDL_RenderClear
|
||
SDL_RenderCopy
|
||
SDL_RenderDrawLine
|
||
SDL_RenderDrawRect
|
||
SDL_RenderFillRect
|
||
SDL_RenderPresent
|
||
```
|
||
|
||
你之后如果写：
|
||
|
||
* 游戏
|
||
* GUI
|
||
* 可视化工具
|
||
👉 这一套用到吐
|
||
|
||
---
|
||
|
||
## ④ 纹理 & 表面（图片）
|
||
|
||
```c
|
||
SDL_LoadBMP
|
||
SDL_FreeSurface
|
||
|
||
SDL_CreateTextureFromSurface
|
||
SDL_DestroyTexture
|
||
SDL_UpdateTexture
|
||
```
|
||
|
||
配合 `SDL_image`：
|
||
|
||
```c
|
||
IMG_Load
|
||
```
|
||
|
||
---
|
||
|
||
## ⑤ 事件系统（非常重要）
|
||
|
||
```c
|
||
SDL_Event event;
|
||
|
||
SDL_PollEvent(&event);
|
||
SDL_WaitEvent(&event);
|
||
```
|
||
|
||
常见事件类型：
|
||
|
||
```c
|
||
SDL_QUIT
|
||
SDL_KEYDOWN
|
||
SDL_KEYUP
|
||
SDL_MOUSEBUTTONDOWN
|
||
SDL_MOUSEBUTTONUP
|
||
SDL_MOUSEMOTION
|
||
SDL_MOUSEWHEEL
|
||
SDL_WINDOWEVENT
|
||
```
|
||
|
||
---
|
||
|
||
## ⑥ 键盘 / 鼠标状态
|
||
|
||
```c
|
||
SDL_GetKeyboardState
|
||
SDL_GetMouseState
|
||
SDL_GetRelativeMouseState
|
||
```
|
||
|
||
键值：
|
||
|
||
```c
|
||
SDLK_w
|
||
SDLK_a
|
||
SDLK_s
|
||
SDLK_d
|
||
SDLK_ESCAPE
|
||
```
|
||
|
||
---
|
||
|
||
## ⑦ 时间 & 定时器
|
||
|
||
```c
|
||
SDL_GetTicks
|
||
SDL_Delay
|
||
SDL_AddTimer
|
||
SDL_RemoveTimer
|
||
```
|
||
|
||
游戏主循环必备：
|
||
|
||
```c
|
||
Uint32 last = SDL_GetTicks();
|
||
```
|
||
|
||
---
|
||
|
||
## ⑧ OpenGL / Vulkan（进阶）
|
||
|
||
```c
|
||
SDL_GL_CreateContext
|
||
SDL_GL_SwapWindow
|
||
SDL_GL_SetAttribute
|
||
```
|
||
|
||
---
|
||
|
||
## ⑨ 错误处理（强烈建议用）
|
||
|
||
```c
|
||
SDL_GetError
|
||
SDL_ClearError
|
||
```
|
||
|
||
典型写法：
|
||
|
||
```c
|
||
if (!window) {
|
||
printf("SDL error: %s\n", SDL_GetError());
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 四、一句非常重要的话（送你）
|
||
|
||
> **SDL 的精髓不是“画图”，而是：**
|
||
>
|
||
> 👉 用「C + 统一抽象」
|
||
> 👉 把操作系统、窗口系统、输入系统
|
||
> 👉 变成一套你能“直接操控”的接口
|
||
|
||
你现在问的 `SDL_Window`、函数来源、opaque struct
|
||
说明你已经**在用“系统程序员的视角”学 SDL 了**，这非常好。
|
||
|
||
---
|
||
|
||
如果你愿意，下一步我可以帮你做几件事之一（你挑）：
|
||
|
||
* 🔹 画一张 **SDL 模块结构图（Window / Event / Renderer）**
|
||
* 🔹 给你一个 **最小但规范的 SDL 主循环模板**
|
||
* 🔹 对比 **SDL vs Win32 vs Qt** 从“底层感”角度
|
||
* 🔹 把 SDL 当作 **C 语言 GUI 库** 来系统梳理
|
||
|
||
你现在这条线，其实已经比 90% “只会用 SDL 的人”更深入了。
|
||
|
||
|
||
非常抱歉，我刚才基于广泛使用的 SDL2 进行了说明。**SDL3** 是目前的最新版本，它在架构上做了大量精简和优化，许多函数名和机制都发生了显著变化。
|
||
|
||
以下是 **SDL3** 中最常用且核心的函数分类指南：
|
||
|
||
---
|
||
|
||
## 1. 基础生命周期 (Init & Quit)
|
||
|
||
SDL3 引入了更现代的初始化逻辑，不再强制要求使用 `SDL_INIT_EVERYTHING`。
|
||
|
||
* **`SDL_Init(SDL_InitFlags flags)`**: 初始化。常见标志：`SDL_INIT_VIDEO`, `SDL_INIT_AUDIO`。
|
||
* **`SDL_Quit()`**: 退出并清理。
|
||
* **`SDL_GetError()`**: 当函数返回失败（通常是 false 或 NULL）时，用此函数获取错误字符串。
|
||
|
||
---
|
||
|
||
## 2. 窗口与渲染器 (Window & Renderer)
|
||
|
||
SDL3 最显著的变化之一是将窗口和渲染器的创建合并或简化了，并且移除了旧的 `SDL_WINDOW_SHOWN` 标志（现在默认显示）。
|
||
|
||
* **`SDL_CreateWindow(title, w, h, flags)`**: 创建窗口。
|
||
* **`SDL_CreateRenderer(window, name)`**: 为窗口创建渲染器。如果不指定驱动名称（`NULL`），SDL 会自动选择最优驱动。
|
||
* **`SDL_CreateWindowAndRenderer(...)`**: **SDL3 推荐用法**。一次性创建窗口和渲染器，代码更简洁。
|
||
* **`SDL_DestroyRenderer(renderer)`** / **`SDL_DestroyWindow(window)`**: 销毁资源。
|
||
|
||
---
|
||
|
||
## 3. 渲染流程 (Rendering)
|
||
|
||
SDL3 的渲染 API 更加规范化，大多数绘图函数现在返回 `bool` 类型来表示成功与否。
|
||
|
||
* **`SDL_SetRenderDrawColor(renderer, r, g, b, a)`**: 设置当前的“画笔”颜色。
|
||
* **`SDL_RenderClear(renderer)`**: 清空屏幕（使用画笔颜色）。
|
||
* **`SDL_RenderPresent(renderer)`**: 提交渲染。将后台缓冲区内容推送到屏幕。
|
||
* **`SDL_RenderRect(renderer, rect)`**: 画矩形框。
|
||
* **`SDL_RenderFillRect(renderer, rect)`**: 填充实心矩形。
|
||
|
||
---
|
||
|
||
## 4. 纹理与图片 (Textures)
|
||
|
||
SDL3 对 `SDL_Surface` 的依赖在进一步减少，更强调使用 GPU 端的 `SDL_Texture`。
|
||
|
||
* **`SDL_CreateTexture(renderer, format, access, w, h)`**: 创建空白纹理。
|
||
* **`SDL_RenderTexture(renderer, texture, src_rect, dst_rect)`**: **新函数**。取代了 SDL2 的 `SDL_RenderCopy`。用于将纹理画到屏幕上。
|
||
* **`SDL_DestroyTexture(texture)`**: 释放纹理。
|
||
|
||
---
|
||
|
||
## 5. 事件系统 (Events)
|
||
|
||
事件处理逻辑基本保持一致，但在结构体成员命名上更简洁。
|
||
|
||
* **`SDL_PollEvent(SDL_Event *event)`**: 检查是否有待处理事件。
|
||
* **常用事件类型**：
|
||
* `SDL_EVENT_QUIT`: 关闭窗口。
|
||
* `SDL_EVENT_KEY_DOWN`: 按键按下。
|
||
* `SDL_EVENT_MOUSE_MOTION`: 鼠标移动。
|
||
|
||
|
||
|
||
---
|
||
|
||
## 6. SDL3 的关键差异对照表
|
||
|
||
| 功能 | SDL2 函数名 | **SDL3 函数名** | 备注 |
|
||
| --- | --- | --- | --- |
|
||
| **渲染图片** | `SDL_RenderCopy` | **`SDL_RenderTexture`** | 参数更直观 |
|
||
| **渲染旋转** | `SDL_RenderCopyEx` | **`SDL_RenderTextureRotated`** | 拆分了功能 |
|
||
| **逻辑大小** | `SDL_RenderSetLogicalSize` | **`SDL_SetRenderLogicalPresentation`** | SDL3 增强了拉伸模式处理 |
|
||
| **属性读取** | `SDL_QueryTexture` | **`SDL_GetTextureSize`** | 获取尺寸更直接 |
|
||
| **布尔返回** | 返回 0 或 -1 | **返回 true 或 false** | 符合现代 C 编程习惯 |
|
||
|
||
---
|
||
|
||
### 一个极简的 SDL3 结构示例：
|
||
|
||
```c
|
||
#include <SDL3/SDL.h>
|
||
#include <SDL3/SDL_main.h>
|
||
|
||
int main(int argc, char* argv[]) {
|
||
SDL_Init(SDL_INIT_VIDEO);
|
||
|
||
SDL_Window *window;
|
||
SDL_Renderer *renderer;
|
||
// SDL3 推荐的一键创建
|
||
SDL_CreateWindowAndRenderer("SDL3 Window", 640, 480, 0, &window, &renderer);
|
||
|
||
bool running = true;
|
||
while (running) {
|
||
SDL_Event event;
|
||
while (SDL_PollEvent(&event)) {
|
||
if (event.type == SDL_EVENT_QUIT) running = false;
|
||
}
|
||
|
||
SDL_SetRenderDrawColor(renderer, 255, 0, 0, 255); // 红色
|
||
SDL_RenderClear(renderer);
|
||
SDL_RenderPresent(renderer);
|
||
}
|
||
|
||
SDL_Quit();
|
||
return 0;
|
||
}
|
||
|
||
```
|
||
|
||
**SDL3 还在不断迭代中，有些旧的扩展库（如 SDL_image）也需要更新到对应的 SDL3 版本。你需要了解如何配置 SDL3 的环境（如 CMake 配置）吗？** |