12.屏蔽缓冲区

12.

屏蔽缓冲区

屏蔽是一项我们尚未讨论过的高阶绘制功能，这是一项在发展商业应用程序时很有用的技

术。如果想让您的

3D

程序与众不同，最好能结合屏蔽以及前面 学到的贴图技术。本章会详

述如何运用屏蔽，并且展示能用它产生的不同类型效果。

市面上很多

3D

游戏和模拟都用电影级的特效添加戏剧性的冲击。您可以用屏蔽缓冲区来建

立像合成、印 花（

decal

）、溶入、淡出淡入（

fade

）、边框、剪影（

silhouette

）、刷抹

（

swipe

）以 及阴影等效果。屏蔽缓冲区能决定会绘制影像中的哪些像素。屏蔽缓冲区能让

您针对各像 素开启或关闭对绘制目的绘图页来达成这些功能。这表示您的软件可以「遮住」

部份的影 像让它不要显示。

当屏蔽功能启动时，

Microsoft Direct3D< /p>

会对要写入绘制目的绘图页的每个像素进行屏蔽测

试。屏蔽测试会 用一个屏蔽参考值、一个屏蔽板（

stencil mask

） 、一个比较函式、以及一

个取自屏蔽缓冲区的像素值（对应于目的绘图页中的现行像素） 。下面是这个测试中所作的

步骤：

1.

用

屏蔽板对屏蔽参考值作位

AND

运算。

2.

用

屏蔽板针对现行像素的屏蔽缓 冲区值作位

AND

运算。

3.

用

比较函式比较步骤

和步骤

2

的结果。

控制比较函式、屏蔽板、屏蔽参考值、以及屏蔽测试通过或失败时 的动作，就可以控制屏蔽

缓冲区的运作。当测试成功时，现行像素会被写入目标。预设比 较动作（

D3DCMPFUNC

列举类型所定义的

D3DCMP_ALWAYS

）不会管屏蔽缓冲区的内容而直接写入像素。您 可

以设定

D3DRENDERSTATE_STENCILFU NC

绘制状态并转入任一个

D3DCMPFUNC

成员

值来改用任何所要的函式。

建立一个屏蔽缓冲区

在建立屏蔽缓冲区之前必须决定目标系统所支持的屏蔽功能。 方法是呼叫

IDirect3DDevice7::GetCaps

方法。

dwStencilCaps

旗标表示装置所支持的 屏蔽缓冲区运

算。回报的旗标对全部三种屏蔽缓冲区运算都有效：

D3DRENDERSTATE_STENCILFAIL

、

D3DRENDERSTATE_STENCILPASS

以及

D3DRENDERSTATE_STENCILZFAIL

。

Direct3D

定义了下列的

dwStencilCaps< /p>

旗标：

?

D3DSTENCILCAPS_DECR

表示有支持

D3DSTENCILOP_DECR

运算

?

D3DSTENCILCAPS_DECRSAT

表示有支持

D3DSTENCILOP_DECRSAT

运算

?

D3DSTENCILCAPS_INCR

表示有支持

D3DSTENCILOP_INCR

运算

?

D3DSTENCILCAPS_INCRSAT

表示有支持

D3DSTENCILOP_INCRSAT

运算

?

D3DSTENCILCAPS_INVERT

表示有支持

D3DSTENCILOP_INVERT

运算

?

D3DSTENCILCAPS_KEEP

表示有支持

D3D STENCILOP_KEEP

运算

?

D3DSTENCILCAPS_REPLACE

表示有支持

D3DSTENCILOP_REPLACE

运算

?

D3DSTENCILCAPS_ZERO

表示有支持

D3DSTENCILOP_ZERO

运算

< /p>

Direct3D

会用深度缓冲区数据来纪录屏蔽缓冲区信息。要 找出目标系统的硬件支持哪些深

度缓冲区及屏蔽缓冲区格式，可以呼叫

< br>IDirect3D7::EnumZBufferFormats

方法，宣告如

下：

HRESULT IDirect3D7::EnumZBufferFormats (

);

参数

riidDevice

lpEnumCallback

LpContext

说明

指向一个代表所要列举深度缓冲 区格式的全域唯一辨别码（

GUID

）的参照

< br>

指向

