SDL 入门指南：了解 SDL，快速上手 SDL 的安装和配置——VS2022

谁借莪１个温暖的怀抱￠ 2023-10-09 21:24 36阅读 0赞

![在这里插入图片描述][49b108505b324f98912e231a2a09c4f8.png]

### 前言 ###

> **欢迎来到[小K][K]的[SDL专栏][SDL]第一小节，本节为大家介绍一下SDL是什么，能做什么，可以在哪些平台运行以及SDL的安装和VS2022配置SDL、导出模板、`cmake`运行SDL**，同时我也会在资源里为大家上传SDL2.26的安装包，为在github上下载速度慢的小伙伴提供便捷

![在这里插入图片描述][f6681b33867646d29fc62ec320e8d6ae.gif_pic_center]

#### 文章目录 ####

*   *  前言
     *  一、SDL 简介
     *   *  1、什么是 SDL？
         *  2、SDL 可以做什么？
         *  3、SDL 在哪些平台上运行？
     *  二、如何获取和安装 SDL
     *   *  1、SDL2库下载
         *  2、安装SDL2
         *  3、VS中使用SDL2
         *  4、vs导出模板
         *  5、CMake使用SDL2

### 一、SDL 简介 ###

#### 1、什么是 SDL？ ####

✨Simple DirectMedia Layer 是一个跨平台开发库，旨在通过 OpenGL 和 Direct3D 提供对音频、键盘、鼠标、游戏杆和图形硬件的低级访问。它被视频播放软件、模拟器和流行游戏使用，包括[Valve][]的获奖目录和许多[Humble Bundle][]游戏。

✨**SDL 正式支持 Windows、Mac OS X、Linux、iOS 和[Android][]。可以在源代码中找到对其他平台的支持。**

✨**SDL 是用 C 编写的，在本机上与 C++ 一起使用，并且有适用于其他几种语言的绑定，包括 C\# 和 Python。**

✨**SDL 2.0 在[zlib 许可][zlib]下分发。此许可证允许您在任何软件中自由使用 SDL。简单直接媒体层库 (SDL) 是一个通用 API，它提供对音频、键盘、鼠标、游戏杆、通过 OpenGL 的 3D 硬件以及跨多个平台的 2D 帧缓冲区的低级别访问。**

#### 2、SDL 可以做什么？ ####

✨**视频**

*  3D图形：SDL 可与 OpenGL API 或 Direct3D API 结合使用，用于 3D 图形
 *  加速 2D 渲染 API：支持简单的旋转、缩放和 alpha 混合，所有这些都使用现代 3D API 加速，使用 OpenGL 和 Direct3D 支持加速
 *  创建和管理多个窗口

✨**输入事件**

*  提供的事件和 API 函数用于：
    
     *  应用程序和窗口状态更改
     *  鼠标输入
     *  键盘输入
     *  操纵杆和游戏控制器输入
     *  多点触控手势
 *  可以使用[SDL\_EventState][SDL_EventState] ()启用或禁用每个事件
 *  事件在发布到内部事件队列之前通过用户指定的过滤器函数
 *  线程安全事件队列

✨**力反馈**

*  Windows、Mac OS X 和 Linux 支持力反馈

✨**音频**

*  设置8位和16位音频、单声道立体声或5.1环绕声的音频播放，如果硬件不支持格式，可选择转换
 *  音频在单独的线程中独立运行，通过用户回调机制填充
 *  专为定制软件混音器设计，但[SDL\_mixer][SDL_mixer]提供完整的音频/音乐输出库

✨**文件 I/O 抽象**

*  用于打开、读取和写入数据的通用抽象
 *  对文件和内存的内置支持

✨**共享对象支持**

*  加载共享对象（Windows 上的 DLL，Mac OS X 上的 .dylib，Linux 上的 .so）
 *  共享对象中的查找函数

✨**线程**

*  简单的线程创建API
 *  简单线程本地存储API
 *  互斥体、信号量和条件变量
 *  无锁编程的原子操作

✨**计时器**

