ID3D11DeviceContext1 ::ClearView, méthode (d3d11_1.h)

Article
08/22/2023

Définit tous les éléments d’une vue de ressources sur une seule valeur.

Syntaxe

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

Paramètres

[in] pView

Pointeur vers l’interface ID3D11View qui représente l’affichage des ressources à effacer.

[in] Color

Tableau à 4 composants qui représente la couleur à utiliser pour effacer l’affichage des ressources.

[in, optional] pRect

Tableau de structures D3D11_RECT pour les rectangles de l’affichage des ressources à effacer. Si la valeur est NULL, ClearView efface toute la surface.

NumRects

Nombre de rectangles dans le tableau spécifié par le paramètre pRect .

Valeur de retour

None

Remarques

ClearView fonctionne uniquement sur les vues cibles de rendu (RTV), les vues de profondeur/gabarit (DSV) sur les ressources en profondeur uniquement (ressources sans composant de gabarit), les vues d’accès non ordonné (UAV) ou toute vue vidéo d’une surface Texture2D . Le runtime supprime les appels non valides. Les rectangles vides dans le tableau pRect ne sont pas op. Un rectangle est vide si la valeur supérieure est égale à la valeur inférieure ou si la valeur de gauche est égale à la valeur droite.

ClearView ne prend pas en charge les textures 3D.

ClearView applique la même valeur de couleur à toutes les tranches de tableau d’une vue ; tous les rectangles du tableau pRect correspondent à chaque tranche de tableau. Le tableau pRect de rectangles est un ensemble de zones à effacer sur une surface unique. Si la vue est un tableau, ClearView efface tous les rectangles de chaque tranche de tableau individuellement.

Lorsque vous appliquez des rectangles à des mémoires tampons, définissez la valeur supérieure sur 0 et la valeur inférieure sur 1 et définissez la valeur gauche et la valeur de droite pour décrire l’étendue dans la mémoire tampon. Lorsque la valeur supérieure est égale à la valeur inférieure ou la valeur de gauche est égale à la valeur de droite, le rectangle est vide et un no-op est obtenu.

Le pilote convertit et serre les valeurs de couleur au format de destination selon les règles de conversion Direct3D. Par exemple, si le format de la vue est DXGI_FORMAT_R8G8B8A8_UNORM, le pilote serre les entrées de 0,0f à 1.0f (+INF -> 1.0f (0XFF)/NaN -> 0.0f).

Si le format est entier, par exemple DXGI_FORMAT_R8G8B8A8_UINT, le runtime interprète les entrées comme des floats intégraux. Par conséquent, 235.0f correspond à 235 (arrondit à zéro, les valeurs hors plage/INF se serrent à la plage cible et NaN à 0).

Voici les mappages de couleurs :

Couleur[0] : R (ou Y pour la vidéo)
Couleur[1] : G (ou U/Cb pour la vidéo)
Couleur[2] : B (ou V/Cr pour la vidéo)
Couleur[3] : A

Pour les vues vidéo avec des formats YUV ou YCbBr, ClearView ne convertit pas les valeurs de couleur. Dans les situations où le nom de format n’indique pas _UNORM, _UINT, etc., ClearView suppose _UINT. Par conséquent, 235.0f correspond à 235 (arrondit à zéro, les valeurs hors plage/INF se serrent à la plage cible et NaN à 0).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 et mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	d3d11_1.h
Bibliothèque	D3D11.lib

Voir aussi

ID3D11DeviceContext1