GFX with SDL Lesson 1: Getting started with SDL(翻譯) 
GFX with SDL
Lesson 1: Getting started with SDL
作者：Marius Andra
翻譯：heroboy


歡迎來到“GFX with SDL”的第一篇教程。

在Dev-C++中使用SDL

首先需要下載sdlDevCPP-1.2.4.zip（點擊名稱下載）。把zip文件解壓到Dev C++的目錄中，請確定include和lib文件夾（zip文件中）中的文件解壓到Dev C++中的include和lib文件夾中。我計算機上的Dev-C++文件夾是c:\Dev-C++。所以解壓以后，在c:\Dev-C++\lib會有libSDL.a，libSDL.la，libSDLmain.a和SDL.dll，在c:\Dev-C++\include\SDL中會有一些 .h文件。

 

現在，在Dev-C++中新建一個控制臺工程。打開“工程屬性”對話框（在“工程”菜單中）。在參數中，點擊“加入庫或者對象”按鈕，選擇libSDL.a，SDLmain.a和ligmingw32.a 三個文件。點擊“確定”。

 

最后，在SDL項目中使用printf(…)或輸出到stdout.txt中，而非屏幕。


在 Microsoft Visual C++ 6.0中使用SDL

要在MSVC6中使用SDL要下載SDL-devel-1.2.4-VC6.zip（請訪問www.libsdl.org下載更新版本的SDL）。在這個壓縮文件中有兩個重要的文件夾-include和lib，把lib文件夾中的文件復制到MSVC6的lib文件夾中（在我的機器上是C:\Program Files\Microsoft Visual Studio\VC98\Lib），在MSVC6的include文件夾中新建一個SDL文件夾（在我的機器上是C:\Program Files\Microsoft Visual Studio\VC98\Include\SDL），把壓縮文件中include文件夾中的.h文件復制到新建的文件夾中。

 

現在，在VC++中新建一個工程。選擇“WIN32 Application”和“'an empty project”。現在要為工程創建一個cpp文件，單擊File-〉new并選擇 “c++ source file”，名字輸入“main.cpp”。現在打開工程選項對話框（菜單project->settings）。點擊“LINK”欄，添加 “sdl.lib sdlmain.lib”到連接文件中（Object/library modules）。最后，點擊“C/C++”欄，在下拉菜單中選擇“Code Generation”。然后在“Use run-time library”下拉框中選擇“Multithreaded DLL”。

 

SDL.dll

 


SDL.dll是SDL中一個重要的文件（它在Dev-C++或MSVC6的SDL zip文件里）。如果你要運行SDL程序，你必須把SDL.dll復制到c:\windows\system (win 95, 98, ME) 或 c:\windows\system32 (on windows NT, 2000 and XP)。或者SDL.dll和你的程序在同一個文件夾。


Getting started with SDL

你已經設置好了一切。你要象下面一樣在你的程序中包含 SDL/SDL.h 文件：

#include <SDL/SDL.h>

通過SDL_Init()函數初始化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_NOPARACHUTE

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()函數返回一個字符串來描述這個錯誤。



但退出程序時，你必須調用SDL_Quit()。如果沒有調用的話，可能會出現一些異常的現象。告訴編譯器你要在退出時調用SDL_Quit，代碼如下：

atexit(SDL_Quit);

那樣就不需要在main函數中的每個return前加上SDL_Quit()了。

在SDL中需要很多的surface。一切都是surface。你可以在surface上繪圖，也可以把一個surface畫到另一個surface上。在SDL中，屏幕也是一個surface。在我們的程序中surface是一個指向SDL_Surface結構的指針。如下得到屏幕surface：

SDL_Surface *screen;

相信你在玩有些游戲的時候會要你選擇屏幕分辨率。如果沒有的話，請玩更多的游戲。如果你要使用surface屏幕（surface screen）（記住，screen只是一個指向SDL_Surface結構的指針），在上面繪圖（你在監視器上可以看到畫了什么），那么使用SDL_SetVideoMode()函數。

screen = SDL_SetVideoMode(640, 480, 32,

                             SDL_HWSURFACE|SDL_DOUBLEBUF);

前三個參數分別是屏幕的 寬度，高度和像素位數bits per pixel）。如果像素位數為0，SDL會為你自動選擇最合適的位數。第四個參數是一些特殊的標記。如果要在屏幕上繪圖的話，必須有SDL_HWSURFACE（或SDL_SWSURFACE）。下列是可用的選項：


