下文从使用SDL的编程函数开始，介绍了如何使用SDL在屏幕上进行象素绘制的基本知识，并给出了一个简单的例子。

　　如果要在VC中用SDL库，必须在源文件头部包含以下头文件：

#include “SDL.h”

　　初始化SDL是通过SDL_Init()函数来实现的。如果初始化失败，函数返回值为0。函数只接受初始化对象作为参数。如果要初始化视频屏幕，传入常数SDL_INIT_VIDEO作为参数；初始化音频，传入常数SDL_INIT_AUDIO；如果同时初始化视频和音频，传入SDL_INIT_VIDEO|SDL_INIT_AUDIO。其它还有一些量可以传入作为参数的（如果同时传入多个量要使用|将它们隔开）：

SDL_INIT_TIMER SDL_INIT_AUDIO SDL_INIT_VIDEO SDL_INIT_CDROM SDL_INIT_JOYSTICK SDL_INIT_NOPARACHUATE SDL_INIT_EVENTTHREAD SDL_INIT_EVERYTHING

　　如果我们要初始化，可以使用如下语句：

if ( SDL_Init(SDL_INIT_VIDEO | SDL_INIT_AUDIO) < 0 ) { 　printf(“Unable to init SDL: %s\n”, SDL_GetError()); 　return 1; }

　　如果初始化失败，则函数SDL_GetError()返回关于错误的一个字符串提示信息。

　　当从你的C++语句返回时，记住使用SDL_Quit()进行程序的清理工作，否则就会出现奇怪的现象。可以使用如下语句进行描述：

atexit(SDL_Quit);

　　这样的话就不需要在main函数中每个return语句前加入SDL_Quit()了。

　　在SDL中你可以拥有多个surface，每件物体都是一个surface。你可以在一个surface上进行绘图或者在其他surface上绘制另外一个surface。程序中一个surface的表示即为指向结构SDL_Surface的指针。如果要获得一个surface只要如下定义：

SDL_Surface *screen;

　　如果需要对screen所指向的surface上进行绘图，你可以使用函数SDL_SetVideoMode()来设置屏幕分辨率：

screen = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE | SDL_DOUBLEBUF);

　　前三个参数分别为屏幕宽度，高度和屏幕上的每象素包含的位数(bits per pixel, BPP)。如果填入0则SDL自动选择最合适的BPP。第四个参数用来给出某些特殊标志位。如果要在屏幕上进行图形绘制就必须使用SDL_HWSURFACE或者SDL_SWSURFACE。以下给出了一个你可以指定的标志位：

　　SDL_SWSURFACE:在系统内存中创建视频Surface

　　SDL_HWSURFACE:在视频内存中创建视频Surface

　　SDL_ASYNCBLIT:允许在显示surface上使用异步更新。在单CPU机器上会变慢，但在SMP系统上会有显著的性能提升。

　　SDL_ANYFORMAT:一般的，如果指定位数的bpp不可用，那么SDL就会模拟使用阴影surface。如果传入SDL_ANYFORMAT就会阻止这样做，并且不管色深强制使用视频surface。

　　SDL_HWPALETTE:给予SDL特许的画盘的访问权，使用这个标志位就不需要总是使用SDL_SetColors或者SDL_SetPalette来获取所需的颜色。

　　SDL_DOUBLEBUF:允许硬件双缓冲；只是和SDL_HWSURFACE一起使用时比较有用。调用SDL_Flip将会flip整个缓冲并且更新屏幕。所有的绘制将会在当前未显示的surface上发生。如果双缓冲被允许，那么SDL_Flip将会对整个屏幕进行SDL_UpdateRect操作。

　　SDL_FULLSCREEN:SDL将会尝试使用全屏模式。如果硬件分辨率的调整由于某种情况无法完成，那么下一个稍高的分辨率将会被使用，并且显示窗口将会处于一个黑色背景的中央。

　　SDL_OPENGL:创建一个OPENGL rendering context。使用前必须已经使用SDL_GL_SetAttribute对OpenGL视频属性进行设置。

　　SDL_OPENGLBLIT: 和上一个选项一样创建一个 OPENGL rendering context, 但是允许使用正常的blitting操作。

　　SDL_RESIZABLE; 创建一个可伸缩大小的窗口。当用户调整窗口大小时，将会触发一个SDL_VIDEORESIZE事件，SDL_SetVideoMode将会使用新大小作为参数再次被调用。

　　SDL_NOFRAME: 如果可以的话，SDL_NOFRAME将会创建出一个没有标题栏和边界修饰的窗口，全屏方式自动设置此标志位。

　　建议使用SDL_HWSURFACE | SDL_DOUBLEBUF，如果出现错误可以尝试使用SDL_SWSURFACE。

　　SDL_SetVideoMode如果操作成功，则返回一个指向SDL_Surface的指针，否则的话返回NULL。可以使用如下语句检查发生的错误：

If ( screen == NULL ) { 　printf(“Unable to set 640x480 video: %s\n”, SDL_GetError()); 　return 1; }

