【SDL游戏编程入门第二卷】第一个SDL窗口

一、前言

之前我们已经设置了 SDL，是时候制作一个在屏幕上呈现四边形的 SDL 图形应用程序了。

二、第一个 SDL 窗口

我们在上一卷的基础上编写，我会对重要的地方做出适当的解释。

// 使用 SDL 和 iostream
#include 
#include 

// 链接库
#pragma comment(lib, "SDL2.lib")
#pragma comment(lib, "SDL2main.lib")

// 屏幕尺寸常量
const int SCREEN_WIDTH = 640;
const int SCREEN_HEIGHT = 480;

在源文件顶部，我们包含 SDL.h，因为我们需要 SDL 函数和数据类型，还将包含 iostream 用来打印日志信息到控制台。

这里我在源代码中链接了库，你也可以在项目的属性中设置，这里我选择了我更容易看到的地方，但如果是一个比较大的工程，我可能会在这两者中考虑一会。

最后声明窗口的宽度和高度

接下来是 main 函数部分

/* 此源代码版权归 AnnihilateSword (2022-*)所有，未经书面许可不得转载。*/

// 使用 SDL 和 iostream
#include 
#include 

// 链接库
#pragma comment(lib, "SDL2.lib")
#pragma comment(lib, "SDL2main.lib")

// 屏幕尺寸常量
const int SCREEN_WIDTH = 640;
const int SCREEN_HEIGHT = 480;

int main(int argc, char* argv[])  // 必须要填写此参数，不然会出现链接错误
{
	// 定义 SDL 窗口
	SDL_Window* window = nullptr;
	// 初始化 SDL
	if (SDL_Init(SDL_INIT_VIDEO) < 0)
	{
		std::cout << "[Error]: SDL could not initialize! SDL_Error: " << SDL_GetError() << std::endl;
	}
	else
	{
		// 创建窗口
		SDL_Window* window = SDL_CreateWindow("HelloSDL", SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED, SCREEN_WIDTH, SCREEN_HEIGHT, SDL_WINDOW_SHOWN);
		if (window == nullptr)
		{
			std::cout << "[Error]: Window could not be created! SDL_Error: " << SDL_GetError() << std::endl;
		}
		else
		{
			// 获取窗口所包含的表面
			SDL_Surface* screenSurface = SDL_GetWindowSurface(window);

			// 将表面填充为蓝色
			SDL_FillRect(screenSurface, nullptr, SDL_MapRGB(screenSurface->format, 51, 76, 204));

			// 更新表面
			SDL_UpdateWindowSurface(window);

			// 窗口循环
			SDL_Event e;
			bool quit = false;
			while (quit == false)
			{
				while (SDL_PollEvent(&e))
				{
					if (e.type == SDL_QUIT)
						quit = true;
				}
			}
		}
	}
	// 销毁窗口
	SDL_DestroyWindow(window);
	// 退出 SDL
	SDL_Quit();
	return 0;
}

1. 代码解释

a. 窗口创建部分

这里要注意的是：我们要让入口函数（这里是 main）的参数是一个整数，后跟一个 char* 数组，返回值是一个整数。任何其他 main 函数的类型将导致对 main 的未定义引用。SDL 需要这种类型的主设备，以便与多个平台兼容。

声明窗口和屏幕表面后，我们初始化 SDL。如果不先初始化 SDL，则无法调用任何 SDL 函数。因为我们所关心的只是使用 SDL 的视频 子系统，我们只会传递它 SDL_INIT_VIDEO 标志。

SDL_Init() 函数用来初始化 SDL

参考官方文档：
成功返回 0，失败返回负；可以使用 SDL_GetError() 获取更多信息。
Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.

说到 API，最重要的就是文档，许多库官方都有提供文档（只能说大部分，因为我确实遇到过没有文档的…）

✨ SDL参考文档

SDL_GetError 是一个非常有用的功能。每当出现问题时，您都需要知道原因。SDL_GetError 会通知您 SDL 函数内部是否发生任何错误。

接下来就是创建窗口了，SDL_CreateWindow 函数的参数需要提供窗口的位置、宽高、标志

这里代码很简单，我们创建了一个标题是 “HelloSDL”，位置让 SDL 决定所以填写 SDL_WINDOWPOS_UNDEFINED，宽高是我们声明的 640x480，最后指定 SDL_WINDOW_SHOW 让窗口正常显示，可以用 OR 运算指定多个标志。

b. 窗口表面设置

如果窗口创建成功，我们还希望获取窗口的表面，以便我们可以绘制到它。

获取窗口的表面使用 SDL_GetWindowSurface

然后我们用 SDL_FillRect 函数使用特定颜色快速填充矩形。SDL_MapRGB 的第一个参数是描述像素格式的 SDL_PixelFormat 结构，我们直接使用窗口表面的格式。

关于渲染，需要了解的重要一点是，仅仅因为我们在屏幕表面绘制了某些内容并不意味着你会看到它。完成所需的所有绘图后，我们还需要更新窗口，使其显示您绘制的所有内容。

所以还需调用 SDL_UpdateWindowSurface 更新窗口表面

c. 窗口循环

如果我们现在运行程序，窗口会一闪而过，一般我们都会用一个循环让程序持续运行，直到我们想要关闭，游戏不就是这样吗。

这里使用了 SDL_PollEvent 轮询处理事件，之后会放在单独的模块介绍事件系统，我不想在这里花大量篇幅介绍，让我们保持简单

参考文档
如果有可获取的事件返回 1，如果没有返回 0
Returns 1 if there is a pending event or 0 if there are none available.

d. 销毁窗口

最后，在我们结束循环后，我们将销毁窗口以释放其内存，并且退出 SDL

2. 运行结果

三、Remarks

这一节花了较长篇幅来讲解 API，不过我推荐大家多看官方文档，我这里解释的 API 大部分其实都是查阅官方文档的解释，之后我会缩短单一解释 API 的篇幅（因为文档上都能找到）

如果是比较重要的或是难以理解的地方，我会写在文章中，所以，在之后的篇章中，我打算尽量减少不必要的解释，我认为这样能让我们更轻松。

不知道你们的想法是怎样，可以给我评论或留言。

本节内容就到这里了，下卷会继续分享 SDL 的基本使用

The End.