详解SDL常用技术实战(1)

欢迎大家来到IT世界,在知识的湖畔探索吧!

0.引言

本篇文章主要讲解如何学习SDL以及SDL重要的基础知识，希望能够帮到大家。

欢迎大家来到IT世界,在知识的湖畔探索吧!

1.SDL简述

SDL（Simple DirectMedia Layer）是一套开放源代码的跨平台多媒体开发库，使用C语言写成。SDL提供了数种控制图像、声音、输出的函数，让开发者只要用相同或是相似的代码就可以开发出跨多个平台（Linux、Windows、Mac OS X等）的应用软件，对于跨平台比较好。目前SDL多用于开发游戏、模拟器、媒体播放器等多媒体应用领域。SDL（Simple DirectMedia Layer）被广泛的用于许多著名的游戏。最著名的游戏是赢得Linux组游戏开发大奖的 文明：权利的召唤（Civilization: Call To Power）。SDL的作者是Sam Lantinga, Loki Entertainment Software的主力程序员（Lead Programmer）。

1.1 SDL的主要框架

2.SDL的主要功能

(1)视频(SDL_INIT_VIDEO)

设置8bpp或更高的任意色彩深度的视频模式。如果某个模式硬件不支持，可以选择转化为另一模式。直接写入线性的图像帧缓冲（framebuffer）。用颜色键值（colorkey）或者alpha混合属性创建surface。Surface的blit能自动的转化为目标格式。blit是优化过的，并能使用硬件加速。x86平台上有针对MMX优化过的blit。硬件加速的blit和fill（填充）操作，如果硬件支持的话。这个功能在音视频显示，开发领域显得很重要。

(2)事件(SDL_INIT_EVENTS)

提供以下事件：

应用程序的visibility发生改变

键盘输入

鼠标输入

用户要求的退出

每种事件都能通过SDL_EventState()关闭或者打开。

事件经由用户指定的过滤函数再被加入到内部的事件队列。

线程安全的事件队列。

这个功能在音视频显示，开发领域显得很重要。

(3)音频(SDL_INIT_AUDIO)

设置8位和16位的音频，单声道或者立体声，如果格式硬件不支持，可以选择转换。

由独立的线程执行音频部分，并提供用户回调（callback）机制。

设计上考虑到了客户定制的软混音器，但实际上在例程中就包含了一个完整的音频/音乐输出库。

这个功能在音视频显示，开发领域显得很重要。

(4)CD音频

完整的CD音频控制API

(5)线程

简单的线程创建API

用于同步的简单的二进制信号量（semaphores）

(6)定时器(SDL_INIT_AUDIO_TIMER)

读取已流逝的毫秒数。

等待指定的毫秒数。

设置一个10毫秒精度的周期性定时器。

这个功能在音视频显示，开发领域显得很重要。

(7)字节序无关

侦测当前系统的字节序

快速转换数据的函数

读写指定字节序的数据

(8)摇杆(SDL_INIT_JOYSTICK)

(9)触摸屏(SDL_INIT_HAPTIC)

(10)游戏控制器(SDL_INIT_GAMECONTROLLER)

(11)包含上述所有选项的事件(SDL_INIT_EVERYTHING)

3.SDL支持哪些系统平台

(1)Linux

视频显示使用X11，利用XFree86 DGA扩展的优势，全屏显示使用新的w MTRR加速。声音使用OSS API。使用clone()系统调用和SysV IPC，或者glibc-2.1的pthreads实现线程。

(2)Win32

有两个版本，一个是适合所有基于Win32的系统的安全版本，另一个是基于DirectX的高性能版本。安全版本的视频显示采用GDI。高性能版本采用DirectDraw，并支持硬件加速。安全版本的音频回放采用waveOut API。高性能版本采用DirectSound。

(3)BeOS

视频显示采用BWindow。音频回放采用BSoundPlayer API。非正式的移植版本，进展中Solaris, IRIX, FreeBSD MacOS

4.SDL的其它描述

SDL内置了调用OpenGL的函数。通过使用SDL_image、SDL_ttf、SDL_mixer、SDL_net等外部扩展库，可以轻松实现JPG、PNG、TIFF图像的加载使用，TrueType字体的使用，MP3文件的使用、网络相关的使用等。

