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

Artículo
08/23/2023

Agrega una región desfasada a un recurso de textura de cubo.

Sintaxis

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

Parámetros

[in] FaceType

Tipo: D3DCUBEMAP_FACES

Miembro del tipo enumerado D3DCUBEMAP_FACES , identificando la cara del mapa del cubo.

[in] pDirtyRect

Tipo: const RECT*

Puntero a una estructura RECT , especificando la región desfasada. Al especificar NULL , se expande la región desfasada para cubrir toda la textura del cubo.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto puede ser: D3DERR_INVALIDCALL.

Comentarios

Por motivos de rendimiento, las regiones desfasadas solo se registran en el nivel cero de una textura. En el caso de los subniveles, se supone que el rectángulo o el cuadro correspondientes también están sucios. Las regiones desfasadas se registran automáticamente cuando se llama a IDirect3DCubeTexture9::LockRect sin D3DLOCK_NO_DIRTY_UPDATE ni D3DLOCK_READONLY. La superficie de destino de IDirect3DDevice9::UpdateSurface también se marca automáticamente.

Se puede usar D3DLOCK_NO_DIRTY_UPDATE y especificar explícitamente regiones desfasadas para aumentar la eficacia de IDirect3DDevice9::UpdateTexture. Con este método, las aplicaciones pueden optimizar qué subconjunto de un recurso se copia especificando regiones desfasadas en el recurso. Sin embargo, las regiones desfasadas se pueden expandir para optimizar la alineación.