Freigeben über


Grafikprotokolldokument

Ein Grafikprotokolldokument ist ein Datensatz der Direct3D-Ereignisse, die während einer Grafikdebugsitzung von Ihrem Spiel oder Ihrer App aufgezeichnet wurden. Sie können das Protokoll in Visual Studio überprüfen, um Renderingfehler zu identifizieren, und dann die Grafikdiagnosetools für eine ausführlichere Überprüfung verwenden.

So sieht ein Grafikprotokolldokument in Visual Studio aus:

A graphics log containing two captured frames.

Hinweis

Ab Visual Studio 2013 Update 3 werden die Grafikdiagnose-Toolfenster in einer unabhängigen Kopie der Visual Studio-Shell gehostet.Diese benutzerdefinierte Shell, genannt Visual Studio Grafik-Analyse, beseitigt unnötige Menüs und Optionen, aber das Grafikprotokolldokument und der Workflow sind gleich geblieben.

Um die Visual Studio Grafik-Analyse von der Visual Studio Aufnahmeschnittstelle aus zu öffnen, wählen Sie eines der Frames, das Sie über den Link Frame... über dem Miniaturbild erfasst haben, oder doppelklicken Sie auf die Miniaturansicht.

Weitere Informationen über diese Änderung finden Sie unter Übersicht über die Grafikdiagnose.

Grundlegendes zu Grafikprotokolldokumenten

Wenn Sie das Grafikprotokolldokument mithilfe von Visual Studio überprüfen, können Sie die erfassten Auswirkungen von Direct3D-Ereignissen auf das Renderziel visuell darstellen. Sie können Bereiche des Renderziels festlegen, die unerwartete Ausgabe enthalten. Wenn Sie ein Pixel im betroffenen Bereich auswählen, können Sie dieses, seine Shader, die Direct3D-Ereignisse, die Auswirkungen auf das Pixel hatten, die Anwendungsaufrufliste, die zu diesen Ereignissen führte, sowie die DirectX-Objekte, die diese Ereignisse unterstützen, mit der Grafikdiagnose überprüfen. Sie können diese Informationen verwenden, um Renderingprobleme im Spiel oder in der App zu bestimmen.

Im oberen Teil des Fensters (Graphics Experiment.vsglog) wird die aktuelle Renderzielausgabe der ausgewählten Frames angezeigt, und im unteren Teil wird eine Frameliste angezeigt, die Miniaturbilder der aufgezeichneten Frames enthält.

So überprüfen einen Frame

  • Wählen Sie in der Frameliste den Frame aus, den Sie überprüfen möchten. Die Renderzielausgabe im obersten Abschnitt des Grafikprotokolldokuments wird aktualisiert und zeigt den ausgewählten Frame an.

So überprüfen Sie ein Pixel

  • Wählen Sie das gewünschte Pixel im obersten Abschnitt des Grafikprotokolldokuments aus der Renderzielausgabe aus. Wenn ein Pixel aktiviert ist, können Sie im Fenster Grafikpixelverlauf ausführliche Informationen über das ausgewählte Pixel anzeigen. Weitere Informationen finden Sie unter Grafikpixelverlauf.

Wiedergabecomputer

In der rechten oberen Ecke der Frameliste wird auch der Wiedergabecomputer angezeigt. Der Wiedergabecomputer ist ein Computer oder ein Gerät, das Grafikereignisse aus einer Grafikprotokolldatei während einer späteren Grafikdiagnosesitzung wiedergibt. Wenn Sie ein anderes Gerät als Ihren Entwicklungscomputer zur Wiedergabe der aufgezeichneten Ereignisse verwenden, können Sie die Ausführungsumgebung genauer reproduzieren, in der das Problem aufgetreten ist – Sie können beispielsweise einen Computer mit anderer Grafikhardware oder anderen Treibern als Ihr Entwicklungscomputer oder andere Arten von Geräten verwenden, z. B. ein ARM-basiertes Windows RT-Tablet oder ein Gerät mit Windows Phone.

Informationen zur Festlegung eines Wiedergabecomputers finden Sie unter Gewusst wie: Ändern des Grafikdiagnose-Wiedergabecomputers.

Kurzinformationen zum Grafikprotokoll