SDL_SWSURFACE – 在系統內存中創建surface 
SDL_HWSURFACE – 在顯示內存中創建surface 
SDL_ASYNCBLIT – 允許異步刷新的surface。這會降低在單CPU上的位拷貝（blitting）的速度，但在SMP系統上速度會有提升。
SDL_ANYFORMAT - 一般地，如果給與的像素位數（bits-per-pixel，bpp）不可用的話，SDL回使用影子surface（shadow surface）模擬。SDL_ANYFORMAT會阻止這么做，而忽略參數中的像素位數。
SDL_HWPALETTE –給予SDL 獨立的調色板訪問（exclusive palette access）。沒有這個選項，你不能通過SDL_SetColors或SDL_SetPalette來獲取顏色。
SDL_DOUBLEBUF –允許硬件雙緩沖。只有和SDL_HWSURFACE一起使用才有效。調用SDL_Flip來翻轉（flip）緩沖并刷新屏幕。所有的繪圖不會立即顯示在屏幕上。如果不允許雙緩沖的話，SDL_Flip函數相當于對整個屏幕調用SDL_UpdateRect。
SDL_FULLSCREEN – SDL會嘗試使用全屏模式。如果硬件不支持當前的分辨率的話，會使用一個更高的分辨率和黑色的背景。
SDL_OPENGL –創建OpenGL渲染上下文（rendering context）。你應該預先使用SDL_GL_SetAttribute設置OpenGL視頻屬性。
SDL_OPENGLBLIT -創建OpenGL渲染上下文（rendering context），但使用普通的位拷貝（blitting）操作。屏幕surface（2D）會有一個alpha通道，并且必須使用SDL_UpdateRects來更新屏幕surface。
SDL_RESIZABLE –創建可縮放的窗口。當縮放的時候，會產生SDL_VIDEORESIZE事件，此時可通過SDL_SetVideoMode再次改變屏幕surface大小。
SDL_NOFRAME - 如果可行的話，SDL會創建無框架無標題欄的窗口。全屏模式自動包含此選項。

我的建議是：使用 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字節)無符號整形

Uint32 - 32位(4字節) 無符號整形

Uint64 - 64位(8字節) 無符號整形

Sint8 - 相當于 signed char

Sint16 - 16位(2字節) 有符號整形

Sint32 - 32位(4字節) 有符號整形

Sint64 - 64位(8字節) 有符號整形

另外，無論何時初始化出錯的時候，你不必完全退出。例如，SDL_INIT_VIDEO初始化成功，而SDL_INIT_AUDIO失敗的話，你仍然可以繼續運行程序，只是沒有聲音。為了檢測音頻是否初始化成功，使用SDL_WasInit()函數。代碼如下：

Uint32 init = SDL_WasInit(SDL_INIT_AUDIO);

if(init & SDL_INIT_AUDIO)

{

  sound = 1;  // Audio init sucessful, use sound

} else {

  sound = 0;  // Audio init unsucessful, don't use sound

}

你可以在如下代碼中插入上述代碼

if( SDL_Init(SDL_INIT_VIDEO|SDL_INIT_AUDIO) <0 )

{

  printf("Unable to init SDL: %s\n", SDL_GetError());

  return 1;

}

為簡單起見，我不在教程中插入此代碼。

繪制像素乍看是很簡單的，但如果你看了此函數的話其實并不簡單。我使用的這個像素繪制函數，取自SDL intro（www.libsdl.org上的）。如下：



注意：你不必完全理解它，只要使用就可以了

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_MUSTLOCK(SDL_Surface *screen)用來確定是否需要鎖定屏幕。SDL_LockSurface(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);

  }

}

調用 Slock(screen)鎖定屏幕， Sulock(screen)解鎖。


現在，代碼應該如下：

#include <stdio.h>

#include <stdlib.h>

 

#include <SDL/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;

}

運行一下。你會發現，一個空窗口閃了一下。加入SDL_FULLSCREEN標記，會看見一個黑屏。現在，讓我們繪圖。


我們來做一個簡單的繪圖：我們把所有的東西都繪制在一個緩沖上，再把緩沖畫到屏幕上。這比直接在屏幕上繪制像素簡單，速度快，而且沒有閃爍。