SDL函数库详细介绍.pdf

第四章跨平台图象显示库——SDL

第二节函数库的详细介绍——基本函数

在上一节中，我们已经了解了SDL的安装和基本的使用方法。还给出了编译使用SDL

程序的源代码。接下来，我将带领各位深入SDL其中，逐一介绍SDL的各个函数。首先我

们先从基本函数说起。

当你需要在你的程序中使用SDL的时候。你首先要做的事情，就是在你的程序中初始

化SDL。这个工作，你可以交由SDL_Init函数来做。SDL_Init函数可以初始化任何SDL所

支持的子系统，其中包括图象，声音，摇杆，时钟等子系统。当然，在你使用SDL_Init函

数初始化以后，你可以使用SDL_InitSubSystem和SDL_QuitSubSystem函数来加载和卸载

子系统的。当然啦，你的程序退出前，你必须卸载所有的子系统以释放系统资源。通过调

用SDL_Quit，可以轻松的卸载掉你所加载的子系统并释放这些子系统的系统资源。

SDL_Init

函数摘要

#include“SDL.h”

intSDL_Init(Uint32flags);

函数介绍

这个函数是用于初始化SDL的，你必须在调用其他的SDL函数之前调用该函数。其中

flags的参数和意义如下。当你需要初始化多个子系统的时候，可以用把这些参数或起来。

SDL_INIT_TIMER始化计时器子系统

SDL_INIT_AUDIO始化音频子系统

SDL_INIT_VIDEO始化视频子系统

SDL_INIT_CDROM始化光驱子系统

SDL_INIT_JOYSTICK始化摇杆子系统

SDL_INIT_EVERYTHING初始化以上全部的子系统

返回值说明

返回-1表示错误，返回0表示初始化成功。

SDL_InitSubSyste

函数摘要

#include“SDL.h”

intSDL_InitSubSystem(Uint32flags);

函数介绍

在你通过SDL_Init为SDL初始化以后，你可以通过SDL_InitSubSyste函数来初

始化那些没有被初始化的子系统。其中flags的参数定义和SDL_Init的一样。

返回值说明

返回-1表示错误，返回0表示初始化成功。

SDL_QuitSubSyte

函数摘要

#include“SDL.h”

voidSDL_QuitSubSystem(Uint32flags);

函数介绍

SDL_QuitSubSyste函数可以卸载你曾经通过SDL_Init或者SDL_InitSubSyte函

数加载的子系统，其中参数flasgs的定义和SDL_Init中的定义一样。

SDL_Quit

函数摘要

#include“SDL.h”

voidSDL_Quit(void);

函数介绍

SDL_Quit函数可以卸载所有你所加载的子系统，并且释放这些子系统所占用的资源。

这个函数一般是在程序退出以前调用的。

SDL_WasInit

函数摘要

#include“SDL.h”

Uint32SDL_WasInit(Uint32flags);

函数介绍

SDL_WasInit函数，允许你查看你所加载的子系统有哪些。其中flags的内容为你

所要检查的子系统。

返回值说明

函数返回一组你所要检查的子系统加载情况的说明。是几个bit字的或。你可以用

与操作来逐一检查你所要检查的子系统是否被加载。

下面给出一组关于以上函数的Demo代码，以及他的Makefile。

SDL_General_Demo.c的C代码

//NERVEDevelopmentTeam

//SDL_General_Demo.c

#includestdio.h

#includestdlib.h

#includeSDL.h

#defineNOTE(msg)printf(NOT