Metodo IDirect3DCubeTexture9::AddDirtyRect (d3d9helper.h)

Articolo
08/23/2023

Aggiunge un'area sporca a una risorsa trama cubo.

Sintassi

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

Parametri

[in] FaceType

Tipo: D3DCUBEMAP_FACES

Membro del tipo enumerato D3DCUBEMAP_FACES , identificando il viso della mappa del cubo.

[in] pDirtyRect

Tipo: const RECT*

Puntatore a una struttura RECT , specificando l'area sporca. Se si specifica NULL , l'area sporca viene espansa per coprire l'intera trama del cubo.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere: D3DERR_INVALIDCALL.

Commenti

Per motivi di prestazioni, le aree sporche vengono registrate solo per il livello zero di una trama. Per i sublevel, si presuppone che il rettangolo o la casella corrispondente (ridimensionato) sia anche sporco. Le aree sporche vengono registrate automaticamente quando viene chiamato IDirect3DCubeTexture9::LockRect senza D3DLOCK_NO_DIRTY_UPDATE o D3DLOCK_READONLY. La superficie di destinazione di IDirect3DDevice9::UpdateSurface è contrassegnata automaticamente.

È possibile usare D3DLOCK_NO_DIRTY_UPDATE e specificare in modo esplicito le aree sporche per aumentare l'efficienza di IDirect3DDevice9::UpdateTexture. Usando questo metodo, le applicazioni possono ottimizzare il subset di una risorsa copiata specificando aree sporche nella risorsa. Tuttavia, le aree sporche possono essere espanse per ottimizzare l'allineamento.