　　以上介绍了如何对SDL进行初始化，下面可以开始绘制了。但是还有一些需要注意的关键地方，首先是一些SDL使用的容易让人产生迷惑的数据类型：

Uint8 – 相当于unsigned char Uint16 – 16位(2字节) unsigned integer Uint32 – 32位(4字节) unsigned integer Uint64 - 64位(8字节) unsigned integer Sint8 – 相当于signed char Sint16 – 16位(2字节) signed integer Sint32 – 32位(4字节) signed integer Sint64 - 64位(8字节) signed integer

　　还有，有的时候如果初始化出现错误，没必要完全退出。例如当初始化了SDL_INIT_VIDEO而没有初始化SDL_INIT_AUDIO，那么你可以继续这个错误只是没有音频而已。要检查是否音频初始化是否成功，可以使用SDL_WasInit()函数来检查。下面是一个例子：

Uint32 init = SDL_WasInit(SDL_INIT_AUDIO); If (init & SDL_INIT_AUDIO) { 　sound = 1; } else { 　sound = 0; }

　　你可以在程序初始化的某些地方加入以上语句。

　　以下是SDL介绍中进行象素绘制的语句，可以暂时不需要完全了解其中的意思：

void DrawPixel(SDL_Surface *screen, int x, int y, Uint8 R, Uint8 G, Uint8 B) { 　Uint32 color = SDL_MapRGB(screen->format, R, G, B); 　switch (screen->format->BytesPerPixel) 　{ 　　case 1: // Assuming 8-bpp 　　{ 　　　Uint8 *bufp; 　　　bufp = (Uint8 *)screen->pixels + y*screen->pitch + x; 　　　*bufp = color; 　　} 　　break; 　　case 2: // Probably 15-bpp or 16-bpp 　　{ 　　　Uint16 *bufp; 　　　bufp = (Uint16 *)screen->pixels + y*screen->pitch/2 + x; 　　　*bufp = color; 　　} 　　break; 　　case 3: // Slow 24-bpp mode, usually not used 　　{ 　　　Uint8 *bufp; 　　　bufp = (Uint8 *)screen->pixels + y*screen->pitch + x * 3; 　　　if(SDL_BYTEORDER == SDL_LIL_ENDIAN) 　　　{ 　　　　bufp[0] = color; 　　　　bufp[1] = color >> 8; 　　　　bufp[2] = color >> 16; 　　　} else{ 　　　　bufp[2] = color; 　　　　bufp[1] = color >> 8; 　　　　bufp[0] = color >> 16; 　　　} 　　} 　　break; 　　case 4: // Probably 32-bpp 　　{ 　　　Uint32 *bufp; 　　　bufp = (Uint32 *)screen->pixels + y*screen->pitch/4 + x; 　　　*bufp = color; 　　} 　　break; 　} }

　　通过这个函数，可以传递给surface要绘制的点的(x,y)坐标和RGB值。
 　　同时，由于绘制的屏幕不能同时接受两个函数的同时操作，我们需要其他两个辅助函数，用于在绘制前对屏幕进行锁定，以及在绘制完成之后解除锁定。这两个工作一般由SDL_MUSTLOK(SDL_Surface *screen)和SDL_UnlockSurface(SDL_Surface *screen)完成。使用如下两个自定义的函数会更加简单：

void Slock(SDL_Surface *screen) { 　if ( SDL_MUSTLOCK(screen) ) 　{ 　　if ( SDL_LockSurface(screen) < 0 ) 　　{ 　　　return; 　　} 　} } void Sulock(SDL_Surface *screen) { 　if ( SDL_MUSTLOCK(screen) ) 　{ 　　SDL_UnlockSurface(screen); 　} }

　　这样，我们可以得到一个简单的主程序框架如下：

#include <stdio.h> #include <stdlib.h> #include "SDL.h" // The functions are not shown to save space void DrawPixel(SDL_Surface *screen, int x, int y, Uint8 R, Uint8 G, Uint8 B); void Slock(SDL_Surface *screen); void Sulock(SDL_Surface *screen); int main(int argc, char *argv[]) { 　if ( SDL_Init(SDL_INIT_AUDIO|SDL_INIT_VIDEO) < 0 ) 　{ 　　printf("Unable to init SDL: %s\n", SDL_GetError()); 　　exit(1); 　} 　atexit(SDL_Quit); 　SDL_Surface *screen; 　screen=SDL_SetVideoMode(640,480,32,SDL_HWSURFACE|SDL_DOUBLEBUF); 　if ( screen == NULL ) 　{ 　　printf("Unable to set 640x480 video: %s\n", SDL_GetError()); 　　exit(1); 　} 　// DRAWING GOES HERE 　return 0; }

　　如果对该程序进行编译运行，那么只能得到一闪而过的一个黑色的窗口。我们需要对窗口进行绘制，并且对基本的键盘鼠标事件进行处理。

　　绘制的基本原理是，先在缓冲区绘制，再一次性将缓冲区绘制到屏幕上。这样比起一次一个象素点在屏幕上绘图的方式效率更高，速度更快，也不易出错。首先使用循环在screen所指向的surface(缓冲区)上绘制，然后调用SDL_Flip函数将screen surface绘制到真实电脑屏幕上。SDL_Flip函数的作用是：在支持双缓冲(double-buffering)的硬件上，建立flip并返回。硬件将等待vertical retrace,然后在下一个视频surface blit或者执行锁定返回前交换视频缓冲区。如果硬件不支持双缓冲，那么等同于调用SDL_UpdateRect(screen, 0, 0, 0, 0)，即对整个screen的绘制区域进行刷新。

void DrawScene(SDL_Surface *screen) { 　Slock(screen); 　for(int x=0;x<640;x++) 　{ 　　for(int y=0;y<480;y++) 　　{ 　　　DrawPixel(screen, x,y,y/2,y/2,x/3); 　　} 　} 　Sulock(screen); 　SDL_Flip(screen); }

　　在SDL中对采用结构SDL_Event来描述事件，并采用轮询的机制对事件进行处理，程序中使用一个SDL_Event的实例(Instance)来检查事件的发生：

SDL_Event event;

　　轮询采用while循环来检查：

while ( SDL_PollEvent(&event)) { 　if ( event.type == SDL_QUIT) 　{ 　　//code here…. 　} 　if ( event.type == SDL_KEYDOWN) 　{ 　　//code here…. 　} 　//….. }

　　事件轮询完毕之后，调用DrawScene(sreen)进行一次绘制。 

         本例中的源代码如下：

#include <stdio.h> #include <stdlib.h> #include "SDL.h" void Slock(SDL_Surface *screen) { 　if ( SDL_MUSTLOCK(screen) ) 　{ 　　if ( SDL_LockSurface(screen) < 0 ) 　　{ 　　　return; 　　} 　} } void Sulock(SDL_Surface *screen) { 　if ( SDL_MUSTLOCK(screen) ) 　{ 　　SDL_UnlockSurface(screen); 　} } void DrawPixel(SDL_Surface *screen, int x, int y, Uint8 R, Uint8 G, Uint8 B) { 　Uint32 color = SDL_MapRGB(screen->format, R, G, B); 　switch (screen->format->BytesPerPixel) 　{ 　　case 1: // Assuming 8-bpp 　　{ 　　　Uint8 *bufp; 　　　bufp = (Uint8 *)screen->pixels + y*screen->pitch + x; 　　　*bufp = color; 　　} 　　break; 　　case 2: // Probably 15-bpp or 16-bpp 　　{ 　　　Uint16 *bufp; 　　　bufp = (Uint16 *)screen->pixels + y*screen->pitch/2 + x; 　　　*bufp = color; 　　} 　　break; 　　case 3: // Slow 24-bpp mode, usually not used 　　{ 　　　Uint8 *bufp; 　　　bufp = (Uint8 *)screen->pixels + y*screen->pitch + x * 3; 　　　if(SDL_BYTEORDER == SDL_LIL_ENDIAN) 　　　{ 　　　　bufp[0] = color; 　　　　bufp[1] = color >> 8; 　　　　bufp[2] = color >> 16; 　　　} else { 　　　　bufp[2] = color; 　　　　bufp[1] = color >> 8; 　　　　bufp[0] = color >> 16; 　　　} 　　} 　　break; 　　case 4: // Probably 32-bpp 　　{ 　　　Uint32 *bufp; 　　　bufp = (Uint32 *)screen->pixels + y*screen->pitch/4 + x; 　　　*bufp = color; 　　} 　　break; 　} } void DrawScene(SDL_Surface *screen) { 　Slock(screen); 　for(int x=0;x<640;x++) 　{ 　　for(int y=0;y<480;y++) 　　{ 　　　DrawPixel(screen, x,y,y/2,y/2,x/3); 　　} 　} 　Sulock(screen); 　SDL_Flip(screen); } int main(int argc, char *argv[]) { 　if ( SDL_Init(SDL_INIT_AUDIO|SDL_INIT_VIDEO) < 0 ) 　{ 　　printf("Unable to init SDL: %s\n", SDL_GetError()); 　　exit(1); 　} 　atexit(SDL_Quit); 　SDL_Surface *screen; 　screen=SDL_SetVideoMode(640,480,32,SDL_HWSURFACE|SDL_DOUBLEBUF); 　if ( screen == NULL ) 　{ 　　printf("Unable to set 640x480 video: %s\n", SDL_GetError()); 　　exit(1); 　} 　int done=0; 　while(done == 0) 　{ 　　SDL_Event event; 　　while ( SDL_PollEvent(&event) ) 　　{ 　　　if ( event.type == SDL_QUIT ) { done = 1; } 　　　if ( event.type == SDL_KEYDOWN ) 　　　{ 　　　　if ( event.key.keysym.sym == SDLK_ESCAPE ) { done = 1; } 　　　} 　　} 　　DrawScene(screen); 　} 　return 0; }

　　程序运行结果如下：