SDL_Surface

章節：SDL API 參考 (3)
更新：2001年9月11日星期二 23:01
索引

名稱

SDL_Surface - 繪圖平面結構體

結構體的定義

typedef struct SDL_Surface {
        Uint32 flags;                           /* 只讀 */
        SDL_PixelFormat *format;                /* 只讀 */
        int w, h;                               /* 只讀 */
        Uint16 pitch;                           /* 只讀 */
        void *pixels;                           /* 讀寫 */

        /* 裁剪信息 */
        SDL_Rect clip_rect;                     /* 只讀 */

        /* 引用計數 －－ 當釋放平面時使用 */
        int refcount;                           /* 主要用于讀 */

        /* 此結構體亦包含不示于此的隱藏域 */
} SDL_Surface;

結構體的內容

flags: 平面標記。
format: 像素格式。
w, h: 平面的寬度和高度。
pitch: 以字節計的平面掃描行的長度。
pixels: 指向實際像素數據的指針。
clip_rect: 平面的裁剪矩形。

描述

SDL_Surface用于表示一個可寫的圖形存儲器區域。視頻幀緩衝以SDL_Surface的形式為SDL_SetVideoMode和SDL_GetVideoSurface所返回。多數域的意思都是相當顯而易見的。w和h是以像素計的平面寬度和高度。pixels是指向實際像素數據的指針，應在訪問此域前鎖定平面。clip_rect域是裁剪矩形，跟SDL_SetClipRect所設置的一樣。

以下都是為flags域所支持的：

SDL_SWSURFACE: Surface存儲于系統內存。
SDL_HWSURFACE: Surface存儲于顯存。
SDL_ASYNCBLIT: 如果可以的話，則Surface使用異步圖塊傳送。
SDL_ANYFORMAT: 允許任意像素格式（顯示平面）。
SDL_HWPALETTE: Surface擁有獨佔的調色板。
SDL_DOUBLEBUF: Surface被雙緩衝（顯示平面）。
SDL_FULLSCREEN: Surface為全屏（顯示平面）。
SDL_OPENGL: Surface擁有OpenGL上下文（顯示平面）。
SDL_OPENGLBLIT: Surface支持OpenGL圖塊傳送（顯示平面）。
SDL_RESIZABLE: Surface尺寸可調（顯示平面）。
SDL_HWACCEL: Surface圖塊傳送使用硬件加速。
SDL_SRCCOLORKEY: Surface使用色鍵圖塊傳送。
SDL_RLEACCEL: 色鍵圖塊傳送為RLE所加速。
SDL_SRCALPHA: Surface圖塊傳送使用alpha渲染。
SDL_PREALLOC: Surface使用預分配的內存。

另見

SDL_PixelFormat

譯者

石仔<guoshimin57@gmail.com>

中文版主頁

http://guoshimin.users.sf.net

中文版最後更新時間

2010年2月16日