Wenn das aktive Dokument eine Graphikprotokolldatei ist, werden im Fenster Eigenschaften Informationen zur Umgebung angezeigt, in der die Grafikdiagnose-Erfassungssitzung gehostet wird. Es werden verschiedene Kategorien von Informationen angezeigt.

  • Direct3D-Informationen
    Führt Informationen über die Hardwarekonfiguration und Treiberfunktionen der Grafikkarte auf, die während der Erfassungssitzung verwendet wurde.

    Eigenschaft

    Beschreibung

    10-Bit XR-Format mit hoher Farbtiefe

    True, wenn das 10-Bit XR-Format mit hoher Farbtiefe unterstützt wird; andernfalls False.

    DirectCompute CS 4.x

    True, wenn der Compute-Shader 4.0 unterstützt wird; anderenfalls False.

    Shader mit doppelter Genauigkeit

    True, wenn die Grafikkarte Gleitkommawerte mit doppelter Genauigkeit (64 Bit) unterstützt; andernfalls False.

    Treiberbefehlslisten

    True, wenn der Treiber Befehlslisten unterstützt; andernfalls False.

    Treiber – Simultanerstellungen

    True, wenn der Treiber die gleichzeitige (asynchrone) Erstellung unterstützt; andernfalls False.

    Erweiterte Formate (BGRA usw.)

    True, wenn erweiterte Formate wie BGRA unterstützt werden; andernfalls False.

    Maximale Hardwarefunktionsebene

    Zeigt die höchste Funktionsebene an, die über die Grafikkarte unterstützt wird.

  • Anzeigeinformationen
    Führt Informationen über die Grafikkarte auf, die während der Erfassungssitzung verwendet wurde.

    Eigenschaft

    Beschreibung

    Beschreibung

    Die Zeichenfolge für die Grafikkartenbeschreibung.

    Anzeigespeicher

    Der Speicherplatz, der auf der Grafikkarte installiert ist.

    Treibername

    Der Name des Grafikkartentreibers.

    Treiberversion

    Die Version des Grafikkartentreibers.

    Name

    Der Name der Grafikkarte.

  • Experimentedatei
    Listet Informationen über die Experimentedatei auf, die mit dieser Erfassungssitzung verknüpft ist.

    Eigenschaft

    Beschreibung

    Pfad

    Der Pfad der .vsglog-Datei.

    Hinweis

    In früheren Erfassungen wird die Eigenschaft nicht verwendet.

    • Modulinformationen
      Führt den Namen und die Version der Dynamic Link Librarys (DLL) auf, die während der Erfassungssitzung durch die App geladen wurden.

    • Systeminformationen
      Führt Informationen über die Hardware und das Betriebssystem auf, die die App während der Erfassungssitzung gehostet haben.

      Eigenschaft

      Beschreibung

      Arbeitsspeicher

      Der Speicher, der auf dem Computer installiert ist.

      Architektur des Betriebssystems

      Die CPU-Architektur des Betriebssystems des Zielcomputers.

      Betriebssystemversion

      Die Version des Betriebssystems.

      Prozessor

      Der Prozessor, der auf dem Computer installiert ist.

      Anwendungsarchitektur des Zielcomputers

      Die CPU-Architektur der App auf dem Zielcomputer. Diese kann sich von der BS-Architektur unterscheiden.

    • Zielanwendung
      Führt Informationen über die App auf, die von der Erfassungssitzung erfasst wird.

      Eigenschaft

      Beschreibung

      Datum/Uhrzeit der letzten Änderung

      Datum und Uhrzeit der Erstellung der App.

      Pfad

      Der Pfad der App.

      Prozess-ID

      Die Prozess-ID, die zur App angegeben wurde.

      Version

      Die App-Version.

    • VSG-Protokolldatei
      Führt Informationen über das Grafikprotokolldokument auf.

      Eigenschaft

      Beschreibung

      Erstellt von

      Der Name der App, die das Grafikprotokolldokument erstellt hat. Wenn die Erfassungssitzung z. B. von Visual Studio initiiert wurde (manuelle Erfassung) ist der Wert dieser Eigenschaft Visual Studio.

      Sitzungs-Startzeit

      Das Datum und die Uhrzeit, zu der die Erfassungssitzung begann.

      Größe

      Die Größe des Grafikprotokolldokuments.

    Siehe auch

    Aufgaben

    Exemplarische Vorgehensweise: Fehlende Objekte durch Vertexschattierung

    Exemplarische Vorgehensweise: Debuggen von Renderingfehlern, die durch Schattierungen entstanden sind