Metodo ID3D11DeviceContext1::ClearView (d3d11_1.h)

Articolo
02/26/2024

Imposta tutti gli elementi in una visualizzazione risorse su un valore.

Sintassi

void ClearView(
  [in]           ID3D11View       *pView,
  [in]           const FLOAT [4]  Color,
  [in, optional] const D3D11_RECT *pRect,
                 UINT             NumRects
);

Parametri

[in] pView

Puntatore all'interfaccia ID3D11View che rappresenta la visualizzazione delle risorse da cancellare.

[in] Color

Matrice a 4 componenti che rappresenta il colore da usare per cancellare la visualizzazione delle risorse.

[in, optional] pRect

Matrice di strutture D3D11_RECT per i rettangoli nella visualizzazione risorse da cancellare. Se NULL, ClearView cancella l'intera superficie.

NumRects

Numero di rettangoli nella matrice specificati dal parametro pRect .

Valore restituito

nessuno

Osservazioni

ClearView funziona solo sulle visualizzazioni di destinazione di rendering (RTV), sulle visualizzazioni depth/stencil (DSV) su risorse di sola profondità (risorse senza componente stencil), visualizzazioni ad accesso non ordinato (UAV) o qualsiasi visualizzazione video di una superficie Texture2D . Il runtime elimina le chiamate non valide. I rettangoli vuoti nella matrice pRect sono senza operazioni. Un rettangolo è vuoto se il valore superiore è uguale al valore inferiore o il valore sinistro è uguale al valore destro.

ClearView non supporta trame 3D.

ClearView applica lo stesso valore di colore a tutte le sezioni di matrice in una visualizzazione; tutti i rettangoli nella matrice pRect corrispondono a ogni sezione della matrice. La matrice pRect di rettangoli è un set di aree da cancellare su una singola superficie. Se la visualizzazione è una matrice, ClearView cancella singolarmente tutti i rettangoli in ogni sezione di matrice.

Quando si applicano rettangoli ai buffer, impostare il valore superiore su 0 e il valore inferiore su 1 e impostare il valore sinistro e destro per descrivere l'extent all'interno del buffer. Quando il valore superiore è uguale al valore inferiore o al valore sinistro è uguale al valore destro, il rettangolo è vuoto e viene ottenuto un no-op.

Il driver converte e blocca i valori di colore nel formato di destinazione in base alle regole di conversione Direct3D appropriate. Ad esempio, se il formato della visualizzazione è DXGI_FORMAT_R8G8B8A8_UNORM, il driver blocca gli input da 0,0f a 1,0f (+INF -> 1,0f (0XFF)/NaN -> 0,0f).

Se il formato è integer, ad esempio DXGI_FORMAT_R8G8B8A8_UINT, il runtime interpreta gli input come valori float integrali. Pertanto, 235,0f è mappato a 235 (arrotonda a zero, valori fuori intervallo/INF bloccati per l'intervallo di destinazione e NaN a 0).

Ecco i mapping dei colori:

Colore[0]: R (o Y per il video)
Colore[1]: G (o U/Cb per il video)
Colore[2]: B (o V/Cr per il video)
Colore[3]: A

Per le visualizzazioni video con formati YUV o YCbBr, ClearView non converte i valori di colore. Nelle situazioni in cui il nome del formato non indica _UNORM, _UINT e così via, ClearView presuppone _UINT. Pertanto, 235,0f è mappato a 235 (arrotonda a zero, valori fuori intervallo/INF bloccati per l'intervallo di destinazione e NaN a 0).

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 e aggiornamento della piattaforma per Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 e aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	d3d11_1.h
Libreria	D3D11.lib

Vedi anche

ID3D11DeviceContext1

Condividi tramite