RenderDoc est un débogueur graphique autonome et open source qui peut réaliser des captures d'image unique d'une application, telle que l'Unreal Engine. La capture est chargée dans RenderDoc pour analyser en détail les problèmes survenus au niveau du processeur graphique via les événements, l'API et bien plus encore.
Installer RenderDoc
RenderDoc est un débogueur graphique open source gratuit, que vous pouvez télécharger et installer depuis RenderDoc.org.
La liste des systèmes d'exploitation et des API pris en charge ci-dessous reflète la compatibilité actuelle de RenderDoc, qui peut différer de celle de l'Unreal Engine. Pour obtenir les dernières mises à jour, consultez la FAQ de RenderDoc.
RenderDoc prend en charge les systèmes d'exploitation suivants :
Windows 7, 10 et 11
Linux
Android
RenderDoc prend en charge les API suivantes :
Vulkan
D3D11
D3D12
OpenGL 3.2+
OpenGL ES 2.0 à 3.2
Activer RenderDoc dans votre projet
Le plug-in RenderDoc est livré avec le moteur et activé par défaut. Vous pouvez exécuter RenderDoc de deux façons : avec un argument de ligne de commande ou un paramètre du projet.
Lorsque RenderDoc se connecte au démarrage, son icône s'affiche en haut à droite du hublot de niveau.
Pour activer chaque option, procédez comme suit.
Activation via les paramètres du projet pour le plug-in
Dans les paramètres du projet, sous Plug-ins > RenderDoc sous Paramètres avancés, activez Attachement automatique au démarrage. Cette méthode est idéale si vous voulez exécuter RenderDoc au démarrage, à chaque chargement du projet.
Activation via la ligne de commande
Activez les arguments de ligne de commande à l'aide d'un raccourci de l'éditeur. Dans l'onglet Raccourci, ajoutez la commande suivante à la ligne Cible : AttachRenderDoc. Cette méthode est idéale pour exécuter RenderDoc de manière occasionnelle.
Réalisation de capture d'image
Les étapes ci-dessous décrivent en détail comment effectuer une capture d'image unique dans votre projet Unreal Engine à l'aide du plug-in RenderDoc intégré ou directement depuis l'application RenderDoc.
Vous trouverez plus de détails sur les fonctionnalités et l'utilisation de RenderDoc dans la documentation de RenderDoc.
Plug-in RenderDoc
Pour capturer une image avec le plug-in RenderDoc de l'Unreal Engine, procédez comme suit :
Activez le plug-in RenderDoc pour votre projet.
Ouvrez votre projet et la scène où vous souhaitez effectuer une capture.
Cliquez sur le bouton RenderDoc Capture dans le hublot de niveau.
Cliquez sur l'image pour l'afficher à sa taille réelle.
Application RenderDoc
Voici les étapes principales pour capturer une image avec l'Unreal Engine et l'exécutable autonome RenderDoc :
Configurez RenderDoc pour lancer votre jeu ou UEEditor.exe avec les arguments de ligne de commande appropriés.
Activez la capture des processus enfants lors du lancement avec UEEditor.exe.
Lancez l'exécutable.
Appuyez sur la touche F12 pour effectuer une capture.
Pour plus de détails sur la configuration de RenderDoc, le lancement d'une application et la capture, consultez le Guide de premiers pas de RenderDoc.
Paramètres du projet
Utilisez la fenêtre Paramètres du projet pour définir des paramètres supplémentaires pour le plug-in RenderDoc. Dans le menu principal, sélectionnez Modifier > Paramètres du projet puis, dans la catégorie Plug-ins, sélectionnez RenderDoc.
| Propriété | Description |
|---|---|
| Paramètres de capture d'image | |
Capturer toute l'activité | Si cette option est activée, RenderDoc capture toute l'activité dans tous les hublots et fenêtres de l'éditeur pour l'image entière, pas seulement dans le hublot actuel. |
Capturer toutes les piles d'appels | Si cette option est activée, RenderDoc capture les piles pour tous les appels d'API. |
Référencer toutes les ressources | Si cette option est activée, RenderDoc inclut toutes les ressources de rendu dans la capture, même celles qui n'ont pas été utilisées pendant l'image. Activer cette propriété augmente considérablement la taille de la capture. |
Enregistrer tous les états initiaux | Si cette option est activée, RenderDoc capture toujours l'état initial de toutes les ressources de rendu, même si elles ne sont pas utilisées pendant l'image. Activer cette propriété augmente considérablement la taille de la capture. |
| Paramètres avancés | |
Afficher l'aide au démarrage | Si cette option est activée, une fenêtre d'aide avec RenderDoc s'affiche au démarrage de l'éditeur. |
Utiliser le gestionnaire de plantage de RenderDoc | Si cette option est activée, le gestionnaire de plantage de RenderDoc est utilisé en cas de plantage. Utilisez-le seulement si vous savez que le problème est lié à l'application RenderDoc et que vous souhaitez en informer les développeurs. |
Chemin d'accès à l'exécutable RenderDoc | Définit le chemin d'accès à l'exécutable RenderDoc à utiliser. Le chemin d'accès correct doit être automatiquement renseigné lors de l'installation de RenderDoc. |
Notes et ressources supplémentaires
Consultez la documentation RenderDoc pour en savoir plus sur l'utilisation et l'analyse des captures d'image de RenderDoc.
Le plug-in RenderDoc a été créé et développé par Fredrik Lindh ("Temaran") pour l'Unreal Engine. Pour en savoir plus, consultez le référentiel GitHub de RenderDoc.