Loading Bitmap Files into DirectDraw
by Kieren Johnstone
载入位图文件到 DirectDraw
译：sea_bug
Introduction
介绍
In this article I will briefly describe the process of using Windows' functions to load a bitmap (.bmp) file of any type, and place it on a newly-created DirectDraw surface. In this particular article, we will be using the DirectX 7.0 SDK.
在这篇文章里，我将简要叙述一下使用Windows函数来载入任何类型的BMP图象文件数据，并将数据存
放到一个新建立的DirectDraw的表面中。在这以后的篇幅里，我们将使用DirectX 7.0 SDK。
DirectDraw Surface Creation
创建DirectDraw表面
Creating a new DirectDraw surface is very easy, and this function will create a surface of any size. This can also be used as a general-purpose surface creation function, and if you were writing an engine class you'd probably put it in there somewhere.
创建一个DirectDraw表面是非常容易的，这个函数将根据大小来创建一个表面。这同样能用于多种多
样的表面创建函数，如果你要制作一个引擎类，你也许会把这个放在引擎的某处。
Listing 1
代码列表 1
void CreateSurface(LPDIRECTDRAWSURFACE7 *lpSource, int xs, int ys)
{
DDSURFACEDESC2 ddsd;
ZeroMemory(&ddsd, sizeof(ddsd));
ddsd.dwSize = sizeof(ddsd);
ddsd.dwFlags = DDSD_CAPS | DDSD_WIDTH | DDSD_HEIGHT;
ddsd.ddsCaps.dwCaps = DDSCAPS_OFFSCREENPLAIN;
ddsd.dwWidth = xs;
ddsd.dwHeight = ys;
lpdd-CreateSurface(&ddsd, lpSource, NULL);
}
All this code does is create a DDSURFACEDESC2 structure that describes the dimensions of the surface, and tells DirectDraw that it's an off-screen surface. Then, the call to DirectDraw (in this case, DirectDraw is the lpdd pointer) just creates the surface.
所有的这些代码是为表面建立一个DDSURFACEDESC2的数据结构来记录大小尺度，并且告诉DirectDraw
那是一个离屏表面。然后，呼叫DirectDraw(在这部分，DirectDraw是lpdd的指针)真正创建这个表面
。
Bitmap Loading
位图载入
To load .bmp files we will use the standard Windows graphics library (GDI). This is best because if we're in a mode with a palette then Windows will automatically re-map the bitmap colours to the nearest in the palette. Here is the code that blits a loaded bitmap to a surface….
要载入.BMP图形文件，我们将使用标准的Windows图形库(GDI)。这个是最好的方法，因为如果我们是
在一个调色板的视频模式，那么Windows将自动将位图映射到最接近的调色板颜色。以下的代码是绘
制一个位图数据到表面……
Listing 2
代码列表 2
void DrawHBitmap(IDirectDrawSurface7 *lpSurface, HBITMAP hBitmap, int x, int y, int width, int height)
{
HDC hdcImage;
HDC hdc;
BITMAP bm;
if (lpSurface == NULL || hBitmap == NULL)
return;
lpSurface-Restore();
hdcImage = CreateCompatibleDC(NULL);
SelectObject(hdcImage, hBitmap);
GetObject(hBitmap, sizeof(bm), &bm);
width = width == 0 ? bm.bmWidth : width;
height = height == 0 ? bm.bmHeight : height;
lpSurface-GetDC(&hdc);
BitBlt(hdc, x, y, width, height, hdcImage, 0, 0, SRCCOPY);
lpSurface-ReleaseDC(hdc);
DeleteDC(hdcImage);
}
and here is the code that loads, blits, then unloads the bitmap:
以下的代码是把位图载入、绘制、到数据释放：
Listing 3
代码列表 3
void CreateBitmapSurface(LPDIRECTDRAWSURFACE7 lpSurface, char *fname, int xs, int ys)
{
HBITMAP hBitmap;
CreateSurface(&lpSurface, xs, ys);
hBitmap = LoadImage(NULL, fname, IMAGE_BITMAP, 0, 0, LR_LOADFROMFILE);
DrawHBitmap(lpSurface, hBitmap, 0, 0, xs, ys);
DeleteObject(hBitmap);
}
Quick Example
快速例程
And to round it all up, here's some example code that loads the file "test.bmp" (width = 128, height = 128) into the lpddsTest surface, and then releases it again:
围绕着以下部分，我们将结束此章节，这里是一些例程代码，它载入"test.bmp"文件(宽=128，高=12
8)到lpddTest表面中，并且将其释放：
Listing 4
代码列表 4
void Example(void)
{
/*
* Declare the surface object
* 声名表面对象
*/
LPDIRECTDRAWSURFACE7 lpddsTest;
/*
* Load the bitmap file into it
* 载入位图文件
*/
CreateBitmapSurface(lpddsTest, “test.bmp”, 128, 128);
/*
* The lpddsTest surface now contains the “test.bmp” file
* lpddsTest表面已经包含了"test.bmp"文件数据
*/
/*
* Release the surface
* 释放表面
*/
lpddsTest-Release();
}
