RenderDoc ist ein kostenloser, eigenständiger Open-Source-Grafik-Debugger, mit dem Sie einzelne Frames einer Anwendung wie der Unreal Engine erfassen können. Die Aufnahme wird in RenderDoc geladen, um zu untersuchen, was auf der GPU durch Events, die API und vieles mehr im Detail passiert.
RenderDoc isntallieren
RenderDoc ist ein Open-Source-Grafik-Debugger, der kostenlos von RenderDoc.org heruntergeladen und installiert werden kann.
Die Liste der unterstützten Betriebssysteme und APIs unten spiegelt wider, was RenderDoc derzeit unterstützt, was sich von dem unterscheiden kann, was der Unreal Engine-Support unterstützt. Die aktuellsten Updates finden Sie auf der Seite FAQ von RenderDoc.
RenderDoc unterstützt die folgenden Systeme:
Windows 7, 10 und 11
Linux
Android
RenderDoc unterstützt die folgenden APIs:
Vulkan
D3D11
D3D12
OpenGL 3.2+
OpenGL ES 2.0 – 3.2
Aktivieren Sie RenderDoc in Ihrem Projekt
Das RenderDoc-Plugin ist in der Engine enthalten und standardmäßig aktiviert. Es gibt zwei Möglichkeiten, RenderDoc mit Ihrem Projekt auszuführen: per Befehlszeilen-Argumente oder als Projekt-Einstellungen.
Wenn RenderDoc beim Start verbunden ist, sehen Sie das RenderDoc-Symbol oben rechts im Level-Viewport.
Befolgen Sie diese Schritte, um zu sehen, wie die einzelnen Elemente aktiviert werden.
Aktivierung mit Plugin-Projekt-Einstellungen
Aktivieren Sie in den Projekt-Einstellungen unter Plugins > RenderDoc unter Erweiterte Einstellungen Automatisch zum Start ankoppeln. Die Methode eignet sich ideal, wenn Sie RenderDoc beim Start jederzeit ausführen möchten, wenn das Projekt geladen wird.
Aktivieren mit der Befehlszeile
Befehlszeilen-Argumente mit einem Editor-Shortcut aktivieren. Fügen Sie im Tab Shortcut den folgenden Code in dieZeile Ziel ein: -AttachRenderDoc. Die Methode eignet sich sehr gut, wenn Sie RenderDoc nur zeitweise ausführen möchten.
Durchführen einer Frame-Aufnahme
Die folgenden Schritte beschreiben grob, wie Sie mit Ihrem Unreal Engine Projekt eine Einzelbildaufnahme mit dem integrierten RenderDoc-Plugin oder direkt aus der RenderDoc-Anwendung durchführen.
Weitere Details zur Funktionalität und Nutzung von RenderDoc finden Sie in der RenderDoc-Dokumentation.
RenderDoc-Plugin
Die folgenden Schritte werden verwendet, um ein Frame mit dem RenderDoc-Plugin der Unreal Engine aufzunehmen:
Aktiviere n Sie das RenderDoc Plugin für Ihr Projekt.
Öffnen Sie Ihr Projekt und Ihre Szene, in der Sie eine Aufnahme durchführen möchten.
Klicken Sie auf die Schaltfläche RenderDoc Capture im Level-Viewport.
Bild für Großansicht anklicken.
RenderDoc-Anwendung
Im Folgenden finden Sie die erforderlichen Schritte zur Aufnahme eines Frame mit der Unreal Engine mit dem eigenständig ausführbar RenderDoc:
Konfigurieren Sie RenderDoc, um Ihr Spiel oder UEEditor.exe mit den entsprechenden Befehlszeilen-Argumenten zu starten.
Aktivieren Sie Child-Prozess erfassen beim Start mit UEEditor.exe.
Starten Sie die ausführbare Datei.
Drücken Sie die Tastaturkürzel F12, um einen Frame aufzunehmen.
Die vollständigen Details zur Einstellung von RenderDoc, zum Starten einer Anwendung und Durchführen einer Frame Capture finden Sie im Leitfaden für erste Schritte mit RenderDoc.
Projekt-Einstellungen
Verwenden Sie das Fenster Projekt-Einstellungen, um zusätzliche Einstellungen des RenderDoc-Plugins festzulegen. Wählen Sie im Hauptmenü Bearbeiten > Projekt-Einstellungen und unter der Kategorie Plugins wählen Sie RenderDoc aus.
| Eigenschaft | Beschreibung |
|---|---|
| Einstellungen zur Frame-Aufnahme | |
Alle Aktivitäten aufnehmen | Wenn aktiviert, nimmt RenderDoc alle Aktivitäten in allen Viewports und Editor-Fenstern für das gesamte Frame auf, und nicht nur im aktuellen Viewport. |
Alle Aufrufstapel aufnehmen | Wenn aktiviert, erfasst RenderDoc Call Stacks für alle API-Abrufe. |
Alle Ressourcen referenzieren | Wenn diese Option aktiviert ist, schließt RenderDoc alle Rendering-Ressourcen in die Aufnahme ein, auch solche, die während des Frames nicht verwendet wurden. Aktivieren Sie diese Eigenschaft, um die Größe erheblich zu erhöhen. |
Alle Anfangszustände speichern | Wenn diese Option aktiviert ist, erfasst RenderDoc immer den Anfangszustand aller Rendering-Ressourcen, auch wenn diese während des Frames wahrscheinlich nicht verwendet werden. Aktivieren Sie diese Eigenschaft, um die Größe erheblich zu erhöhen. |
| Erweiterte Einstellungen | |
Hilfe beim Start anzeigen | Wenn diese Option aktiviert ist, wird beim Start des Editors ein Hilfefenster mit RenderDoc angezeigt. |
Absturz-Handler von RenderDoc verwenden | Wenn aktiviert, wird der RenderDoc-Absturzhandler verwendet, wenn es zu einem Absturz kommt. Das sollten Sie nur verwenden, wenn Sie wissen, dass das Problem bei der Anwendung RenderDoc liegt und Sie die RenderDoc-Entwickler benachrichtigen möchten. |
Ausführbarer Pfad von RenderDoc | Legt den Pfad zur ausführbaren RenderDoc-Datei fest. Dies sollte bei der Installation von RenderDoc automatisch mit dem korrekten Pfad ausgefüllt werden. |
Zusätzliche Hinweise und Ressourcen
Weitere Informationen zur Verwendung von RenderDoc und zur Analyse von Frame-Aufnahmen finden Sie in der RenderDoc-Dokumentation.
Das RenderDoc-Plugin wurde von Fredrik Lindh ("Temaran") für die Unreal Engine erstellt und entwickelt. Weitere Informationen finden Sie im RenderDoc GitHub-Repository.