SDL也有其他语言的包装，可以在这里查看　SDL用C语言写成，但是可以很容易在C++下面工作，并且SDL绑定了许多其它的语言，这其中就包括Ada, C#, Eiffel, Erlang, Euphoria, Guile, Haskell, Java, Lisp, Lua, ML, Objective C, Pascal, Perl, PHP, Pike, Pliant, Python, Ruby, and Smalltalk。包装得比较好的是python语言的pygame。不过仍然建议你熟悉c/c++环境下的SDL后再使用，会得心应手许多。最后，我们来了解一下SDL的版权问题，SDL在GNU LGPL 2（一个国际上的开源组织）下发布，这个版本允许你将SDL以动态链接库（dynamic link library）的形式免费地用于商业游戏软件的开发。

5.SDL下载和编译

5.1 下载SDL的win平台库

(1)SDL官网地址：

https://www.libsdl.org/

界面如下:

(2)SDL官网文档链接：

http://wiki.libsdl.org/Introduction

(3)下载SDL的dll和lib，链接地址如下:

https://www.libsdl.org/download-2.0.php

界面如下:

也可以下载源码下来，自己编译。比如在linux环境下，自己去编译。win平台一般是直接使用，已经下载编译好的库。

(4)下载的库，内容如下:

(5)doc目录如下:

(6)includle目录如下:

(7)lib目录如下:

(8)x86的库

(9)x64的库

SDL只是音视频用来显示和输出，所以用来关心这部分接口即可，知道怎么去用，如果项目中，有使用其它功能，可以再去研究文档和实例代码。

6.在linux环境下搭建SDL的开发环境

(1)下载SDL源码库，如SDL2-2.0.10.tar.gz

(2)解压，然后依次执行如下命令

./configure make sudo make install

欢迎大家来到IT世界,在知识的湖畔探索吧!

(3)如果出现Could not initialize SDL – No available video device(Did you set the DISPLAY variable?)错误提示，就说明系统中没有安装x11的库文件，因此编译出来的SDL库实际上不能用。需要安装如下库，命令如下:

欢迎大家来到IT世界,在知识的湖畔探索吧!sudo apt-get install libx11-dev sudo apt-get install xorg-dev

7.SDL的win显示

生成的SDL窗口。如下:

(1)初始化SDL window

(2)创建SDL Window，可以设置使用opengl做加速。

注意：SDL_Init()和SDL_Quit()这两个函数都是必须使用。

8.SDL的渲染器和纹理

SDL_Window: 代表了一个“窗口”。

SDL_Renderer ：代表了一个“渲染器”。

SDL_Texture：代表了一个“纹理”。

SDL_Rect：矩形结构

注意：存储RGB和存储纹理的区别如下：

如一个从左到右由红色渐变到蓝色的矩形，用存储RGB的话就需要把矩形中每个点的具体颜色值存储下来；而纹理只是一些描述信息，比如记录了矩形的大小、起始颜色、终止颜色等信息，显卡可以通过这些信息推算出矩形块的详细信息。所以相对于存储RGB而已，存储纹理占用的内存要少的多。

SDL绘制图形效果:

(1)创建渲染器SDL_Renderer

一般一个窗口，对应一个渲染器render，也可以对应多个渲染器，每个渲染器可以设置不同的纹理。

基于上面所说的window去创建渲染器，源代码接口如下:

/ * \brief Set a texture as the current rendering target. * * \param renderer The renderer. * \param texture The targeted texture, which must be created with the SDL_TEXTUREACCESS_TARGET flag, or NULL for the default render target * * \return 0 on success, or -1 on error * * \sa SDL_GetRenderTarget() */ extern DECLSPEC int SDLCALL SDL_SetRenderTarget(SDL_Renderer *renderer, SDL_Texture *texture);

(2)创建纹理SDL_Texture

创建纹理，也是基于上面的渲染器render去创建。源代码接口如下:

欢迎大家来到IT世界,在知识的湖畔探索吧!/ * \brief Copy a portion of the texture to the current rendering target. * * \param renderer The renderer which should copy parts of a texture. * \param texture The source texture. * \param srcrect A pointer to the source rectangle, or NULL for the entire * texture. * \param dstrect A pointer to the destination rectangle, or NULL for the * entire rendering target. * * \return 0 on success, or -1 on error */ extern DECLSPEC int SDLCALL SDL_RenderCopy(SDL_Renderer * renderer, SDL_Texture * texture, const SDL_Rect * srcrect, const SDL_Rect * dstrect);

(3)设置渲染器目标

以下操作都是在一个循环里面去执行。

设置渲染目标为纹理，如下所示:

SDL_SetRenderTarget(renderer, texture);

源码接口如下:

欢迎大家来到IT世界,在知识的湖畔探索吧!/ * \brief Set a texture as the current rendering target. * * \param renderer The renderer. * \param texture The targeted texture, which must be created with the SDL_TEXTUREACCESS_TARGET flag, or NULL for the default render target * * \return 0 on success, or -1 on error * * \sa SDL_GetRenderTarget() */ extern DECLSPEC int SDLCALL SDL_SetRenderTarget(SDL_Renderer *renderer, SDL_Texture *texture);

(4)设置纹理背景的颜色

SDL_SetRenderDrawColor(renderer, 255, 0, 0, 255)

源码接口如下:

欢迎大家来到IT世界,在知识的湖畔探索吧!/ * \brief Set the color used for drawing operations (Rect, Line and Clear). * * \param renderer The renderer for which drawing color should be set. * \param r The red value used to draw on the rendering target. * \param g The green value used to draw on the rendering target. * \param b The blue value used to draw on the rendering target. * \param a The alpha value used to draw on the rendering target, usually * ::SDL_ALPHA_OPAQUE (255). * * \return 0 on success, or -1 on error */ extern DECLSPEC int SDLCALL SDL_SetRenderDrawColor(SDL_Renderer * renderer, Uint8 r, Uint8 g, Uint8 b, Uint8 a);

(5)绘制一个方形。如下所示:

SDL_RenderDrawRect(renderer, &rect)

源码接口如下:

欢迎大家来到IT世界,在知识的湖畔探索吧!/ * \brief Draw a rectangle on the current rendering target. * * \param renderer The renderer which should draw a rectangle. * \param rect A pointer to the destination rectangle, or NULL to outline the entire rendering target. * * \return 0 on success, or -1 on error */ extern DECLSPEC int SDLCALL SDL_RenderDrawRect(SDL_Renderer * renderer, const SDL_Rect * rect);

(6)给上面绘制的方形，填充颜色，如下所示:

SDL_SetRenderDrawColor(renderer, 0, 255, 255, 255); SDL_RenderFillRect(renderer, &rect);

源码接口如下:

欢迎大家来到IT世界,在知识的湖畔探索吧!/ * \brief Set the color used for drawing operations (Rect, Line and Clear). * * \param renderer The renderer for which drawing color should be set. * \param r The red value used to draw on the rendering target. * \param g The green value used to draw on the rendering target. * \param b The blue value used to draw on the rendering target. * \param a The alpha value used to draw on the rendering target, usually * ::SDL_ALPHA_OPAQUE (255). * * \return 0 on success, or -1 on error */ extern DECLSPEC int SDLCALL SDL_SetRenderDrawColor(SDL_Renderer * renderer, Uint8 r, Uint8 g, Uint8 b, Uint8 a);

/ * \brief Fill a rectangle on the current rendering target with the drawing color. * * \param renderer The renderer which should fill a rectangle. * \param rect A pointer to the destination rectangle, or NULL for the entire * rendering target. * * \return 0 on success, or -1 on error */ extern DECLSPEC int SDLCALL SDL_RenderFillRect(SDL_Renderer * renderer, const SDL_Rect * rect);

(7)设置上面的纹理texture为渲染器目标，如下所示:

欢迎大家来到IT世界,在知识的湖畔探索吧! SDL_SetRenderTarget(renderer, NULL);

源码接口如下:

/ * \brief Set a texture as the current rendering target. * * \param renderer The renderer. * \param texture The targeted texture, which must be created with the SDL_TEXTUREACCESS_TARGET flag, or NULL for the default render target * * \return 0 on success, or -1 on error * * \sa SDL_GetRenderTarget() */ extern DECLSPEC int SDLCALL SDL_SetRenderTarget(SDL_Renderer *renderer, SDL_Texture *texture);