D3DenumPixelFormatsCal lback

函式的地址，

Direct3D

< br>会对每个支持的深

度缓冲区格式呼叫这个函式。

由应用程序所定义并传入回传函式的数据

REFCLSID riidDevice,

LPD3DENUMPIXELFORMATSCALLBACK lpEnumCallback,

LPVOID lpContext

如果这个方法成功就会传回

D3D_OK

。如果失败 就会传回以下四个值之一：

?

DDERR_INVALIDOBJECT

?

DDERR_INVALIDPARAMS

?

DDERR_NOZBUFFERHW

?

DDERR_OUTOFMEMORY

下列程序会找出系统提供哪些屏蔽缓冲区以及支持哪些运算， 然后建立一个屏蔽缓冲区。您

可以看到，这段程序代码注明屏蔽缓冲区支持是否大于

1

位。如果只支持

1

位屏蔽缓冲

区，某些屏蔽技术就得用不同的方法处理。

HRESULT CMyD3DApplication::CreateStencilBuffer()

{

{

}

else

{

//

最好使用上下限为

0/max

的

sat

运算，不过如果屏蔽位足够的话可

以用其它运算。

g_StencIncOp=(dwStencilCaps &D3DSTENCILCAPS_INCRSAT)?

}

m_ pddsRenderTarget->DeleteAttachedSurface(0,NULL); < /p>

//

由绘制目标取得

z

< br>缓冲区大小。

//

建立

z

缓冲区的绘图页描述。

DDSURFACEDESC2 ddsd;

D3DUtil_InitSurfaceDesc(ddsd);

D3DSTENCILOP_INCRSAT:D3DSTENCILOP_INCR;

D3DSTENCILOP_DECRSAT:D3DSTENCILOP_DECR;

g_StencDecOp=(dwStencilCaps &D3DSTENCILCAPS_DECRSAT)?

//

必须用

1

位屏蔽缓冲区。

g_bCanOnlyDoOneBitStencil=TRUE;

g_bCanOnlyDoOneBitStencil=FALSE;

DWORD dwStencilCaps =m_pDeviceInfo-

if((!(dwStencilCaps &D3DSTENCILCAPS_INCR)&&

!(dwStencilCaps &D3DSTENCILCAPS_INCRSAT))||

(!(dwStencilCaps &D3DSTENCILCAPS_DECR)&&

!(dwStencilCaps &D3DSTENCILCAPS_DECRSAT)))

>cilCaps;

m_pddsRenderTarget ->GetSurfaceDesc(&ddsd);

s =DDSD_WIDTH|DDSD_HEIGHT|DDSD_CAPS|

DDSD_PIXELFORMAT;

=DDSCAPS_ZBUFFER;

2 =0;

3 =0;

4 =0;

s =DDPF_ZBUFFER|DDPF_STENCILBUFFER;

if(m_pDeviceInfo->bHardware)

else

//

由格式列举动作取得适合的像素 格式。

m_pD3D->EnumZBufferForma ts((*m_pDeviceInfo->pDeviceGUID),

EnumZBufferFormatsCallback,

(VOID*)&xelFormat);

assert(cilBitDepth!=0);

g_bC anOnlyDoOneBitStencil=g_bCanOnlyDoOneBitStencil||

g_dwMaxStencilValue=(1<

//

建立并连接

z

缓冲区。

if(FAILED(m_pDD->Create Surface(&ddsd,&m_pddsDepthBuffer,

NULL)))

return E_FAIL;

if( FAILED(m_pddsRenderTarget->AddAttachedSurface(

return E_FAIL;

SetMenuStates();

//

在窗口大小改变的时候保持

g_bUseOneBitStencil

为被设定。

if(!g_bUseOneBitStencil)

g_bUseOneBitStencil=g_bCanOnlyDoOneBitSte ncil;

((1<

|=DDSCAPS_SYSTEMMEMORY;

|=DDSCAPS_VIDEOMEMORY;

构。

}

//

必须呼叫

SetRenderTarget()

来重建新连接

z

缓冲区所用的内部结

return m_pd3dDevice->S etRenderTarget(m_pddsRenderTarget,0L);

//------------------------------------------------ ----------------

---

//

名称：

EnumZBufferFormatsCallback