Compartilhar via

Técnicas de buffer de estêncil (Direct3D 9)

  • Artigo

Os aplicativos usam o buffer de estêncil para mascarar pixels em uma imagem. A máscara controla se o pixel é desenhado ou não. Alguns dos efeitos mais comuns são mostrados abaixo.

O buffer de estêncil habilita ou desabilita o desenho para a superfície de destino de renderização em uma base pixel a pixel. Em seu nível mais fundamental, ele permite que os aplicativos mascaram seções da imagem renderizada para que elas não sejam exibidas. Os aplicativos geralmente usam buffers de estêncil para efeitos especiais, como dissolveções, decalque e estrutura de tópicos.

As informações do buffer de estêncil são inseridas nos dados do buffer z. Seu aplicativo pode usar o métodoIDirect3D9::CheckDeviceFormat para verificar se há suporte ao estêncil de hardware, conforme mostrado no exemplo de código a seguir.

// Reject devices that cannot perform 8-bit stencil buffering. 
// The following example assumes that pCaps is a valid pointer 
// to an initialized D3DCAPS9 structure. 

if( FAILED( m_pD3D->CheckDeviceFormat( pCaps->AdapterOrdinal,
                                       pCaps->DeviceType,  
                                       Format,  
                                       D3DUSAGE_DEPTHSTENCIL, 
                                       D3DRTYPE_SURFACE,
                                       D3DFMT_D24S8 ) ) )
return E_FAIL;

IDirect3D9::CheckDeviceFormat permite que você escolha um dispositivo para criar com base nos recursos desse dispositivo. Nesse caso, os dispositivos que não dão suporte a buffers de estêncil de 8 bits são rejeitados. Observe que este é apenas um uso possível para IDirect3D9::CheckDeviceFormat; para obter detalhes, consulte Determining Hardware Support (Direct3D 9).

Como funciona o buffer de estêncil

O Direct3D executa um teste no conteúdo do buffer de estêncil em uma base pixel a pixel. Para cada pixel na superfície de destino, ele executa um teste usando o valor correspondente no buffer de estêncil, um valor de referência de estêncil e um valor de máscara de estêncil. Se o teste for aprovado, o Direct3D executará uma ação. O teste é executado usando as etapas a seguir.

  1. Execute uma operação AND bit a bit do valor de referência do estêncil com a máscara de estêncil.
  2. Execute uma operação AND bit a bit do valor do buffer de estêncil para o pixel atual com a máscara de estêncil.
  3. Compare o resultado da etapa 1 com o resultado da etapa 2, usando a função de comparação.

Essas etapas são mostradas no exemplo de código a seguir.

(StencilRef & StencilMask) CompFunc (StencilBufferValue & StencilMask)

StencilBufferValue

é o conteúdo do buffer de estêncil para o pixel atual. Este exemplo de código usa o símbolo de e comercial (&) para representar a operação AND bit a bit.

StencilMask

representa o valor da máscara de estêncil e

StencilRef

representa o valor de referência de estêncil.

CompFunc

é a função de comparação.

O pixel atual é gravado na superfície de destino se o teste de estêncil for aprovado e ignorado de outra forma. O comportamento de comparação padrão é gravar o pixel, independentemente de cada operação bit a bit (D3DCMP_ALWAYS). Você pode alterar esse comportamento alterando o valor do estado de renderização D3DRS_STENCILFUNC, passando um membro da D3DCMPFUNC tipo enumerado para identificar a função de comparação desejada.

Seu aplicativo pode personalizar a operação do buffer de estêncil. Ele pode definir a função de comparação, a máscara de estêncil e o valor de referência do estêncil. Ele também pode controlar a ação que o Direct3D executa quando o teste de estêncil é aprovado ou falha. Para obter mais informações, consulte estado do buffer de estêncil (Direct3D 9).

Exemplos

Os exemplos de código a seguir demonstram a configuração do buffer de estêncil.

// Enable stencil testing
pDevice->SetRenderState(D3DRS_STENCILENABLE, TRUE);

// Specify the stencil comparison function
pDevice->SetRenderState(D3DRS_STENCILFUNC, D3DCMP_EQUAL);

// Set the comparison reference value
pDevice->SetRenderState(D3DRS_STENCILREF, 0);

//  Specify a stencil mask 
pDevice->SetRenderState(D3DRS_STENCILMASK, 0);

Por padrão, o valor de referência do estêncil é zero. Qualquer valor inteiro é válido. O Direct3D executa um AND bit a bit do valor de referência do estêncil e um valor de máscara de estêncil antes do teste de estêncil.

Você pode controlar quais informações de pixel são gravadas dependendo da comparação de estêncil.

// A write mask controls what is written
pDevice->SetRenderState(D3DRS_STENCILWRITEMASK, D3DSTENCILOP_KEEP);
// Specify when to write stencil data
pDevice->SetRenderState(D3DRS_STENCILFAIL, D3DSTENCILOP_KEEP);

Você pode escrever sua própria fórmula para o valor desejado gravado no buffer de estêncil, conforme mostrado no exemplo a seguir.

NewStencilBufferValue = (StencilBufferValue & ~StencilWriteMask) | 
                        (StencilWriteMask & StencilOp(StencilBufferValue))

do Pipeline do Pixel