在早期 Windows 遊戲開發裡,DirectDraw 是最貼近底層的繪圖途徑。本文以一個典型的 Game_Main 框架為例,說明如何在 32 位元主表面上完成「鎖定—寫入—解鎖」的完整流程,並用隨機數灑出上千個彩色像素。
這個主函數做四件事:先檢查 ESC 鍵是否按下以送出關閉訊息;接著鎖定主顯示表面取得記憶體指標;然後在迴圈中隨機計算座標與顏色並寫入;最後解鎖表面。任何一步失敗都直接回傳 0,讓外層遊戲迴圈知道這一幀沒有畫成功。
DDSURFACEDESC2 這類結構欄位眾多,若不先 memset 歸零,未初始化的欄位會讓 Lock 的行為變得不可預期。設定 dwSize 則是 DirectDraw 用來判定結構版本的慣例。
32 位元模式下每個像素佔 4 個位元組,而 lPitch 是「每一列有多少位元組」。因此把 pitch 除以 4(即 >> 2)之後,就能用「像素索引」而非「位元組偏移」來定址。這樣寫出的 x + y * lpitch32 才正確。
小端序的 32 位元表面,記憶體中由低到高分別是藍、綠、紅、保留。所以組色公式是 blue | (green << 8) | (red << 16),最高位元組留給 alpha 或填 0。
int Game_Main(void *parms = NULL, int num_parms = 0)
{
// 按 ESC 鍵退出
if (KEYDOWN(VK_ESCAPE))
SendMessage(main_window_handle, WM_CLOSE, 0, 0);
memset(&ddsd, 0, sizeof(ddsd));
ddsd.dwSize = sizeof(ddsd);
// 鎖定主顯示表面
if (FAILED(lpddsprimary->Lock(NULL, &ddsd,
DDLOCK_SURFACEMEMORYPTR | DDLOCK_WAIT,
NULL)))
return(0);
int lpitch32 = (int)(ddsd.lPitch >> 2);
UINT *video_buffer = (UINT *)ddsd.lpSurface;
for (int index = 0; index < 1000; index++)
{
// 為 640x480x32 隨機挑選位置與顏色
int red = rand() % 256;
int green = rand() % 256;
int blue = rand() % 256;
int x = rand() % 640;
int y = rand() % 480;
UINT pixel = ((blue) + ((green) << 8) + ((red) << 16) + ((0) << 24));
// 寫入像素
video_buffer[x + y * lpitch32] = pixel;
} // end for index
// 解鎖主顯示表面
if (FAILED(lpddsprimary->Unlock(NULL)))
return(0);
return(1);
} // end Game_Main
鎖定主表面是昂貴操作,會造成 CPU 與顯示卡的同步等待,因此不適合每幀呼叫數千次;正式專案通常改用離屏表面搭配 Blt。此外,rand() 的品質低落且非執行緒安全,若要穩定重現的畫面,建議自行實作簡單的線性同餘或 xorshift 亂數,並在程式啟動時以時間戳播種。
把 640×480 寫死也是個隱憂,解析度一變就會寫出界。實務上應從 ddsd.dwWidth 與 ddsd.dwHeight 取得實際尺寸,再用取模運算限制座標範圍。