作者：龙飞
2.1：准备工作。
找一张*.bmp格式的图片。我在例子中将使用640*480大小的图片。如果你在windows下面，你可以打开画图程序自己简单的画一张，或者将其他格式的图片另存为bmp。然后将图片名字修改为helloworld.bmp（当然，你也可以在程序的相应部分修改为你目标图片的名字。），这是我们将要显示的图片。
2.2：创建一个SDL的执行窗口。
我们讨论过，SDL是跨平台的，它的设计者希望使用SDL的源程序不要依赖于具体平台，甚至具体的GUI和窗口管理器。在前面一节中，我们已经简单使用了SDL_SetVideoMode()，在这里，我们对它做进一步的介绍——使用这个函数实际上遇到的问题会比我们预想中涉及到的问题多，换句话说，这里的介绍仍然是不完整的。我们当前的目的，只是为了简单的显示一张BMP位图。
SDL_Surface *SDL_SetVideoMode(int width, int height, int bitsperpixel, Uint32 flags);
在这里，我们使用的flag(s)仍然是SDL_SWSURFACE。它的作用是说明所建立的surface是储存在系统内存中的。实际上，SDL_SWSURFACE是一个“伪位标”，如果你读出它的值，会发现其实是0！这意味着任何其他位标（以及|组合）与SDL_SWSURFACE的&结果都是0。这个事实的另外一层含义是，surface的数据“至少”会被储存在系统内存中——对立面的意思是，这些数据有可能储存在显存中（指定使用显存储存数据的位标是SDL_HWSURFACE，它的值是1）。
这个函数的返回值是一个SDL_Surface的结构指针。如果返回是空指针（C中习惯用NULL，而C++标准将空指针表示为0），则表示这个函数调用失败了。我们可以通过SDL_GetError()获得异常的原因。SDL_Surface结构包含了一个surface的数据结构，包括宽，高和每个像素点的具体颜色等等，我们也放在后面具体讨论。这里，我们还是直接把SDL_Surface看成一个类，这个函数返回一个SDL_Surface类对象的指针。
width和height是你希望建立的窗口的宽与高。如果值为0，则建立与你当前桌面等宽高的窗口。bitsperpixel是这个窗口的颜色位深。当前的硬件环境下，相信你的桌面也是32位色的。如果这个值为0，则所建立的窗口使用你当前桌面的位深。
我们试图建立一个640*480大小的，32位色的窗口。并且让返回的surface值储存在系统内存里。（后面会介绍使用显存的方法。）需要注意的是，我们必须记下这个返回的surface的指针，因为所有的图像操作，最后都是通过修改这个surface的数据作用在显示这个surface的窗口上，最终呈现在我们眼前的。
const int SCREEN_WIDTH = 640; // 0 means use current width.
const int SCREEN_HEIGHT = 480; // 0 means use current height.
const int SCREEN_BPP = 32; // 0 means use current bpp.
const Uint32 SCREEN_FLAGS = SDL_SWSURFACE; // SDL_SWSURFACE == 0,surface in system memory.
SDL_Surface* pScreen = 0;
pScreen = SDL_SetVideoMode(SCREEN_WIDTH, SCREEN_HEIGHT, SCREEN_BPP, SCREEN_FLAGS); // Creat a SDL window, and get the window's surface.
try {
if ( pScreen == 0 )
throw SDL_GetError();
}
catch ( const char* s ) {
std::cerr << "SDL_SetVideoMode() failed!\n" << s << std::endl;
SDL_Quit();
return -1;
}
2.3：装载BMP格式的位图。
SDL_Surface *SDL_LoadBMP(const char *file);
这个函数使用C风格字符串的形参，这意味着如果我们使用std::string objName传值的时候，需要使用objName.c_str()（请注意objName.data()没有'/0'），把std::string类转化为C风格字符串。这个函数把一个BMP位图转化成为SDL的surface数据结构方式（SDL_Surface结构），储存在系统内存中（我没找到任何信息可以说明能直接储存到显存中），并返回这个surface的指针。如果返回的指针为空，说明函数调用失败了。
SDL_Surface* pShownBMP = 0;
pShownBMP = SDL_LoadBMP("helloworld.bmp"); // Load a BMP file, and convert it as a surface.
try {
if ( pShownBMP == 0 )
throw SDL_GetError();
}
catch ( const char* s ) {
std::cerr << "SDL_LoadBMP() failed!\n" << s << std::endl;
SDL_Quit();
return -1;
}
2.4：块移图面（blit surface）。
int SDL_BlitSurface(SDL_Surface *src, SDL_Rect *srcrect, SDL_Surface *dst, SDL_Rect *dstrect);
src指的是要进行blit的源surface，dst指的是blit这个surface要去的目的地——另外一个surface。我们这里先忽略SDL_Rect结构的具体意思，仅仅需要了解的是，如果srcrect为空指针，意味着整个源surface将被blit；如果dstrect为空指针，意味着源surface与目的surface的左上角重合（坐标(0,0)）。
blit是个有渊源的词语，我将来会在术语解释中具体提到。这个词的本意就是块（block）移动（transfer）的缩写blt，因为这个缩写缺少元音不好读，所以后来加上了i，就变成blit。
如果blit成功，则返回0；否则返回-1。
SDL_Rect* pSrcRect = 0; // If pSrcRect is NULL, the entire source surface is copied.
SDL_Rect* pDstRect = 0; // If pDstRect is NULL, then the destination position (upper left corner) is (0, 0).
try {
if ( SDL_BlitSurface(pShownBMP, pSrcRect, pScreen, pDstRect) != 0 ) // Put the BMP's surface on the SDL window's surface.
throw SDL_GetError();
}
catch ( const char* s ) {
std::cerr << "SDL_BlitSurface() failed!\n" << s << std::endl;
SDL_Quit();
return -1;
}
2.5：显示图片。
int SDL_Flip(SDL_Surface *screen);
源图面被blit到目的图面上后，就与目的图面融为一体了。在我们的例子中，ShownBMP被“画”在了Screen上（我这里去掉了p，是为了说明这里讨论的是surface而不是surface的指针）。换句话说，Screen被修改了（似乎也可以用“染指”-_-!!），ShownBMP则没有改变。
另外一个需要了解的问题是，我们之前对surface的种种操作，实际上都是在修改surface数据结构中的某些数据，当我们最后需要将这些surface显示到屏幕上（我们打开的SDL操作窗口上），我们需要使用函数SDL_Flip()。如果函数调用成功，则返回0；否则返回-1。
try {
if ( SDL_Flip(pScreen) != 0 ) // Show the SDL window's surface.
throw SDL_GetError();
}
catch ( const char* s ) {
std::cerr << "SDL_Flip() failed!\n" << s << std::endl;
SDL_Quit();
return -1;
}
2.6：这个例子的完整源代码。
#include <iostream>
#include "SDL/SDL.h"
void pressESCtoQuit();
int main(int argc, char* argv[])
{
try {
if ( SDL_Init(SDL_INIT_VIDEO) != 0 )
throw SDL_GetError();
}
catch ( const char* s ) {
std::cerr << "SDL_Init() failed!\n" << s << std::endl;
return -1;
}
const int SCREEN_WIDTH = 640; // 0 means use current width.
const int SCREEN_HEIGHT = 480; // 0 means use current height.
const int SCREEN_BPP = 32; // 0 means use current bpp.
const Uint32 SCREEN_FLAGS = SDL_SWSURFACE; // SDL_SWSURFACE == 0,surface in system memory.
SDL_Surface* pScreen = 0;
pScreen = SDL_SetVideoMode(SCREEN_WIDTH, SCREEN_HEIGHT, SCREEN_BPP, SCREEN_FLAGS); // Creat a SDL window, and get the window's surface.
try {
if ( pScreen == 0 )
throw SDL_GetError();
}
catch ( const char* s ) {
std::cerr << "SDL_SetVideoMode() failed!\n" << s << std::endl;
SDL_Quit();
return -1;
}
SDL_Surface* pShownBMP = 0;
pShownBMP = SDL_LoadBMP("helloworld.bmp"); // Load a BMP file, and convert it as a surface.
try {
if ( pShownBMP == 0 )
throw SDL_GetError();
}
catch ( const char* s ) {
std::cerr << "SDL_LoadBMP() failed!\n" << s << std::endl;
SDL_Quit();
return -1;
}
SDL_Rect* pSrcRect = 0; // If pSrcRect is NULL, the entire source surface is copied.
SDL_Rect* pDstRect = 0; // If pDstRect is NULL, then the destination position (upper left corner) is (0, 0).
try {
if ( SDL_BlitSurface(pShownBMP, pSrcRect, pScreen, pDstRect) != 0 ) // Put the BMP's surface on the SDL window's surface.
throw SDL_GetError();
}
catch ( const char* s ) {
std::cerr << "SDL_BlitSurface() failed!\n" << s << std::endl;
SDL_Quit();
return -1;
}
try {
if ( SDL_Flip(pScreen) != 0 ) // Show the SDL window's surface.
throw SDL_GetError();
}
catch ( const char* s ) {
std::cerr << "SDL_Flip() failed!\n" << s << std::endl;
SDL_Quit();
return -1;
}
pressESCtoQuit();
SDL_Quit();
return 0;
}
void pressESCtoQuit()
{
bool gameOver = false;
while( gameOver == false ){
SDL_Event gameEvent;
while ( SDL_PollEvent(&gameEvent) != 0 ){
if ( gameEvent.type == SDL_QUIT ){
gameOver = true;
}
if ( gameEvent.type == SDL_KEYUP ){
if ( gameEvent.key.keysym.sym == SDLK_ESCAPE ){
gameOver = true;
}
}
}
}
return;
}
2.7：补充说明。
1) 这个程序用到了前面课程中建立起来的函数pressESCtoQuit();
2) 在VC的IDE中，引用的bmp文件可能会需要提供完整的绝对路径，否则直接通过VC菜单启动的程序可能找不到实际上就与exe文件在同一个文件夹中的bmp图片。你可以直接找到编译后的exe文件，在exe文件夹中直接运行，则不会出现这个问题。或者，你可以修改VC默认的资源文件路径，再或者，你可以尊重VC的默认约定，将资源文件拷贝到工程目录下（与源文件*.cpp在同一个文件夹里面）。
posted on 2008-02-06 01:54
lf426 阅读(10226)
评论(12) 编辑 收藏 引用 所属分类:
SDL入门教程