Débogage Graphics DirectX

Visual Studio peut vous aider à déboguer les erreurs graphiques dans votre jeu ou application DirectX. Grâce aux outils Graphics Diagnostics, vous pouvez identifier des erreurs de rendu spécifiques et examiner de façon ciblée les facteurs susceptibles de contribuer à leur survenue.

Dans cette section

• Vue d'ensemble de Graphics Diagnostics
  Présente le flux de travail et les outils de Graphics Diagnostics.

• Capture d'informations Graphics
  Pour examiner un problème de rendu dans votre application à l'aide de Graphics Diagnostics, vous devez d'abord enregistrer des informations indiquant comment l'application utilise DirectX. Au cours de la session d'enregistrement, pendant l'exécution normale de l'application, vous capturez (ou sélectionnez) les frames qui vous intéressent. Les captures contiennent des informations détaillées sur le rendu des frames. Vous pouvez enregistrer les informations capturées sous forme de document journal de graphisme pour l'examiner ultérieurement ou le partager avec d'autres membres de votre équipe.

• Document de journal Graphics
  Pour débuter l'examen d'un journal de graphisme enregistré, vous devez utiliser la fenêtre du document journal de graphisme pour sélectionner un frame capturé (voire un pixel spécifique) et ainsi examiner en détail les événements (c'est-à-dire, les appels d'API DirectX) qui l'affectent.

• Analyse des frames graphiques
  Une fois le frame sélectionné, utilisez l'analyse des frames graphiques pour examiner et ajuster vos performances de rendu.

• Liste des événements Graphics
  Après avoir sélectionné un frame, utilisez la Liste des événements Graphics pour examiner les événements associés et déterminer s'ils sont liés au problème de rendu.

• Étapes de canalisation Graphics
  Dans la fenêtre Étapes de canalisation Graphics, cherchez à déterminer comment l'événement sélectionné est traité par chaque étape de canalisation Graphics pour voir à quel moment le problème de rendu s'est manifesté. L'examen des étapes de canalisation est particulièrement utile quand un objet ne s'affiche pas en raison d'une transformation incorrecte ou quand une des étapes génère une sortie qui ne correspond pas à ce qu'attend l'étape suivante.

• Pile des appels des événements Graphics
  Utilisez la Pile des appels des événements Graphics pour examiner la pile des appels de l'événement sélectionné et accéder au code d'application lié au problème de rendu.

• Historique des pixels Graphics
  En utilisant la fenêtre Historique des pixels Graphics pour déterminer dans quelle mesure le pixel sélectionné est affecté par les événements qui l'ont influencé, vous pouvez identifier l'événement ou la combinaison d'événements qui provoquent certains types de problèmes de rendu. L'historique des pixels est particulièrement utile en cas de rendu incorrect d'un objet du fait d'une sortie du nuanceur de pixels incorrecte ou mal combinée avec le tampon de trame ou encore quand un objet ne s'affiche même pas si, par exemple, ses pixels ont été ignorés avant d'atteindre le tampon de trame.

• Table des objets Graphics
  Utilisez la Table des objets Graphics pour examiner les propriétés et le contenu d'objets et de ressources Direct3D spécifiques qui sont utilisés dans le cadre de l'événement sélectionné. La table des objets peut vous aider à déterminer le contexte du périphérique graphique actif au cours d'un événement et à examiner le contenu de ressources graphiques telles que les mémoires tampons constantes, les mémoires tampons de vertex et les textures.

• HLSL, débogueur
  Pour examiner le comportement du code de nuanceur pour l'événement et l'étape de canalisation Graphics sélectionnés, utilisez le Débogueur HLSL pour parcourir le code, examiner le contenu des variables et effectuer d'autres tâches classiques de débogage. Vous pouvez aussi utiliser le débogueur HLSL pour examiner le code de nuanceur de calcul, que les résultats subissent un traitement supplémentaire de la canalisation Graphics ou qu'ils soient seulement relus par votre application.

• Outil en ligne de commande de capture
  Utilisez l'outil en ligne de commande de capture pour capturer et lire rapidement des informations graphiques sans passer par Visual Studio ou une capture par programmation. En particulier, vous pouvez utiliser l'outil en ligne de commande pour l'automatisation ou dans un environnement de test.

• Exemples Graphics Diagnostics
  Plusieurs exemples montrent comment utiliser conjointement les outils Graphics Diagnostics pour diagnostiquer différents types de problèmes de rendu.

Rubriques connexes

Titre	Description
Débogage dans Visual Studio	Présente la fonctionnalité de débogage de Visual Studio.
Graphiques et jeux DirectX	Fournit des articles ayant trait aux technologies graphiques DirectX.