(8)拷贝纹理texture到渲染器上。如下所示:

欢迎大家来到IT世界,在知识的湖畔探索吧!SDL_RenderCopy(renderer, texture, NULL, NULL);

源码接口如下:

/ * \brief Update the screen with rendering performed. */ extern DECLSPEC void SDLCALL SDL_RenderPresent(SDL_Renderer * renderer);

(9)显示

最终是更新窗口上的纹理，如下所示:

欢迎大家来到IT世界,在知识的湖畔探索吧!SDL_RenderPresent(renderer);

源码接口如下:

/ * \brief Update the screen with rendering performed. */ extern DECLSPEC void SDLCALL SDL_RenderPresent(SDL_Renderer * renderer);

(10)SDL_UpdateTexture()：设置纹理的数据

(11)SDL_Delay()：工具函数，用于延时。

(12)SDL_Quit()：退出SDL系统

上述显示的核心代码，如下：

欢迎大家来到IT世界,在知识的湖畔探索吧! SDL_Init(SDL_INIT_VIDEO);//初始化函数,可以确定希望激活的子系统 window = SDL_CreateWindow("2 Window", SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED, 640, 480, SDL_WINDOW_OPENGL | SDL_WINDOW_RESIZABLE);// 创建窗口 if (!window) { return -1; } renderer = SDL_CreateRenderer(window, -1, 0);//基于窗口创建渲染器 if (!renderer) { return -1; } texture = SDL_CreateTexture(renderer, SDL_PIXELFORMAT_RGBA8888, SDL_TEXTUREACCESS_TARGET, 640, 480); //创建纹理 if (!texture) { return -1; } int show_count = 0; while (run) { rect.x = rand() % 600; rect.y = rand() % 400; SDL_SetRenderTarget(renderer, texture); // 设置渲染目标为纹理 SDL_SetRenderDrawColor(renderer, 255, 0, 0, 255); // 纹理背景为黑色 SDL_RenderClear(renderer); //清屏 SDL_RenderDrawRect(renderer, &rect); //绘制一个长方形 SDL_SetRenderDrawColor(renderer, 0, 255, 255, 255); //长方形的颜色可以改变 SDL_RenderFillRect(renderer, &rect); SDL_SetRenderTarget(renderer, NULL); //恢复默认，渲染目标为窗口 SDL_RenderCopy(renderer, texture, NULL, NULL); //拷贝纹理到渲染器 SDL_RenderPresent(renderer); //输出到目标窗口上 SDL_Delay(100); if(show_count++ > 60) { run = 0; // 不跑了 } } SDL_DestroyTexture(texture); SDL_DestroyRenderer(renderer); SDL_DestroyWindow(window); //销毁窗口 SDL_Quit();

9.SDL事件响应

比较重要的两个事件接口:

(1)等待一个事件。

SDL_WaitEvent(&event);

(2)发送一个事件。

欢迎大家来到IT世界,在知识的湖畔探索吧!SDL_PushEvent(&event_q);

(3)存储事件

将硬件设备产生的事件放入事件队列，用于读取事件，在调用该函数之前，必须调用SDL_PumpEvents搜集键盘等事件。

SDL_PumpEvents()；

(4)从事件队列提取一个事件

欢迎大家来到IT世界,在知识的湖畔探索吧!SDL_PeepEvents()；

(5)代表一个事件

SDL_Event

效果图如下：

可以看到，能够检测到鼠标和键盘的响应事件。

(6)源码接口这里，支持很多事件，如鼠标，键盘等，如下图所示:

欢迎大家来到IT世界,在知识的湖畔探索吧!typedef enum { SDL_FIRSTEVENT = 0, /< Unused (do not remove) */ /* Application events */ SDL_QUIT = 0x100, /< User-requested quit */ /* These application events have special meaning on iOS, see README-ios.md for details */ SDL_APP_TERMINATING, /< The application is being terminated by the OS Called on iOS in applicationWillTerminate() Called on Android in onDestroy() */ SDL_APP_LOWMEMORY, /< The application is low on memory, free memory if possible. Called on iOS in applicationDidReceiveMemoryWarning() Called on Android in onLowMemory() */ SDL_APP_WILLENTERBACKGROUND, /< The application is about to enter the background Called on iOS in applicationWillResignActive() Called on Android in onPause() */ SDL_APP_DIDENTERBACKGROUND, /< The application did enter the background and may not get CPU for some time Called on iOS in applicationDidEnterBackground() Called on Android in onPause() */ SDL_APP_WILLENTERFOREGROUND, /< The application is about to enter the foreground Called on iOS in applicationWillEnterForeground() Called on Android in onResume() */ SDL_APP_DIDENTERFOREGROUND, /< The application is now interactive Called on iOS in applicationDidBecomeActive() Called on Android in onResume() */ /* Display events */ SDL_DISPLAYEVENT = 0x150, /< Display state change */ /* Window events */ SDL_WINDOWEVENT = 0x200, /< Window state change */ SDL_SYSWMEVENT, /< System specific event */ /* Keyboard events */ SDL_KEYDOWN = 0x300, /< Key pressed */ SDL_KEYUP, /< Key released */ SDL_TEXTEDITING, /< Keyboard text editing (composition) */ SDL_TEXTINPUT, /< Keyboard text input */ SDL_KEYMAPCHANGED, /< Keymap changed due to a system event such as an input language or keyboard layout change. */ /* Mouse events */ SDL_MOUSEMOTION = 0x400, /< Mouse moved */ SDL_MOUSEBUTTONDOWN, /< Mouse button pressed */ SDL_MOUSEBUTTONUP, /< Mouse button released */ SDL_MOUSEWHEEL, /< Mouse wheel motion */ /* Joystick events */ SDL_JOYAXISMOTION = 0x600, /< Joystick axis motion */ SDL_JOYBALLMOTION, /< Joystick trackball motion */ SDL_JOYHATMOTION, /< Joystick hat position change */ SDL_JOYBUTTONDOWN, /< Joystick button pressed */ SDL_JOYBUTTONUP, /< Joystick button released */ SDL_JOYDEVICEADDED, /< A new joystick has been inserted into the system */ SDL_JOYDEVICEREMOVED, /< An opened joystick has been removed */ /* Game controller events */ SDL_CONTROLLERAXISMOTION = 0x650, /< Game controller axis motion */ SDL_CONTROLLERBUTTONDOWN, /< Game controller button pressed */ SDL_CONTROLLERBUTTONUP, /< Game controller button released */ SDL_CONTROLLERDEVICEADDED, /< A new Game controller has been inserted into the system */ SDL_CONTROLLERDEVICEREMOVED, /< An opened Game controller has been removed */ SDL_CONTROLLERDEVICEREMAPPED, /< The controller mapping was updated */ /* Touch events */ SDL_FINGERDOWN = 0x700, SDL_FINGERUP, SDL_FINGERMOTION, /* Gesture events */ SDL_DOLLARGESTURE = 0x800, SDL_DOLLARRECORD, SDL_MULTIGESTURE, /* Clipboard events */ SDL_CLIPBOARDUPDATE = 0x900, /< The clipboard changed */ /* Drag and drop events */ SDL_DROPFILE = 0x1000, /< The system requests a file open */ SDL_DROPTEXT, /< text/plain drag-and-drop event */ SDL_DROPBEGIN, /< A new set of drops is beginning (NULL filename) */ SDL_DROPCOMPLETE, /< Current set of drops is now complete (NULL filename) */ /* Audio hotplug events */ SDL_AUDIODEVICEADDED = 0x1100, /< A new audio device is available */ SDL_AUDIODEVICEREMOVED, /< An audio device has been removed. */ /* Sensor events */ SDL_SENSORUPDATE = 0x1200, /< A sensor was updated */ /* Render events */ SDL_RENDER_TARGETS_RESET = 0x2000, /< The render targets have been reset and their contents need to be updated */ SDL_RENDER_DEVICE_RESET, /< The device has been reset and all textures need to be recreated */ / Events ::SDL_USEREVENT through ::SDL_LASTEVENT are for your use, * and should be allocated with SDL_RegisterEvents() */ SDL_USEREVENT = 0x8000, / * This last event is only for bounding internal arrays */ SDL_LASTEVENT = 0xFFFF } SDL_EventType;

