Graphics Diagnostics

Ce document décrit les outils Graphics Diagnostics Visual Studio, que vous pouvez utiliser pour diagnostiquer les problèmes de rendu courants dans des applications graphiques DirectX.Graphics Diagnostics prend en charge Direct3D 10, Direct3D 10.1, Direct3D 11 et Direct3D 11.1, et fournit une prise en charge limitée pour Direct2D.Il ne prend pas en charge les versions antérieures de Direct3D, DirectDraw ou d'autres API graphiques.

Vous pouvez utiliser Graphics Diagnostics pour :

• Capturez des frames rendus pour une révision ultérieure.

• Recherchez et sélectionnez les frames capturés pour une inspection et une analyse détaillées.

• Affichez les événements Direct3D qui se sont produits pendant un frame, et leurs effets sur l'application.

• Affichez des données de maillage 3D ou affichez les données cibles après chaque étape du pipeline.

• Aller à l'emplacement de code source d'un événement Direct3D spécifique.

• Découvrez les événements Direct3D fournis à la couleur d'un pixel spécifique dans chaque frame.

• Examinez les objets Direct3D tels que l'état, les mémoires tampons, les maillages et les textures de périphérique.

Journaux de graphiques

Pendant la session de capture de Graphics Diagnostics, un journal de graphiques est créé pour enregistrer des événements, des ressources et un état graphique.Vous pouvez ensuite utiliser le journal de graphiques pour recréer et examiner en détail les frames capturés, sans devoir répliquer l'environnement utilisé pour les capturer.Vous pouvez charger plusieurs fichiers du journal de graphiques (.vsglog) en même temps pour comparer les données et les résultats de rendu.Comme ces fichiers sont autonomes, vous pouvez les partager avec d'autres développeurs.Pour plus d'informations, consultez Débogage Graphics DirectX.

[!REMARQUE]

Comme certaines API Windows 8 ne sont pas disponibles dans Windows 7 ou Windows Vista, les applications qui utilisent ces API ne peuvent pas être recréées sous Windows 7 ou Windows Vista.

Pour ouvrir un fichier journal Graphics (vsglog)

1. Dans Visual Studio, dans la barre de menus, choisissez Fichier, Ouvrir, Fichier.La boîte de dialogue Ouvrir un fichier s'affiche.

2. Spécifiez un fichier journal des graphiques (.vsglog) pour ouvrir, puis choisissez le bouton Ouvrir.

Utilisation de la barre d'outils de diagnostics de graphiques

Vous pouvez utiliser la barre d'outils de Graphics Diagnostics pour accéder aux outils qui vous aident à capturer des données dans un journal de graphiques, puis diagnostiquer et déboguer les problèmes qui ont été capturés dans le journal.

Voici la barre d'outils de Graphics Diagnostics :

Le tableau suivant décrit les éléments dans la barre d'outils de diagnostics de graphiques.Les éléments sont répertoriés dans l'ordre de leur apparition de gauche à droite.

Bouton de barre d'outils	Description
Démarrer les diagnostics	Démarre une application Direct3D avec la prise en charge des diagnostics de graphiques activée.Lorsque vous démarrez une application de cette façon, vous pouvez utiliser Graphics Diagnostics pour capturer des informations détaillées sur les frames individuelles dans l'application en cours d'exécution.
Liste d'événements	Ouvre la fenêtre Liste des événements Graphics.
Historique des pixels	Ouvre la fenêtre Historique des pixels Graphics.
Pile des appels des événements	Ouvre la fenêtre Pile des appels des événements Graphics.
Table des objets	Ouvre la fenêtre Table des objets Graphics.
Étapes de canalisation	Ouvre la fenêtre Étapes de canalisation Graphics.
Capturer le frame	Capture un frame d'une application Direct3D en cours de exécution qui a été démarrée en utilisant le bouton Démarrer les diagnostics.Le bouton Capturer le frame est activé uniquement lorsqu'une application avec Graphics Diagnostics activé s'exécute.

Panneau de configuration DirectX

Le panneau de configuration DirectX est un composant DirectX que vous pouvez utiliser pour modifier la manière dont DirectX se comporte (par exemple, vous pouvez activer la version de débogage des composants d'exécution DirectX, sélectionner le type de messages de débogage qui sont stockés, et désactiver certaines fonctionnalités du matériel graphique utilisées pour émuler le matériel ayant des capacités moindres).Ce niveau de contrôle sur DirectX peut vous aider à déboguer et tester votre application DirectX.Vous pouvez accéder au panneau de configuration DirectX depuis Visual Studio.

Pour ouvrir le panneau de configuration DirectX

• Dans la barre de menus, sélectionnez Déboguer, Graphiques, Panneau de configuration DirectX.

Fenêtres Outil Graphics Diagnostics

L'illustration suivante montre les fenêtres Outil utilisées pour tester et déboguer les frames capturés.Chaque fenêtre expose une catégorie d'informations différente qui sont capturées pour le frame en cours d'examen, et même pour chaque pixel du frame.

Rubriques connexes

Titre	Description
Capture d'informations Graphics	Décrit comment capturer des informations graphiques afin de pouvoir les analyser à l'aide d'outils de Graphics Diagnostics.
Document de journal Graphics	Décrit comment utiliser les informations de graphiques dans un document du journal des graphiques pour identifier les artefacts visuels qui sont provoqués en affichant des problèmes.
Liste des événements Graphics	Décrit comment utiliser la Liste des événements Graphics pour identifier les événements liés aux problèmes de rendu.
Étapes de canalisation Graphics	Décrit comment utiliser la fenêtre Étapes de canalisation Graphics pour identifier l'étape de pipeline où un problème de rendu apparaît en premier.
Pile des appels des événements Graphics	Décrit comment utiliser la Pile des appels des événements Graphics pour localiser le code d'application qui est lié aux problèmes de rendu.
Historique des pixels Graphics	Décrit comment utiliser l'Historique des pixels Graphics pour examiner les caractéristiques des événements qui ont affecté la dernière couleur d'un pixel.
Table des objets Graphics	Décrit comment utiliser la Table des objets Graphics pour afficher les détails des objets liés aux problèmes de rendu.
Débogage HLSL	Explique comment utiliser le Débogueur HLSL.