Metodo IDirect3DCubeTexture9::AddDirtyRect (d3d9.h)

Articolo
08/23/2023

Aggiunge un'area dirty a una risorsa trama cubo.

Sintassi

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

Parametri

[in] FaceType

Tipo: D3DCUBEMAP_FACES

Membro del D3DCUBEMAP_FACES tipo enumerato, identificando la faccia della mappa del cubo.

[in] pDirtyRect

Tipo: const RECT*

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

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 il rettangolo o la casella corrispondente (ridimensionata) sia dirty. Le aree dirty vengono registrate automaticamente quando viene chiamato IDirect3DCubeTexture9::LockRect senza D3DLOCK_NO_DIRTY_UPDATE o D3DLOCK_READONLY. Anche la superficie di destinazione di IDirect3DDevice9::UpdateSurface viene contrassegnata automaticamente come dirty.

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