SDL_Surface 介绍
SDL_Surface 是 Simple DirectMedia Layer (SDL) 库中的一个核心数据结构，用于表示软件中的图像或表面。它是 SDL 1.x 版本中处理 2D 图形的主要方式，在 SDL 2.x 中仍然被支持，但通常推荐使用更高效的 SDL_Texture 结合硬件加速渲染。
主要特性
软件渲染：SDL_Surface 主要在 CPU 上进行操作，不直接利用 GPU 加速
像素数据存储：包含图像的原始像素数据
格式信息：存储像素格式、宽度、高度等信息
跨平台：在不同平台上提供一致的接口
数据结构成员
| Uint32 | flags | (internal use) |
|---|---|---|
| SDL_PixelFormat* | format | 存储在surface中的像素的格式; 有关详细信息，请参阅SDL_PixelFormat（只读） |
| int | w, h | 宽度和高度（以像素为单位）（只读） |
| int | pitch | 一行像素的长度（以字节为单位）（只读） |
| void* | pixels | 指向实际像素数据的指针; 有关详细信息（读写） |
| void* | userdata | 你可以设置的任意指针（读写） |
| int | locked | 用于需要锁定的表面（内部使用） |
| void* | lock_data | 用于需要锁定的表面（内部使用） |
| SDL_Rect | clip_rect | 一个SDL_Rect结构，用于将blits剪切到表面，可以通过SDL_SetClipRect（）设置（只读） |
| SDL_BlitMap* | map | 快速blit映射到其他表面的信息（内部使用） |
| int | refcount | 引用计数可以由应用程序递增 |
常用操作
创建 Surface
// 创建一个新的 Surface
SDL_Surface* SDL_CreateRGBSurface(Uint32 flags, int width, int height, int depth,
Uint32 Rmask, Uint32 Gmask, Uint32 Bmask, Uint32 Amask);
// 从文件加载图像创建 Surface
SDL_Surface* SDL_LoadBMP(const char *file);
SDL_Surface* IMG_Load(const char *file); // 使用 SDL_image 库
释放 Surface
void SDL_FreeSurface(SDL_Surface* surface);
绘制操作
// 在目标 Surface 上绘制另一个 Surface
int SDL_BlitSurface(SDL_Surface* src, const SDL_Rect* srcrect,
SDL_Surface* dst, SDL_Rect* dstrect);
// 填充 Surface
int SDL_FillRect(SDL_Surface* dst, const SDL_Rect* rect, Uint32 color);
使用示例
#include <SDL2/SDL.h>
int main() {
SDL_Init(SDL_INIT_VIDEO);
// 创建一个 640x480 的 32 位 RGB Surface
SDL_Surface* screen = SDL_CreateRGBSurface(0, 640, 480, 32,
0x00FF0000, 0x0000FF00, 0x000000FF, 0xFF000000);
// 加载图像
SDL_Surface* image = SDL_LoadBMP("example.bmp");
// 绘制图像
SDL_Rect dest = {100, 100, 0, 0};
SDL_BlitSurface(image, NULL, screen, &dest);
// 保存结果
SDL_SaveBMP(screen, "output.bmp");
// 释放资源
SDL_FreeSurface(image);
SDL_FreeSurface(screen);
SDL_Quit();
return 0;
}
SDL_Surface 与 SDL_Texture 的比较
| 特性 | SDL_Surface | SDL_Texture |
|---|---|---|
| 渲染方式 | 软件渲染 (CPU) | 硬件加速 (GPU) |
| 性能 | 较慢 | 更快 |
| 修改灵活性 | 可直接访问像素 | 需要通过渲染目标或更新纹理 |
| 适用场景 | 图像处理、像素级操作 | 游戏渲染、频繁更新的图形 |
| 内存位置 | 系统内存 | 显存 |
在现代 SDL 2.x 应用中，通常建议将 SDL_Surface 用于加载和处理图像，然后将其转换为 SDL_Texture 用于高效渲染。