(7)填充event_q.type，可以支持用户自定义事件。如下所示：

event_q.type = FF_QUIT_EVENT;

这些事件，主要是用来做播放控制。

上述事件的核心代码如下:

欢迎大家来到IT世界,在知识的湖畔探索吧!SDL_Event event; int b_exit = 0; for (;;) { SDL_WaitEvent(&event); switch (event.type) { case SDL_KEYDOWN: /* 键盘事件 */ switch (event.key.keysym.sym) { case SDLK_a: printf("key down a\n"); break; case SDLK_s: printf("key down s\n"); break; case SDLK_d: printf("key down d\n"); break; case SDLK_q: printf("key down q and push quit event\n"); SDL_Event event_q; event_q.type = FF_QUIT_EVENT; SDL_PushEvent(&event_q); break; default: printf("key down 0x%x\n", event.key.keysym.sym); break; } break; case SDL_MOUSEBUTTONDOWN: /* 鼠标按下事件 */ if (event.button.button == SDL_BUTTON_LEFT) { printf("mouse down left\n"); } else if(event.button.button == SDL_BUTTON_RIGHT) { printf("mouse down right\n"); } else { printf("mouse down %d\n", event.button.button); } break; case SDL_MOUSEMOTION: /* 鼠标移动事件 */ printf("mouse movie (%d,%d)\n", event.button.x, event.button.y); break; case FF_QUIT_EVENT: printf("receive quit event\n"); b_exit = 1; break; } if(b_exit) break; } //destory renderer if (renderer) SDL_DestroyRenderer(renderer); // Close and destroy the window if (window) SDL_DestroyWindow(window); // Clean up SDL_Quit(); return 0;

10.SDL多线程

ffplay就是使用的SDL的多线程。这样做的目的就是为了跨平台。

(1)SDL线程创建：SDL_CreateThread。如下示例:

SDL_Thread * t = SDL_CreateThread(thread_work,"thread_work",NULL);

(2)SDL等待线程退出：SDL_WaitThread。如下示例:

欢迎大家来到IT世界,在知识的湖畔探索吧! SDL_WaitThread(t, NULL);

(3)SDL条件变量(信号量)：
SDL_CreateCond/SDL_DestroyCond。如下示例:

s_cond = SDL_CreateCond(); SDL_DestroyCond(s_cond);

信号量是为了让各个线程之间，能够相互合作。能够起到一个通知的作用。

(4)SDL互斥锁创建与销毁：
SDL_CreateMutex/SDL_DestroyMutex。如下示例:

欢迎大家来到IT世界,在知识的湖畔探索吧!s_lock = SDL_CreateMutex(); SDL_DestroyMutex(s_lock);

(5)SDL锁定互斥：
SDL_LockMutex/SDL_UnlockMutex。如下示例:

SDL_LockMutex(s_lock); SDL_UnlockMutex(s_lock);

(6)SDL条件变量(信号量)等待/通知：
SDL_CondWait/SDL_CondSignal。如下示例:

欢迎大家来到IT世界,在知识的湖畔探索吧!SDL_CondWait(s_cond, s_lock); SDL_CondSignal(s_cond);

如下示例代码:

主线程:

子线程:

执行结果:

创建子线程，获取到锁，先休眠10s。再等待条件变量。这时候主线程执行，运行4s后，获取锁，此时子线程还拿着锁(此时还是一个condwait状态)，此时主线程就要等待子线程释放锁。主线程获取锁后，主线程就会执行它自己的工作，执行完后，就会发送信号，唤醒等待的子线程，紧接着主线程释放锁，这两个动作都是很重要，否则会出现问题。

注意:如果主线程不发送信号，子线程是不会被唤醒。所以发送信号和释放lock，是两部必须的动作。

11.总结

本文主要讲解了SDL的原理，框架，用示例代码说明了SDL的显示，绘制图形，事件，线程，锁等重要知识，这些都是在音视频开发有重要的运用了，但是远不止这些功能，如果要更学习其它功能，就需要根据官网提供的文档和wiki继续学习。欢迎关注，收藏，转发，分享。

后期关于项目知识，也会更新在微信公众号“记录世界 from antonio”，欢迎关注