*  获取经过的毫秒数
 *  等待指定的毫秒数
 *  在单独的线程中创建与代码一起运行的计时器
 *  使用高分辨率计数器进行分析

✨**CPU 特性检测**

*  查询CPU数量
 *  检测 CPU 特性和支持的指令集

✨**大端小端支持**

*  检测当前系统的字节序
 *  用于快速交换数据值的例程
 *  读取和写入指定字节序的数据

✨**电池管理**

*  查询电源管理状态

#### 3、SDL 在哪些平台上运行？ ####

✨**Windows**

*  使用 Win32 API 进行显示，利用 Direct3D 进行硬件加速
 *  使用 DirectSound 和 XAudio2 作为声音

✨**Mac OS X**

*  使用 Cocoa 进行视频显示，利用 OpenGL 进行硬件加速
 *  使用 Core Audio 播放声音

✨**Linux**

*  使用 X11 进行视频显示，利用 OpenGL 进行硬件加速
 *  使用 ALSA、OSS 和 PulseAudio API 来处理声音

✨**IOS**

*  使用 UIKit 进行视频显示，利用 OpenGL ES 2.0 进行硬件加速
 *  使用 Core Audio 播放声音

✨**Android**

*  使用 JNI 接口进行视频显示，利用 OpenGL ES 1.1 和 2.0 进行硬件加速
 *  对声音使用 JNI 音频回调

### 二、如何获取和安装 SDL ###

#### 1、SDL2库下载 ####

*  SDL2 核心库 [SDL2][]
 *  SDL2 拓展库 [SDL2\_image、SDL2\_ttf、SDL2\_mixer、SDL2\_net][SDL2_image_SDL2_ttf_SDL2_mixer_SDL2_net]
 *  SDL2 第三方绘图库[SDL2\_gfx 官网][SDL2_gfx] ， [SDL2\_gfx Github][SDL2_gfx Github]

#### 2、安装SDL2 ####

✨**1. 点击[SDL2 核心库下载][SDL2]下载SDL2库，进入GitHub下载。**

![在这里插入图片描述][3b509b70bbee43bba337c4fc9db51a14.png_pic_center]  
![在这里插入图片描述][81ec82c17942429a8a0c44766b5120ea.png_pic_center]  
✨**2. 下载出来会有一个压缩包，放到一个合适的目录(记住这个目录哦，经常要用的)，解压。**

![在这里插入图片描述][d314868090d048ab9d4dce118c573827.png_pic_center]

✨**3. 进入解压后的目录，如下图：**  
A. cmake：cmake配置文件  
B. docs：文档目录，只不过都是英文的  
C. include：头文件目录，编程需要的  
D. lib：库目录(静态库和动态库都有)  
![在这里插入图片描述][a54ece01d71849aebbaf265f9ae03c41.png_pic_center]

✨**4. 给环境变量添加库目录，让程序运行的时候能够找到动态库。PS：配置好了记得重启Vs**，这里配的是X64，需要X86的自己换一下就好了

![在这里插入图片描述][8c1e0c1582c5463f95c20bb49918d20d.png_pic_center]

#### 3、VS中使用SDL2 ####

✨**1. 创建一个空项目，如下图：**

![在这里插入图片描述][6a96c61c68a24a009e6017aed5e70194.png_pic_center]

✨**2. 进入菜单栏的项目->属性->VC++ 目录，配置包含目录和库目录(详见下图)，注意库目录的版本和你的项目版本要一直哦(图中两个三角形标记的位置，我这是x64的)。**

![在这里插入图片描述][6c9fc6e3b8d746b496d5e2a45b4f41f5.png_pic_center]  
![在这里插入图片描述][b8fe640b39a742be8823a145eacf4512.png_pic_center]  
![在这里插入图片描述][ae50b587e50947879546a8f62b6bee28.png_pic_center]

![在这里插入图片描述][dbb08a22c6b448308b81898a5e965449.png_pic_center]

✨**3. 不要离开，还有静态库需要配置，进入链接器->输入->点击附加依赖项->填入SDL2.lib和SDLmain2.lib，然后确定就好**

