SDL GUIDE 中文译版(全）

SDL Guide 中文译版

内容目录

SDL Guide 中文译版...........................................................................................................................1

第一章 基础...................................................................................................................................2

例 1-1 初始化 SDL.....................................................................................................................3

第二章 图像和视频.......................................................................................................................3

例 2-1 初始化视频......................................................................................................................3

例 2-2 初始化最佳视频模式......................................................................................................4

第三章上 游戏杆输入处理.........................................................................................................20

例 3-1 初始化 SDL 并带游戏杆支持......................................................................................20

例 3-2 打印所有游戏杆的名字................................................................................................20

例 3-3 启动第一个游戏杆........................................................................................................21

例 3-4 游戏杆轴事件................................................................................................................22

例 3-5 ........................................................................................................................................22

例 3-6 游戏杆按钮事件............................................................................................................22

例 3-7 轨迹球事件....................................................................................................................23

例 3-8 游戏杆 hat 事件.............................................................................................................23

例 3-9 查询游戏杆特性............................................................................................................24

过滤和处理事件.......................................................................................................................34

打开音频设备...........................................................................................................................36

播放音频...................................................................................................................................36

列出所有 CDROM...................................................................................................................37

打开缺省 CDROM 驱动器......................................................................................................38

列出 CD 上所有音轨................................................................................................................39

播放 CD....................................................................................................................................39

基于时间的游戏主循环...........................................................................................................39

1

SDL 即 Simple DirectMedia Layer，类似 DirectX，是完整的游戏、多媒体开发包，但不

SDL 向导中文译版

序言

关于 SDL

SDL 为方便制作能跨跃 Linux、BSD、MacOS、Win32 和 BeOS 平台，使用本地高性能媒体

接口，并且让您可以只需使用一份源代码级 API 而设计。SDL 是相当低层的 API，但使用它

可以让你以极大的灵活性写出完全跨平台的程序。

关于 SDL 文档

SDLdoc 项目即要重新编写 SDL 文档并同步更新。项目组有使用 SDL 的志愿者组成。

最新版本可在 http://sdldoc.sourceforge.net 下载

第一章 基础

初始化缺省、视频和记时器子系统：

SDL_Init(SDL_INIT_VIDEO | SDL_INIT_TIMER);

SDL_Init 对应 SDL_Quit（和 SDL_QuitSubSystem）。SDL_Quit 关闭所有子系统，必须在程

序关闭前调用。

除此之外，我们还必须进行错误处理。很多 SDL 函数返回一个值指示成功与否。例如

SDL_Init 失败时返回-1。每当 SDL 出错时，错误信息被保存，并可用 SDL_GetError 取得。

例 1-1 初始化 SDL

#include "SDL.h" /* All SDL App's need this */

2

#include <stdio.h>int main()

{

printf("SDL initialized.");

printf("Quiting SDL."); /* Shutdown all subsystems */

SDL_Quit();

printf("Quiting....");

exit(0);

}

第二章 图像和视频

初始化 SDL Video 显示

视频是最常用的部分，也是 SDL 最完整的子系统。下面的初始化过程是每个 SDL 程序都要

做的，即使可能有些不同。

fprintf(stderr,

"Couldn''''t initialize SDL: %s\n", SDL_GetError());

exit(1);

}

/* Clean up on exit */

atexit(SDL_Quit);

/*

* Initialize the display in a 640x480 8-bit palettized mode,

3

exit(1);

}

初始化最佳视频模式

如果你希望某种色深（颜色数）但如果用户的显示器不支持也可以接受其他色深，使用加

SDL_ANYFORMAT 参数的 SDL_SetVideoMode。您还可以用 SDL_VideoModeOK 来找到与

请求模式最接近的模式。

例 2-2 初始化最佳视频模式

/* Have a preference for 8-bit, but accept any depth */

screen = SDL_SetVideoMode(640, 480, 8, SDL_SWSURFACE|SDL_ANYFORMAT);

if ( screen == NULL ) {

读取并显示 BMP 文件

当 SDL 已经初始化，视频模式已经选择，下面的函数将读取并显示指定的 BMP 文件。

例 2-3 读取并显示 BMP 文件

void display_bmp(char *file_name)

{

SDL_Surface *image;

/* Load the BMP file into a surface */

image = SDL_LoadBMP(file_name);

if (image == NULL) {

* 8*8*4 colour cube), but if the image is palettized as well we can

* use that palette for a nicer colour matching

*/

4

image->format->palette->ncolors);

}

/* Blit onto the screen surface */

if(SDL_BlitSurface(image, NULL, screen, NULL) < 0)

fprintf(stderr, "BlitSurface error: %s\n", SDL_GetError());

SDL_UpdateRect(screen, 0, 0, image->w, image->h);

/* Free the allocated BMP surface */

5