Tutorial2:在缓存中载入位图
这个例子讨论在ddex1的基础上进行扩展.ddex2(例程在msdn上就有,搜索...)讲包含载入位图文件的函数.新的功能靠以下的步骤实现:
step1:创建调色板
step2:设置调色板
step3:在缓存中载入位图
step4:翻转平面.
像在ddex1中一样,在初始化函数中初始化了ddex2.
不同的代码如下:
lpDDPal = DDLoadPalette(lpDD, szBackground);
if (lpDDPal == NULL)
goto error;
ddrval = lpDDSPrimary->SetPalette(lpDDPal);
if(ddrval != DD_OK)
goto error;
// Load a bitmap into the back buffer.
ddrval = DDReLoadBitmap(lpDDSBack, szBackground);
if(ddrval != DD_OK)
goto error;
Step1:建立调色板
在ddex2中,首先用如下代码建立调色板.
lpDDPal = DDLoadPalette(lpDD, szBackground);
if (lpDDPal == NULL)
goto error;
DDLoadPalette这个函数是在\Dxsdk\sdk\samples\misc\ddutil.cpp中的公共directdraw函数.很多directdraw的例子(sdk包中的)都用到这个文件.重要的是,它包含了载入调色板和位图的函数,无论是从文件还是资源.为了不重复的写代码,就把他放在了一个可以重复使用的文件中.确信你在编译ddexn是包含了这文件.
(以下内容在ddutial.cpp中)ddex2中,DDLoadPalette函数从back.bmp文件创建了DirectDrawPalette对象.DDLoadPalette函数判断创建调色板的文件或资源是否存在.如果不是的话,就创建一个默认的调色板.在ddex2中,他从位图文件提取调色板信息并储存在一个ape指向的结构中.
DDEx2随后创建了DirectDrawPalette对象,如下:
pdd->CreatePalette(DDPCAPS_8BIT, ape, &ddpal, NULL);
return ddpal;
当IDirectDraw7::CreatePalette方法返回,ddpal参数指向从DDLoadPalette函数返回的DirectDrawPalette对象.
ape参数是一个指针,指向一个能包含或者2或4或16或256个线性组织的纪录的结构.记录的数目依靠于CreatePalette方法中的dwFlags参数.在上面的情况下,dwFlags参数设为DDPCAPS_8BIT.这表示结构中有256个记录.每一条记录包含4字节(分别是红,绿,兰的通道和一个标志位).
Step2:设置调色板
创建完调色板以后,通过指针调用主平面的IDirectDrawSurface7::SetPalette方法,如下:
ddrval = lpDDSPrimary->SetPalette(lpDDPal);
if(ddrval != DD_OK)
goto error;// SetPalette failed.
在你调用完IDirectDrawSurface7::SetPalette方法之后,DirectDrawPalette对象就与DirectDrawSurface对象联系起来了.什么时候你想改变调色板了,可以简单的创建一个新的调色板,然后设置一下就可以了.(虽然这篇指导用了这些步骤,其实还有其他的方法改变调色板,以后的例子中将会演示)
Step3:在缓存区载入位图
DirectDrawPalette对象与DirectDrawSurface对象联系起来之后,DDEx2用下面的代码在缓存中载入位图back.bmp
// Load a bitmap into the back buffer.
ddrval = DDReLoadBitmap(lpDDSBack, szBackground);
if(ddrval != DD_OK)
// Load failed.
DDReLoadBitmap是另一个在Ddutil.cpp中的函数.他载入一个位图文件或资源到一个已经存在的DirectDraw平面.(你也可以使用DDLoadBitmap函数创建一个平面然后载入.函数也在ddutil.cpp中.)在ddex2中,他载入由szBackground(ID)指向的back.bmp文件到由lpDDSBack(指针)指向的后台缓存.DDReLoadBitmap函数调用DDCopyBitmap函数将文件拷贝到缓存,并拉伸到适当的大小.
DDCopyBitmap函数将位图拷贝到内存中,用GetObject函数恢复位图的大小.然后是由下面的代码将位图调整到将要放位图的缓存的大小.
// Get the size of the surface.
ddsd.dwSize = sizeof(ddsd);
ddsd.dwFlags = DDSD_HEIGHT | DDSD_WIDTH;
pdds->GetSurfaceDesc(&ddsd);
ddsd是一个DDSURFACEDESC2结构的指针.这个结构保存了现在的DirectDraw平面的描述.在这种情况下,DDSURFACEDESC2的成员描述了平面的高和宽,由DDSD_HEIIGHT和DDSD_WIDTH标示的.IDirectDrawSurface7::GetSurfaceDesc方法的调用把属性值装入了这个结构.在DDEX2中,值将被设为高480,宽640.
DDCopyBitmap函数给平面加锁然后把位图拷贝到缓存中,用StretchBlt函数拉伸或压缩.如下:
if ((hr = pdds->GetDC(&hdc)) == DD_OK)
{
StretchBlt(hdc, 0, 0, ddsd.dwWidth, ddsd.dwHeight, hdcImage, x, y,
dx, dy, SRCCOPY);
pdds->ReleaseDC(hdc);
}
Step4:翻转页面
ddex2中翻转页面的部分与ddex1中的十分的相像.所不同的是:当平面丢失时(DDERR_SURFACELOST),在平面储存后,必须用DDReLoadBitmap函数将位图重新载入缓存.
|