Document de journal GraphicsGraphics Log Document

Le document journal de graphisme est l’enregistrement des événements graphiques qui se sont produits pendant l’exécution de votre application sous une session Graphics Diagnostics.The Graphics Log document is the record of graphics events that occurred while your app was running under a graphics diagnostics session. Une fois les événements enregistrés, vous pouvez examiner le journal dans Visual Studio Graphics Analyzer pour diagnostiquer les problèmes de rendu et de performances.After being recorded, you can examine the log in Visual Studio Graphics Analyzer to diagnose rendering and performance problems.

Voici comment se présente un document journal de graphisme dans Graphics Analyzer :This is what a graphics log document looks like in the Graphics Analyzer:

Un journal de graphisme contenant deux frames capturés. A graphics log containing two captured frames.

Présentation des documents journaux de graphismeUnderstanding graphics log documents

En utilisant Graphics Analyzer pour examiner un document journal de graphisme, vous pouvez visualiser les effets des événements Direct3D qui se sont produits sur la cible de rendu pendant la capture.By using Graphics Analyzer to examine a graphics log document, you can visualize the effects of Direct3D events on the render target that occurred during capture. Vous pouvez localiser avec précision les régions de la cible de rendu qui contiennent la sortie inattendue.You can pinpoint regions of the render target that contain unexpected output. Quand vous sélectionnez un pixel dans la région affectée, vous pouvez utiliser Graphics Diagnostics pour l'inspecter, ainsi que ses nuanceurs, les événements Direct3D qui l'ont affecté, la pile des appels de l'application qui ont conduit à ces événements, puis les objets DirectX qui prennent en charge ces événements.When you select a pixel in the affected region, you can use Graphics Diagnostics to inspect it, its shaders, the Direct3D events that affected it, the application call stack that led to those events, and the DirectX objects that support those events. Vous pouvez utiliser ces informations pour diagnostiquer les problèmes de rendu dans votre jeu ou application.You can use this information to diagnose rendering problems in your game or app.

La partie supérieure de la fenêtre (Graphics.vsglog) affiche la sortie de cible de rendu actuelle du frame sélectionné et la partie inférieure affiche une liste de frames qui contient des images miniatures de la frames capturés.The top part of the window (Graphics Experiment.vsglog) displays the current render target output of the selected frame, and the bottom part displays a Frame List that contains thumbnail images of the captured frames.

Pour inspecter un frameTo inspect a frame

  • Dans le liste de frames, sélectionnez l’image que vous voulez inspecter.In the Frame List, select the frame that you want to inspect. La sortie cible de rendu figurant dans la partie supérieure du document journal de graphisme est mise à jour pour afficher le frame sélectionné.The render target output in the top part of the graphics log document is updated to display the selected frame.

Pour inspecter un pixelTo inspect a pixel

  • Dans la partie supérieure du document journal de graphisme, sélectionnez le pixel souhaité dans la sortie cible de rendu.In the top part of the graphics log document, select the pixel that you want from the render target output. Lorsqu’un pixel est sélectionné, vous pouvez utiliser la historique des pixels Graphics pour afficher des informations détaillées sur le pixel sélectionné.When a pixel is selected, you can use the Graphics Pixel History window to view detailed information about the selected pixel. Pour plus d’informations, consultez historique des pixels.For more information, see Pixel History.

Ordinateur de lecturePlayback machine

Affiche également dans le coin supérieur droit de la liste de frames est la ordinateur de lecture.Also displayed in the upper-right corner of the Frame List is the Playback Machine. L’ordinateur de lecture est l’ordinateur ou l’appareil utilisé pour lire les événements graphiques d’un fichier journal de graphisme à l’occasion d’une session Graphics Diagnostics ultérieure.The playback machine is a machine or device that is used to play back graphics events from a graphics log file during a later graphics diagnostics session. En lisant les événements capturés sur un autre appareil que votre ordinateur de développement, vous pouvez reproduire avec une plus grande précision l'environnement d'exécution dans lequel le problème s'est produit. Par exemple, vous pouvez utiliser un ordinateur équipé de matériel ou de pilotes graphiques différents de ceux utilisés sur votre ordinateur de développement, ou d'autres types d'appareils, tels qu'une tablette Windows RT ou un appareil Windows Phone ARM.By using a different device instead of your development machine to play back captured events, you can more accurately reproduce the execution environment in which the problem occurs—for example, you can use a machine that has different graphics hardware or drivers than the ones that your development machine uses, or other kinds of devices, such as an ARM-based Windows RT tablet or Windows Phone device.

Pour plus d’informations sur la spécification d’un ordinateur de lecture, consultez Comment : modifier l’ordinateur de lecture Graphics Diagnostics.For information about how to specify a playback machine, see How to: Change the Graphics Diagnostics Playback Machine.

Information résumées du journal de graphismeGraphics log summary information

Quand un fichier journal de graphisme est le document actif, le propriétés fenêtre affiche des informations sur l’environnement qui a hébergé la session de capture de Graphics Diagnostics.When a graphics log file is the active document, the Properties window displays information about the environment that hosted the Graphics Diagnostics capture session. Plusieurs catégories d'informations sont affichées.Several categories of information are displayed.

Informations Direct3DDirect3D Information
Répertorie des informations sur les fonctionnalités matérielles et du pilote de la carte vidéo qui a été utilisée pendant la session de capture.Lists information about the hardware and driver features of the display adapter that was used during the capture session.

