Método IDirect3DCubeTexture9::AddDirtyRect (d3d9helper.h)

Artigo
08/23/2023

Adiciona uma região sujo a um recurso de textura de cubo.

Sintaxe

HRESULT AddDirtyRect(
  [in] D3DCUBEMAP_FACES FaceType,
  [in] const RECT       *pDirtyRect
);

Parâmetros

[in] FaceType

Tipo: D3DCUBEMAP_FACES

Membro do D3DCUBEMAP_FACES tipo enumerado, identificando a face do mapa do cubo.

[in] pDirtyRect

Tipo: const RECT*

Ponteiro para uma estrutura RECT, especificando o sujo região. Especificar NULL expande o sujo região para cobrir toda a textura do cubo.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado poderá ser: D3DERR_INVALIDCALL.

Comentários

Por motivos de desempenho, sujo regiões são registradas apenas para o nível zero de uma textura. Para subnível, supõe-se que o retângulo ou caixa correspondente (dimensionado) também seja sujo. Regiões sujas são registradas automaticamente quando IDirect3DCubeTexture9::LockRect é chamado sem D3DLOCK_NO_DIRTY_UPDATE ou D3DLOCK_READONLY. A superfície de destino de IDirect3DDevice9::UpdateSurface também é marcada sujo automaticamente.

Usar D3DLOCK_NO_DIRTY_UPDATE e especificar explicitamente sujo regiões pode ser usado para aumentar a eficiência de IDirect3DDevice9::UpdateTexture. Usando esse método, os aplicativos podem otimizar qual subconjunto de um recurso é copiado especificando sujo regiões no recurso. No entanto, as regiões de sujo podem ser expandidas para otimizar o alinhamento.