Pour vous aider à identifier tout comportement physique inhabituel, le débogueur visuel de Chaos dispose d'outils de débogage pour visualiser les aspects de votre application qui ne sont normalement pas visibles à l'exécution.
Vous pouvez contrôler les outils de dessin de débogage qui s'affichent dans le hublot en activant ou désactivant les indicateurs de données. Les indicateurs de données sont répartis dans les catégories suivantes :
Certains indicateurs, comme le centre de gravité, peuvent avoir un impact sur les performances du débogueur visuel de Chaos. Si vous atteignez la limite de dessin de débogage, un avertissement s'affiche dans le hublot :
Limite maximale de lignes de dessin de débogage atteinte ! Essayez de sélectionner moins de catégories de dessins de débogage ou de concentrer la caméra sur une zone plus restreinte.
Données de collision
Les données de collision visualisées peuvent vous aider à identifier les zones dans lesquelles des collisions se comportent de manière inattendue. Par exemple, lorsque deux objets se croisent et n'entrent pas en collision comme prévu.
Pour activer les données de collision, procédez comme suit :
Dans la barre d'outils du hublot, cliquez sur Afficher > Indicateurs de données de collision > Activer le dessin. Une liste d'indicateurs de données s'affiche.
Choisissez dans la liste les indicateurs de données que vous souhaitez activer ou désactiver.
Cliquez sur Paramètres de visualisation des données de collision pour personnaliser le mode d'affichage des données dans le hublot.
Les paramètres de visualisation comprennent les options suivantes :
Afficher le texte de débogage : active ou désactive le texte de débogage du hublot (le cas échéant).
Priorité de profondeur : affiche des données dans l'espace du monde ou au premier plan (toujours au-dessus de tous les autres composants de la scène).
Options pour l'échelle et le rayon : contrôlez la taille des éléments de dessin de débogage afin de les rendre plus faciles à voir dans le hublot.
La plupart des indicateurs de données incluent des paramètres de visualisation qui contiennent des fonctionnalités activables ou désactivables similaires.
Requêtes de scène
Les requêtes de scène visualisées (tracés de ligne, balayages et chevauchements) peuvent vous aider à déboguer les cas où vous avez effectué une requête à l'exécution, mais que celle-ci n'a pas trouvé l'objet attendu.
Pour activer les données de requête de scène, procédez comme suit :
Dans la barre d'outils du hublot, cliquez sur Afficher > Indicateurs de données de requête de scène > Activer le dessin. Une liste d'indicateurs de données s'affiche.
Choisissez dans la liste les indicateurs de données que vous souhaitez activer ou désactiver.
Cliquez sur Paramètres de visualisation des requêtes de scène pour personnaliser le mode d'affichage des données dans le hublot.
Données de particules
Les données de particules visualisées peuvent vous aider à identifier tout comportement irrégulier des particules, par exemple lorsqu'une particule se déplace plus rapidement que prévu après l'application d'une force.
Pour activer les données de particules, procédez comme suit :
Dans la barre d'outils du hublot, cliquez sur Afficher > Indicateurs de données de particules > Activer le dessin. Une liste d'indicateurs de données s'affiche.
Choisissez dans la liste les indicateurs de données que vous souhaitez activer ou désactiver.
Cliquez sur Paramètres de visualisation des données de particules pour personnaliser le mode d'affichage des données dans le hublot.
Le débogueur visuel de Chaos enregistre et visualise uniquement les données de particule du thread physique, et non celles du thread de jeu. Les données de particules du thread de jeu ne sont pas visualisées.
Géométrie
La plupart des particules ont une géométrie de collision à la fois simple et complexe, mais une seule est utilisée pour la détection de collision.
Les options permettant de basculer entre la géométrie simple et la géométrie complexe, ainsi que d'autres indicateurs de visualisation de géométrie, se trouvent dans la barre d'outils du hublot, dans le menu Afficher > Indicateurs de géométrie.
La géométrie de requête uniquement est visualisée avec un matériau translucide. Vous pouvez cliquer sur les matériaux translucides en appuyant sur la touche T (ou en cliquant sur Autoriser la sélection translucide dans le menu latéral) pour activer ou désactiver les sélections translucides.
Colorisation des particules
Pour augmenter la visibilité de l'affichage, vous pouvez choisir de colorer les particules à l'aide des modes suivants :
Aucun : les particules apparaissent en gris par défaut.
État : la colorisation est effectuée en fonction de l'état d'un corps physique dans une simulation (dynamique, en veille, cinématique ou statique).
Type de forme : a colorisation est effectuée en fonction du type de géométrie de collision (formes simples, convexe, champs de hauteur ou maillage triangulaire).
Client Serveur : a colorisation est effectuée en fonction des particules générées par le client ou le serveur.
État et Gris par défaut
Pour modifier le mode et personnaliser les couleurs, procédez comme suit :
Dans la barre d'outils du hublot, cliquez sur Afficher > Colorisation des particules.
Dans le menu déroulant Mode de couleurs, cliquez sur le menu déroulant Mode de couleur des particules et sélectionnez le mode à utiliser.
Cliquez sur le menu déroulant Couleurs par [mode] pour personnaliser les couleurs. Ensuite, cliquez sur un carré de couleur pour ouvrir une pipette dans un menu contextuel.
Le tableau ci-dessous décrit l'interface utilisateur (IU) de la pipette contextuelle.
| Numéro | Description |
|---|---|
1 | Sélecteur de couleurs (ou spectre de couleurs s'il est activé). |
2 | Affiche les couleurs actuelles et précédemment sélectionnées. |
3 | Active/désactive la prévisualisation sRVB. |
4 | Bascule entre le sélecteur de couleurs et le spectre de couleurs. |
5 | Active/désactive la visibilité des schémas de couleurs. |
6 | Outil Pipette. |
7 | Curseurs RVB/HSV. |
8 | Curseur Alpha. |
9 | Affiche le code hexadécimal de la couleur actuelle. |
10 | Schémas de couleurs : fonctions similaires aux nuanciers d'Adobe Photoshop ou d'autres programmes de conception. |
Contraintes d'articulation
Les contraintes d'articulation visualisées peuvent vous aider à déboguer un comportement de ragdoll indésirable, notamment une déformation des articulations. Le débogueur visuel de Chaos enregistre les données de contrainte d'articulation en tant que données individuelles pour chaque image. Il est donc actuellement impossible de conserver une sélection entre les images du jeu.
Pour activer les données de contrainte d'articulation, procédez comme suit :
Dans la barre d'outils du hublot, cliquez sur Afficher > Indicateurs de données de contraintes d'articulation > Activer le dessin. Une liste d'indicateurs de données s'affiche.
Choisissez dans la liste les indicateurs de données que vous souhaitez activer ou désactiver.
Cliquez sur Paramètres de visualisation des contraintes d'articulation pour personnaliser le mode d'affichage des données dans le hublot.
Le débogueur visuel de Chaos n'enregistre pas les contraintes articulation par défaut. Pour les activer, cliquez sur le menu déroulant Canal de données dans la barre d'outils principale et cochez la case JointConstraints.
Contraintes de sol du personnage
Le débogueur visuel de Chaos peut enregistrer l'état des contraintes de sol du personnage utilisées par le système de mouvement de personnage de l'Unreal Engine, appelé
Pour activer les données de contrainte de sol de personnage, procédez comme suit :
Dans la barre d'outils du hublot, cliquez sur Afficher > Indicateurs de données de contraintes de sol du personnage > Activer le dessin. Une liste d'indicateurs de données s'affiche.
Choisissez dans la liste les indicateurs de données que vous souhaitez activer ou désactiver.
Cliquez sur Paramètres de visualisation des contraintes de sol du personnage pour personnaliser le mode d'affichage des données dans le hublot.
Le débogueur visuel de Chaos n'enregistre pas les contraintes de sol du personnage par défaut. Pour les activer, cliquez sur le menu déroulant Canal de données dans la barre d'outils principale et cochez la case Contraintes de sol du personnage.
Données de dessin de débogage génériques
Les macros C++ et les nœuds de Blueprint suivants enregistrent les formes de dessin de débogage directement dans le débogueur visuel de Chaos. Les formes de dessin de débogage offrent un contexte pour le débogage des calculs physiques.
Par exemple, si vous utilisez deux points dans l'espace pour calculer une force appliquée à un corps physique, le débogueur visuel de Chaos n'affiche que le corps avant et après l'application de la force. Si quelque chose semble anormal, vous pouvez utiliser des macros de dessin de débogage génériques (ou des nœuds de Blueprint) pour visualiser les deux points et la force, image par image. Ce flux de travail peut fournir un contexte sur le mode de calcul de la force et vous aider à le corriger.
Macros C++
En fonction de la forme que vous souhaitez dessiner, chaque macro dispose de son propre ensemble de paramètres, à l'exception des paramètres facultatifs suivants, qu'utilise chaque macro :
| Macro | Paramètre | Description |
|---|---|---|
TraceDebugDrawBox | InBox | La forme que vous souhaitez enregistrer. |
Toutes les macros | Balise | FName utilisé comme balise pour le filtre, la recherche et le dessin de débogage en tant que balise de texte dans le hublot du débogueur visuel de Chaos. |
Toutes les macros | Couleur | La couleur à appliquer à cette forme lorsqu'elle est dessinée en mode de débogage dans le débogueur visuel de Chaos. |
Toutes les macros | SolverID | L'identifiant du solveur auquel cette forme doit être associée. Si aucun identifiant n'est fourni, cette forme est ajoutée dans le cadre du jeu actuel à partir du compartiment de données. |
TraceDebugDrawLine, TraceDebugDrawVector | InStartLocation | Le point de départ de la ligne. |
TraceDebugDrawLine | InEndLocation | Le point final de la ligne. |
TraceDebugDrawVector | InVector | Le vecteur que vous souhaitez enregistrer. |
TraceDebugDrawSphere | Centre | Le point d'origine de la sphère. |
TraceDebugDrawSphere | Radius | Le rayon de la sphère. |
Toutes les macros | Owner | Tout UObject auquel cette forme de dessin de débogage est associée. Cette macro est utilisée en interne pour savoir si une forme a été enregistrée par un solveur serveur ou un solveur client. |
Nœuds de blueprint
Les macros de dessin de débogage génériques suivantes peuvent également être implémentées comme nœuds fonctionnels dans le graphique d'événements d'un blueprint :
Sphère de dessin de débogage d'enregistrements du débogueur visuel de Chaos
Boîte de dessin de débogage d'enregistrements du débogueur visuel de Chaos
Ligne de dessin de débogage d'enregistrements du débogueur visuel de Chaos
Pour en savoir plus sur chaque nœud, consultez la section Débogueur visuel de Chaos du document
Activer les données de dessin de débogage génériques
Pour activer les données de dessin de débogage génériques, procédez comme suit :
Dans la barre d'outils du hublot, cliquez sur Afficher > Indicateurs de données de dessin de débogage génériques > Activer le dessin. Une liste d'indicateurs de données s'affiche.
Choisissez dans la liste les indicateurs de données que vous souhaitez activer ou désactiver.
Cliquez sur Paramètres de visualisation des données de dessin de débogage génériques pour personnaliser le mode d'affichage des données dans le hublot.
Structures d'accélération
Le débogueur visuel de Chaos permet d'enregistrer et de visualiser les structures d'accélération utilisées par le système de requêtes de scène, qui est actuellement une arborescence AABB (boîte englobante alignée sur les axes). Une arborescence AABB est une hiérarchie de volume englobante qui permet de déterminer les chevauchements potentiels entre des objets.
Dans le débogueur visuel de Chaos, vous pouvez utiliser la visualisation Arborescence AABB pour voir la composition de l'arborescence et les limites de chaque objet à mesure qu'ils y sont ajoutés.
Cette visualisation est particulièrement utile lorsqu'un objet qu'une requête de scène aurait dû toucher n'a pas été touché ou n'a pas été évalué par le moteur physique. Vous pouvez utiliser la visualisation Arborescence AABB dans le débogueur visuel de Chaos pour inspecter les limites de l'objet et déterminer si l'erreur a été générée notamment par des limites qui n'englobent pas visuellement l'objet ou par des limites incorrectes de l'arborescence.
Pour personnaliser les indicateurs de données de structure d'accélération à générer, procédez comme suit :
Dans le hublot, cliquez sur Afficher > Indicateurs de données de structure d'accélération et sélectionnez les indicateurs de données de votre choix.
Cliquez sur Paramètres de visualisation de la structure de données pour personnaliser le mode d'affichage des données dans le hublot.
Le débogueur visuel de Chaos n'enregistre pas les structures d'accélération par défaut. Pour les activer, cliquez sur le menu déroulant Canal de données dans la barre d'outils principale et cochez la case Données des structures d'accélération.
Indicateurs d'affichage communs
Le menu Indicateurs d'affichage communs contient des indicateurs dérivés du moteur qui peuvent améliorer la visibilité dans le débogueur visuel de Chaos.
Pour personnaliser les indicateurs à activer, ouvrez la barre d'outils du hublot et cliquez sur Afficher > Indicateurs d'affichage communs.
Suivant
Inspecteurs de données
Comprendre les inspecteurs de données dans le débogueur visuel de Chaos.
Capturer des données avec le débogueur visuel de Chaos
Capturez des enregistrements et lancez la lecture avec le débogueur visuel de Chaos.