ID3D11DeviceContext ::ClearRenderTargetView, méthode (d3d11.h)

  • Article

Définissez tous les éléments d’une cible de rendu sur une seule valeur.

Syntaxe

void ClearRenderTargetView(
  [in] ID3D11RenderTargetView *pRenderTargetView,
  [in] const FLOAT [4]        ColorRGBA
);

Paramètres

[in] pRenderTargetView

Type : ID3D11RenderTargetView*

Pointeur vers la cible de rendu.

[in] ColorRGBA

Type : const FLOAT[4]

Tableau à 4 composants qui représente la couleur avec laquelle remplir la cible de rendu.

Valeur de retour

None

Remarques

Les applications qui souhaitent effacer une cible de rendu vers un modèle de bits de valeur entière spécifique doivent afficher un quad aligné sur l’écran au lieu d’utiliser cette méthode. La raison en est que cette méthode accepte comme entrée une valeur à virgule flottante, qui peut ne pas avoir le même modèle de bits que l’entier d’origine.

Différences entre Direct3D 9 et Direct3D 11/10 :

Contrairement à Direct3D 9, l’étendue complète de l’affichage des ressources est toujours effacée. Les paramètres de fenêtre d’affichage et de ciseau ne sont pas appliqués.
 

Lorsque vous utilisez D3D_FEATURE_LEVEL_9_x, ClearRenderTargetView efface uniquement la première tranche de tableau dans la vue cible de rendu. Cela peut avoir un impact (par exemple) sur les scénarios de rendu de carte de cube. Les applications doivent créer une vue cible de rendu pour chaque face ou tranche de tableau, puis effacer chaque vue individuellement.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête d3d11.h
Bibliothèque D3D11.lib

Voir aussi

ID3D11DeviceContext