SDL入门教程——（一）Hello World

SDL入门

其实像SDL、FFMPEG、Opencv 我都是从入门到放弃，我不知道入了几次门了都，用的时候就Google，用完就忘，每次都需要重新搜索关键字。所以后面我的学习过程我都要记录一下，包括我看别人的文章我也要记录下来，有时候记得在哪里看过就是找不到然后就是想用就是不会简直是一个while(true)，废话不多说，开始SDL的入门记录吧。

Hello World

配置链接库什么的我就不写了，因为无数遍重复已经死死记住了。直接上代码，我参考了bilibili的一个Up主的视频¹。

#include <iostream>
#include "SDL2/include/SDL.h"

const int screen_width = 800;
const int screen_height = 600;
int main(int, char**)
{
	SDL_Init(SDL_INIT_VIDEO);
    SDL_Window *window = SDL_CreateWindow("YourGame", 
    									  SDL_WINDOWPOS_UNDEFINED, 
    									  SDL_WINDOWPOS_UNDEFINED, 
    									  screen_width, screen_height, 
    									  SDL_WINDOW_SHOWN);
    SDL_Surface *surface = SDL_GetWindowSurface(window);
    SDL_Surface* blackground_surface = SDL_LoadBMP("Hello.bmp");
    SDL_BlitSurface(blackground_surface, NULL, surface, NULL);
    SDL_UpdateWindowSurface(window);
    SDL_Delay(3000);
    SDL_DestroyWindow(window);
    SDL_Quit();
    return 0;
}

因为SDL输出文字是需要扩展功能，SDL本身是没有设计文字的功能，所以Hello World就先输出图片吧。后面我用到字体时我再补充吧。有兴趣的可以参考：SDL显示图像和文字²

上面代码可以看出几点：

1. SDL初始化和SDL退出：

   SDL_Init(SDL_INIT_VIDEO);
   

   SDL_Quit();
   

2. 创建Window和销毁窗口：

   SDL_Window *window = SDL_CreateWindow("YourGame", 
   									  SDL_WINDOWPOS_UNDEFINED, 
   									  SDL_WINDOWPOS_UNDEFINED, 
   									  screen_width, screen_height, 
   									  SDL_WINDOW_SHOWN);
   

   SDL_DestroyWindow(window);
   

3. 让窗口显示图片：

   SDL_Surface *surface = SDL_GetWindowSurface(window);
   SDL_Surface* blackground_surface = SDL_LoadBMP("Hello.bmp");
   SDL_BlitSurface(blackground_surface, NULL, surface, NULL);
   SDL_UpdateWindowSurface(window)
   

4. 让窗口停留3秒：SDL_Delay(3000);

各个函数参数的意义³ (在左侧搜索框输入自己要搜索的函数，入门可以跳过这段)：

初始化函数SDL_Init参数的意义: （initialize the SDL library）

创建函数SDL_CreateWindow参数的意义: （create a window）

拷贝绘制函数SDL_BlitSurface参数的意义: (copy surface to destination surface)

SDL 官方的 Hello world⁴

if (SDL_Init(SDL_INIT_VIDEO) != 0){
	std::cout << "SDL_Init Error: " << SDL_GetError() << std::endl;
	return 1;
}
SDL_Window *win = SDL_CreateWindow("Hello World!", 100, 100, 640, 480, SDL_WINDOW_SHOWN);
if (win == nullptr){
	std::cout << "SDL_CreateWindow Error: " << SDL_GetError() << std::endl;
	SDL_Quit();
	return 1;
}
SDL_Renderer *ren = SDL_CreateRenderer(win, -1, SDL_RENDERER_ACCELERATED | SDL_RENDERER_PRESENTVSYNC);
if (ren == nullptr){
	SDL_DestroyWindow(win);
	std::cout << "SDL_CreateRenderer Error: " << SDL_GetError() << std::endl;
	SDL_Quit();
	return 1;
}
std::string imagePath = getResourcePath("Lesson1") + "hello.bmp";
SDL_Surface *bmp = SDL_LoadBMP(imagePath.c_str());
if (bmp == nullptr){
	SDL_DestroyRenderer(ren);
	SDL_DestroyWindow(win);
	std::cout << "SDL_LoadBMP Error: " << SDL_GetError() << std::endl;
	SDL_Quit();
	return 1;
}
SDL_Texture *tex = SDL_CreateTextureFromSurface(ren, bmp);
SDL_FreeSurface(bmp);
if (tex == nullptr){
	SDL_DestroyRenderer(ren);
	SDL_DestroyWindow(win);
	std::cout << "SDL_CreateTextureFromSurface Error: " << SDL_GetError() << std::endl;
	SDL_Quit();
	return 1;
}
//A sleepy rendering loop, wait for 3 seconds and render and present the screen each time
for (int i = 0; i < 3; ++i){
	//First clear the renderer
	SDL_RenderClear(ren);
	//Draw the texture
	SDL_RenderCopy(ren, tex, NULL, NULL);
	//Update the screen
	SDL_RenderPresent(ren);
	//Take a quick break after all that hard work
	SDL_Delay(1000);
}
SDL_DestroyTexture(tex);
SDL_DestroyRenderer(ren);
SDL_DestroyWindow(win);
SDL_Quit();

官方的Hello world中和我参考Bilibili Up主的Hello world 有很多不一样的地方，主要突出在错误判断和SDL2和SDL1.2的函数调用。Renderer、Texture 是SDL2新引入的方法，这个在Bilibili Up主后面的视频中也有提到。鉴于本篇文章主题为SDL Hello World，我意在将Hello world 写完整，让其他人入手时可以分清楚你参考的文章是使用的SDL2还是SDL1.2。

关于错误判断的写法风格，我个人觉得这类写法偏向C的风格，这里没有批评与鼓励这种方式，我认为这类写法可以视学习阶段，和开发程度来自己把控这个，学习阶段我不建议过分的进行错误判断，主要目的是以程序跑通可用为主，小型项目也不应该过分关注错误判断，只有在大一点的项目中可以使用这种方式来进行安全检查，毕竟当If分支增多时，进行Code coverage会导致整个coverage下降，到时想提高可不是一件容易的事情。

SDL2 Hello world 中新语法：

1. 使用Renderer 来绑定 Window 进行渲染：

   SDL_Renderer *ren = SDL_CreateRenderer(win, -1, SDL_RENDERER_ACCELERATED | SDL_RENDERER_PRESENTVSYNC);
   SDL_DestroyRenderer(ren);
   

2. 用Texture来使Surface对Renderer 进行纹理表述:

   SDL_Surface *bmp = SDL_LoadBMP(imagePath.c_str());
   SDL_Texture *tex = SDL_CreateTextureFromSurface(ren, bmp);
   SDL_FreeSurface(bmp);
   

3. 对Renderer进行Copy以及显示:

   SDL_RenderClear(ren);
   SDL_RenderCopy(ren, tex, NULL, NULL);
   SDL_RenderPresent(ren);
   

创建函数SDL_CreateRenderer参数的意义: （create a texture from an existing surface）

创建函数SDL_CreateTextureFromSurface参数的意义: （create a texture from an existing surface）

在看SDL_CreateTextureFromSurface函数的官方文档时，看到官方的例子里使用SDL_CreateRGBSurface创建surface，所以我再列举一下Surface的创建方法：

上面的方法主要集中在SDL_video.h和SDL_surface.h两个文件中，其中我加粗部分函数需要与函数SDL_FreeSurface成对出现。