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:

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