SDL2学习笔记1-环境搭建以及Hello SDL

SDL（SimpleDirectMedia Layer）是一套开放源代码的跨平台多媒体开发库，使用C语言写成。SDL提供了数种控制图像、声音、输出入的函数，让开发者只要用相同或是相似的代码就可以开发出跨多个平台（Linux、Windows、Mac
OS X等）的应用软件。目前SDL多用于开发游戏、模拟器、媒体播放器等多媒体应用领域。



采用VS2012进行开发。



第一步，下载SDL的头文件以及lib库文件（此处为下载Visual
Studio下的头文件以及库文件）。在这里下载：http://libsdl.org/download-2.0.php。



第二步，进行环境的搭建。

开发环境采用VS2012。
新建控制台工程后，将下载下来的include文件夹以及lib文件夹复制到工程目录下。

下面进行设置头文件目录以及lib库文件目录。
1).头文件目录设置如下：



2).lib库目录设置如下（win32 Debug下设置方法）：



3).附加依赖项设置



4).将下载下来的lib文件夹下x86文件夹下的SDL2.dll动态链接库拷贝至工程Debug文件夹下。

第三步，开始编写程序。程序如下:

//最简单的SDL程序
//2015.8.11
//程序功能：显示一个640*480大小的窗口，窗口内容为绿色
//
//Using SDL and standard IO
#include <SDL.h>
#include <stdio.h>

//Screen dimension constants  屏幕宽高设置
const int SCREEN_WIDTH = 640;
const int SCREEN_HEIGHT = 480;

int main( int argc, char* args[] )
{
	//The window we'll be rendering to
	SDL_Window* window = NULL;

	//The surface contained by the window
	SDL_Surface* screenSurface = NULL;

	//Initialize SDL  初始化SDL视频子系统
	if( SDL_Init( SDL_INIT_VIDEO ) < 0 )
	{
		printf( "SDL could not initialize! SDL_Error: %s\n", SDL_GetError() );
		return 0;
	}
	
	//Create window  创建窗口
	window = SDL_CreateWindow( "Hello SDL",//窗口标题
						SDL_WINDOWPOS_UNDEFINED,//窗口位置设置
						SDL_WINDOWPOS_UNDEFINED, 
						SCREEN_WIDTH, //窗口的宽度
						SCREEN_HEIGHT,//窗口的高度
						SDL_WINDOW_SHOWN  //显示窗口
						);
	if( window == NULL )
	{
		printf( "Window could not be created! SDL_Error: %s\n", SDL_GetError() );
		return 0;
	}

	//Get window surface
	screenSurface = SDL_GetWindowSurface( window );

	//Fill the surface green   填充颜色为绿色
	SDL_FillRect( screenSurface, NULL, SDL_MapRGB( screenSurface->format, 0x00, 0xff, 0x00 ) );

	//Update the surface
	SDL_UpdateWindowSurface( window );

	//Wait two seconds 延时2000毫秒
	SDL_Delay( 2000 );

	//Destroy window
	SDL_DestroyWindow( window );

	//Quit SDL subsystems
	SDL_Quit();

	return 1;
}

程序运行现象如下：



部分函数说明：

① ： 初始化

int  SDL_Init(Uint32 flags);

函数介绍
这个函数是用于初始化SDL的，你必须在调用其他的SDL函数之前调用该函数。其中
flags的参数和意义如下。当你需要初始化多个子系统的时候，可以用把这些参数或 起来。

SDL_INIT_TIMER 初始化 计时器 子系统

SDL_INIT_AUDIO 初始化 音频 子系统

SDL_INIT_VIDEO 初始化 视频 子系统

SDL_INIT_CDROM 初始化 光驱 子系统

SDL_INIT_JOYSTICK 初始化 摇杆 子系统

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

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

② 创建窗口

SDL_Window * SDLCALL SDL_CreateWindow(const char *title,
                                                      int x, int y, int w,
                                                      int h, Uint32 flags);

参数含义如下。

title ：窗口标题

x ：窗口位置x坐标。也可以设置为SDL_WINDOWPOS_CENTERED或SDL_WINDOWPOS_UNDEFINED。

y ：窗口位置y坐标。同上。

w ：窗口的宽

h ：窗口的高

flags ：支持下列标识。包括了窗口的是否最大化、最小化，能否调整边界等等属性。

::SDL_WINDOW_FULLSCREEN, ::SDL_WINDOW_OPENGL,

::SDL_WINDOW_HIDDEN, ::SDL_WINDOW_BORDERLESS,

::SDL_WINDOW_RESIZABLE, ::SDL_WINDOW_MAXIMIZED,

::SDL_WINDOW_MINIMIZED, ::SDL_WINDOW_INPUT_GRABBED,

::SDL_WINDOW_ALLOW_HIGHDPI.

返回创建完成的窗口的ID。如果创建失败则返回0。

③：

int SDL_FillRect(SDL_Surface* dst,const SDL_Rect* rect,Uint32 color)

参数说明：dst为所要填充颜色的Surface类型指针，rect为填充颜色的矩形区域， color为要填充的32为无符号整型颜色值。
参数说明：color=SDL_MapRGB(dst->format,Uint8 R,Uint8 G,Uint8 B)，R为红色,G为绿色，B为蓝色（范围为0—255的16进制的数，例如0xff，或者0XFF）。（或者由SDL_MapRGBA（SDL_Surface*format,Uint8 R,Uint8 G,Uint8 B, Uint8 A)得到，A为alpha透明度，0为完全透明，255为完全不透明）
函数说明：使用这个函数将设定的矩形区域填充为指定的颜色，成功返回0。

本测试工程下载地址：http://download.csdn.net/detail/hjl240/8990221

SDL帮助文档网页版：http://wiki.libsdl.org/FrontPage

SDL帮助文档离线版下载地址：http://download.csdn.net/detail/hjl240/8990135