PropriétéProperty DescriptionDescription
Format de couleur XR 10 bits10-bit XR High Color Format True si le format de couleur XR 10 bits est pris en charge ; sinon, False.True if 10-bit XR high-color format is supported; otherwise, False.
DirectCompute CS 4.xDirectCompute CS 4.x True si Compute Shader 4.0 est pris en charge ; sinon, False.True if Compute Shader 4.0 is supported; otherwise, False.
Nuanceurs à double précisionDouble Precision Shaders True si la carte vidéo prend en charge les valeurs à virgule flottante (64 bits) double précision ; sinon, False.True if the display adapter supports double-precision (64-bit) floating-point values; otherwise, False.
Listes de commandes de piloteDriver Command Lists True si le pilote prend en charge les listes de commandes ; sinon, False.True if the driver supports command lists; otherwise, False.
Créations simultanées du piloteDriver Concurrent Creates True si le pilote prend en charge la création (asynchrone) simultanée ; sinon, False.True if the driver supports concurrent (asynchronous) creation; otherwise, False.
Formats étendus (BGRA, etc.).Extended Formats (BGRA, etc.) True si les formats étendus comme BGRA sont pris en charge ; sinon, False.True if extended formats like BGRA are supported; otherwise, False.
Niveau de fonctionnalité HW max.Max HW Feature Level Affiche le plus haut niveau de fonctionnalité pris en charge par la carte vidéo.Displays the highest feature level that is supported by the display adapter.

Afficher des informationsDisplay Information
Répertorie des informations sur la carte vidéo qui a été utilisée pendant la session de capture.Lists information about the display adapter that was used during the capture session.

PropriétéProperty DescriptionDescription
DescriptionDescription Chaîne de description de la carte vidéo.The display adapter description string.
Afficher la mémoireDisplay Memory Quantité de mémoire installée sur la carte vidéo.The amount of memory that's installed on the graphics adapter.
Nom du piloteDriver Name Nom du pilote de la carte vidéo.The name of the graphics adapter driver.
Version du piloteDriver Version Version du pilote de la carte vidéo.The version of the graphics adapter driver.
NameName Nom du pilote de la carte vidéo.The name of the graphics adapter.

Fichier d’expérimentationExperiment File
Répertorie des informations sur le fichier d'expérimentation associé à la session de capture.Lists information about the experiment file that's associated with the capture session.

PropriétéProperty DescriptionDescription
CheminPath Chemin d’accès du fichier .vsglog.The path of the .vsglog file. Remarque : sous la capture héritée, cette propriété n’est pas utilisée.Note: Under legacy capture, this property is unused.

Informations de moduleModule Information
Répertorie le nom et la version des bibliothèques de liens dynamiques (DLL) qui ont été chargées par l'application pendant la session de capture.Lists the name and version of the dynamic link libraries (DLLs) that were loaded by the app during the capture session.

Informations systèmeSystem Information
Répertorie les informations sur le matériel et le système d'exploitation qui ont hébergé l'application pendant la session de capture.Lists information about the hardware and operating system that hosted the app during the capture session.

PropriétéProperty DescriptionDescription
MémoireMemory Quantité de mémoire installée sur l'ordinateur.The amount of memory that's installed in the computer.
Architecture de système d’exploitationOS Architecture Architecture d'UC cible du système d'exploitation.The target CPU architecture of the operating system.
Version du système d’exploitationOS Version Version du système d'exploitation.The operating system version.
ProcesseurProcessor Processeur installé dans l'ordinateur.The processor that's installed in the computer.
Architecture de l’Application cibleTarget Application Architecture Architecture d'UC cible de l'application.The target CPU architecture of the app. Cela peut être différent de celui du Architecture du système d’exploitation.This can be different than the OS Architecture.

Application cibleTarget Application
Répertorie des informations sur l'application qui fait l'objet de la session de capture.Lists information about the app that's the subject of the capture session.

PropriétéProperty DescriptionDescription
Date/heure de dernière modificationLast-Modified Date/Time Date et heure de génération de l'application.The date and time that the app was built.
CheminPath Chemin d’accès de l’application.The path of the app.
ID du processusProcess ID ID de processus donné à l'application.The process ID that was given to the app.
VersionVersion Version de l'application.The app version.

Fichier journal VsgVSG Log File
Répertorie des informations sur le document journal de graphisme.Lists information about the graphics log document.

PropriétéProperty DescriptionDescription
Créé parCreated by Nom de l'application qui a créé le document journal de graphisme.The name of the app that created the graphics log document. Par exemple, si la session de capture a été initialisée à partir de Visual StudioVisual Studio (capture manuelle), la valeur de cette propriété est Visual StudioVisual Studio.For example, if the capture session was initiated from Visual StudioVisual Studio (manual capture) the value of this property is Visual StudioVisual Studio.
Heure de début de sessionSession Start Time Date et heure de début de la session de capture.The date and time that the capture session began.
TailleSize Taille du document journal de graphisme.The size of the graphics log document.

Voir aussiSee Also

Procédure pas à pas : Objets manquants en raison Vertex Shader Walkthrough: Missing Objects Due to Vertex Shading
Procédure pas à pas : débogage des erreurs de rendu dues à l’ombrageWalkthrough: Debugging Rendering Errors Due to Shading