iniwf

ddex1        ddex2        ddex3
tutorial3:从一个离屏表面(off-screen surface)的块移动(blt)

在ddex2中,把一张位图放到了后台缓存中,然后在缓存与主平面间翻啊翻...其实这不是显示位图的一般行为.在这一篇中(例子是ddex3)将要通过包含两个离屏表面来扩展ddex2的能力.两个位图-一个是第偶数次显示的,一个是奇数次显示-存放在这两个离屏表面.例子中,用IDirectDrawSurface7::BltFast方法把离屏表面的内容拷贝到后台缓存中去,然后翻转,然后再把下一个离屏表面拷到缓存...
(译者注:这一篇只是演示离屏表面和blit的方法,实际上,离屏表面使用的时候大部分是用来存放精灵,实现动画的.存放的都是小的图片,是一个特殊的平面)
ddex3新的函数以下面3个步骤演示:
step1:建立离屏表面
step2:载入位图到离屏表面
step3:块移动(blit)离屏表面到后台缓冲

step1:建立离屏表面
下面的代码是加入到doInit函数中创建两个离屏表面.

// Create an off-screen bitmap.
ddsd.dwFlags = DDSD_CAPS | DDSD_HEIGHT | DDSD_WIDTH;
ddsd.ddsCaps.dwCaps = DDSCAPS_OFFSCREENPLAIN;
ddsd.dwHeight = 480;
ddsd.dwWidth = 640;
ddrval = lpDD->CreateSurface(&ddsd, &lpDDSOne, NULL);
if(ddrval != DD_OK)
{
    return initFail(hwnd);
}
 
// Create another off-screen bitmap.
ddrval = lpDD->CreateSurface(&ddsd, &lpDDSTwo, NULL);
if(ddrval != DD_OK)
{
    return initFail(hwnd);
}

dwFlags成员定义了程序将使用DDSCAPS结构,并且将要设置离屏表面的高和宽.这个表面因为标示了DDSCAPS_OFFSCREEN在DDSCAPS结构中,所以将会是一个完全的离屏的缓存.高和宽分别设为480 和640.随后,表面经过IDirectDraw7::CreateSurface方法创建.
因为两个离屏表面大小相同,就又不同的指针调用了IDirectDraw7::CreateSurface又一次,创建了另一个.
你可以通过在DDSCAPS结构中定义DDSCAPS_SYSTEMMEMORY或DDSCAPS_VIDEOMEMORY来决定将离屏表面放在系统内存还是显存中.放在显存中,你可以加快离屏表面到后台缓存的移动速度.将用到位图的动画的时候,这将十分的重要.但是,如果你使用DDSCAPS_VIDEOMEMORY并且没有足够的显存区存放那个位图了,当你试图创建这个表面的时候,将会返回一个DDERR_OUTOFVIDEOMEMORY错误.

step2:载入位图到离屏表面
当两个离屏表面创建好后,DDEx3用InitSurface函数将frntback.bmp文件的位图装入到表面中.InitSurface函数用到了ddutil.cpp文件中的DDCopyBitmap函数去装载位图.如下:

// Load the bitmap resource.
hbm = (HBITMAP)LoadImage(GetModuleHandle(NULL), szBitmap,
    IMAGE_BITMAP, 0, 0, LR_CREATEDIBSECTION);
 
if (hbm == NULL)
    return FALSE;
 
DDCopyBitmap(lpDDSOne, hbm, 0, 0,   640, 480);
DDCopyBitmap(lpDDSTwo, hbm, 0, 480, 640, 480);
DeleteObject(hbm);
 
return TRUE;

如果你用看图或画图的软件看过frntback.bmp文件了,你就知道,这个文件包括两个图,一个在另一个的上面.DDCopyBitmap函数把这个位图从分界的地方分成两部分.一个装入到第一个离屏表面(lpDDSOne),另一个在第二个离屏表面(lpDDSTwo).

step3:块移动(blit)离屏表面到后台缓冲
WM_TIMER消息触发的代码包括写入表面和翻转表面.在DDEx3中,他包含了下面的代码去选择适当的离屏表面,然后把他块移动(blit)到后台缓存.

rcRect.left = 0;
rcRect.top = 0;
rcRect.right = 640;
rcRect.bottom = 480;
if(phase)
{
    pdds = lpDDSTwo;
    phase = 0;
}
else
{
    pdds = lpDDSOne;
    phase = 1;
}
while(1)
{
    ddrval = lpDDSBack->BltFast(0, 0, pdds, &rcRect, FALSE);
    if(ddrval == DD_OK)
    {
        break;
    }
}

phase变量决定了到底是哪一个离屏表面将被移动到后台缓存.IDirectDrawSurface7::BltFast方法的调用是用来把所选的离屏表面块移动到后台缓存的.在(0,0)处开始,左上角.reRect参数指向一个RECT结构,他定义了移动出来的离屏表面的左上和右下角.最后的一个参数设为FALSE(0),标示没有使用特殊的传输标示符.
根据你的程序的需要,你可以使用IDirectDrawSurface7::Blt 或者IDirectDrawSurface7::BltFast 方法实现块移动.如果你的离屏表面在显存中,你最好使用IDirectDrawSurface7::BltFast 方法.这样做,如果你使用的是硬件块移动支持的系统,你不会获得更快的速度,但是,如果使用的硬件模仿的块移动,你将会少用10%的时间.所以,你应该使用IDirectDrawSurface7::BltFast方法去做所有的在显存中的块移动.如果你从系统内存中移动,或者需要特别的硬件标志,那就只好使用IDirectDrawSurface7::Blt了.
当完成的从离屏表面到后台缓存的块移动,后台缓存就和主平面之间像前面几篇一样不停的翻啊翻....