![在这里插入图片描述][5261eaddb3874ea6a730e5eda9b432bb.png_pic_center]

✨**4. 最后加入如下代码，Ctrl+F5运行**

#include<SDL.h>
    
    int main(int argc,char*argv[])
    {
        
    	//初始化SDL
    	if (SDL_Init(SDL_INIT_VIDEO) <0)
    	{
        
    		SDL_Log("can not init SDL:%s", SDL_GetError());
    		return -1;
    	}
    
    	return 0;
    }

![在这里插入图片描述][f13053f4d64d436d8df5e61a5bc9713b.png_pic_center]

如果能出现黑窗口并且，没有任何错误提示，那么就恭喜你啦，SDL配置完成(**不过麻烦的是每次创建新项目和在x86,x64之间切换时都要进行配置,后面将讲解更方便的方法**)

✨**SDL 作为动态链接库。动态链接库包含 3 个部分：**

*  头文件 (Library.h)
 *  库文件（Windows 的Library.lib 或 \*nix 的libLibrary.a）
 *  二进制文件（Windows 的Library.dll 或\*nix 的Library.so）

✨你的编译器需要能够在编译时找到头文件，以便它知道SDL 函数和结构是什么。可以将编译器配置为在 SDL 头文件所在的附加目录中进行搜索，或者将头文件与编译器附带的其余头文件一起放入。如果编译器提示找不到 SDL.h，则意味着头文件不在编译器查找头文件的位置。

✨在编译器编译所有源文件后，它必须将它们链接在一起。为了使程序正确链接，它需要知道所有函数的地址，包括 SDL 函数的地址。对于动态链接库，这些地址在库文件中。库文件具有导入地址表，因此您的程序可以在运行时导入函数。与头文件一样，您可以将编译器配置为在 SDL 库文件所在的附加目录中进行搜索，或者将库文件与编译器附带的其余库文件一起放入。您还必须告诉链接器链接到链接器中的库文件。如果链接器报错找不到-lSDL或SDL2.lib，它意味着库文件不在链接器寻找库文件的地方。 如果链接器报错了一个未定义的引用，这可能意味着它没有链接这个库。

✨在您的程序被编译和链接之后，您需要能够在运行时链接到该库。为了运行动态链接的应用程序，您需要能够在运行时导入库二进制文件。当您运行程序时，您的操作系统需要能够找到库二进制文件。您可以将库二进制文件放在与可执行文件相同的目录中，也可以放在操作系统保存库二进制文件的目录中。

#### 4、vs导出模板 ####

✨**项目->导出模板**，模板名称，介绍，图片都根据自己喜好天就好了，输出位置就是模板的位置，创建完之后，打开VS创建新项目就有了像创建空项目的快捷方式，不用每次都配置了  
![在这里插入图片描述][e403ced02aff483bbcbd7ebbbedd6a0b.png_pic_center]  
![在这里插入图片描述][84d98a00b9774d518f978122bc1fb83d.png_pic_center]  
![在这里插入图片描述][9f563b47b79f4dd78901fef180ca36c7.png_pic_center]

#### 5、CMake使用SDL2 ####

✨**1. 把SDL2的根目录，配置到环境变量`D:\BaiduNetdiskDownload\SDL2\SDL2-2.26.1`，配置你自己的目录**  
✨**2. 创建CMake项目，并在CMakeLists.txt文件中写入如下命令**

#CMake最小请求版本
    cmake_minimum_required (VERSION 3.8)
    
    #项目名称
    project ("SDL2_CMake")
    
    #查找SDL2包，REQUIRED强制请求，没找到报错
    find_package(SDL2 REQUIRED)
    
    #使用指定的源文件生成目标(SDL2_CMake)
    add_executable (SDL2_CMake "main.c")
    
    #指定目标在链接时需要的依赖(库)
    target_link_libraries(SDL2_CMake SDL2::SDL2 SDL2::SDL2main)

