Metodo IDirect3DVolumeTexture9::AddDirtyBox (d3d9helper.h)

Articolo
08/23/2023

Aggiunge un'area dirty a una risorsa trama del volume.

Sintassi

HRESULT AddDirtyBox(
  [in] const D3DBOX *pDirtyBox
);

Parametri

[in] pDirtyBox

Tipo: const D3DBOX*

Puntatore a una struttura D3DBOX , specificando l'area dirty da aggiungere. Se si specifica NULL , l'area dirty viene espansa per coprire l'intera trama del volume.

Valore restituito

Tipo: HRESULT

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

Commenti

Per motivi di prestazioni, le aree dirty vengono registrate solo per il livello zero di una trama. Per i sublevel, si presuppone che anche la casella corrispondente (ridimensionata) sia dirty. Le aree dirty vengono registrate automaticamente quando LockBox viene chiamato senza D3DLOCK_NO_DIRTY_UPDATE o D3DLOCK_READONLY.

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

Requisiti


Piattaforma di destinazione	Windows
Intestazione	d3d9helper.h (include D3D9.h)
Libreria	D3D9.lib

Vedi anche

IDirect3DVolumeTexture9

Condividi tramite