[49b108505b324f98912e231a2a09c4f8.png]: https://img-blog.csdnimg.cn/49b108505b324f98912e231a2a09c4f8.png
[K]: https://blog.csdn.net/qq_72157449?spm=1011.2421.3001.5343
[SDL]: https://blog.csdn.net/qq_72157449/category_12309421.html?spm=1001.2014.3001.5482
[f6681b33867646d29fc62ec320e8d6ae.gif_pic_center]: https://img-blog.csdnimg.cn/f6681b33867646d29fc62ec320e8d6ae.gif#pic_center
[Valve]: http://valvesoftware.com/
[Humble Bundle]: https://www.humblebundle.com/
[Android]: https://wiki.libsdl.org/Android
[zlib]: http://www.gzip.org/zlib/zlib_license.html
[SDL_EventState]: https://wiki.libsdl.org/SDL_EventState
[SDL_mixer]: http://www.libsdl.org/projects/SDL_mixer/
[SDL2]: https://github.com/libsdl-org/SDL/releases/tag/release-2.26.5
[SDL2_image_SDL2_ttf_SDL2_mixer_SDL2_net]: https://libsdl.org/projects/
[SDL2_gfx]: https://www.ferzkopp.net/wordpress/2016/01/02/sdl_gfx-sdl2_gfx/
[SDL2_gfx Github]: https://github.com/topics/sdl2-gfx
[3b509b70bbee43bba337c4fc9db51a14.png_pic_center]: https://img-blog.csdnimg.cn/3b509b70bbee43bba337c4fc9db51a14.png#pic_center
[81ec82c17942429a8a0c44766b5120ea.png_pic_center]: https://img-blog.csdnimg.cn/81ec82c17942429a8a0c44766b5120ea.png#pic_center
[d314868090d048ab9d4dce118c573827.png_pic_center]: https://img-blog.csdnimg.cn/d314868090d048ab9d4dce118c573827.png#pic_center
[a54ece01d71849aebbaf265f9ae03c41.png_pic_center]: https://img-blog.csdnimg.cn/a54ece01d71849aebbaf265f9ae03c41.png#pic_center
[8c1e0c1582c5463f95c20bb49918d20d.png_pic_center]: https://img-blog.csdnimg.cn/8c1e0c1582c5463f95c20bb49918d20d.png#pic_center
[6a96c61c68a24a009e6017aed5e70194.png_pic_center]: https://img-blog.csdnimg.cn/6a96c61c68a24a009e6017aed5e70194.png#pic_center
[6c9fc6e3b8d746b496d5e2a45b4f41f5.png_pic_center]: https://img-blog.csdnimg.cn/6c9fc6e3b8d746b496d5e2a45b4f41f5.png#pic_center
[b8fe640b39a742be8823a145eacf4512.png_pic_center]: https://img-blog.csdnimg.cn/b8fe640b39a742be8823a145eacf4512.png#pic_center
[ae50b587e50947879546a8f62b6bee28.png_pic_center]: https://img-blog.csdnimg.cn/ae50b587e50947879546a8f62b6bee28.png#pic_center
[dbb08a22c6b448308b81898a5e965449.png_pic_center]: https://img-blog.csdnimg.cn/dbb08a22c6b448308b81898a5e965449.png#pic_center
[5261eaddb3874ea6a730e5eda9b432bb.png_pic_center]: https://img-blog.csdnimg.cn/5261eaddb3874ea6a730e5eda9b432bb.png#pic_center
[f13053f4d64d436d8df5e61a5bc9713b.png_pic_center]: https://img-blog.csdnimg.cn/f13053f4d64d436d8df5e61a5bc9713b.png#pic_center
[e403ced02aff483bbcbd7ebbbedd6a0b.png_pic_center]: https://img-blog.csdnimg.cn/e403ced02aff483bbcbd7ebbbedd6a0b.png#pic_center
[84d98a00b9774d518f978122bc1fb83d.png_pic_center]: https://img-blog.csdnimg.cn/84d98a00b9774d518f978122bc1fb83d.png#pic_center
[9f563b47b79f4dd78901fef180ca36c7.png_pic_center]: https://img-blog.csdnimg.cn/9f563b47b79f4dd78901fef180ca36c7.png#pic_center