Enregistrer dans un fichier

Dans ce tutoriel, vous apprendrez à enregistrer des visualisations dans le débogueur visuel de Chaos et à les enregistrer dans un fichier .utrace pour un débogage ultérieur. L'enregistrement dans un fichier est utile pour éviter tout surcoût de performances lié à la lecture en direct.

Pour en savoir plus sur l'enregistrement des visualisations en temps réel, consultez la page Enregistrer une session en direct.

Démarrer un enregistrement à l'aide de l'interface utilisateur

Dans cette section, vous découvrirez comment enregistrer une session PIE en utilisant la cible prédéfinie de l'éditeur local, et le processus pour enregistrer tous les autres types de cibles.

Éditeur local

Pour enregistrer et une session PIE et démarrer la lecture en local, procédez comme suit :

1. Dans le menu Canaux de données, activez les canaux de données que vous souhaitez enregistrer.

   

2. Dans l'Unreal Editor, cliquez sur le bouton Lecture dans la barre d'outils principale pour lancer une session PIE. Vous pouvez choisir de commencer la session PIE avant ou après avoir lancé un enregistrement dans le débogueur visuel de Chaos.

   

3. Dans la mesure où l'éditeur local cible est déjà sélectionné par défaut, vous pouvez commencer l'enregistrement en cliquant sur Enregistrer dans un fichier. Pendant l'enregistrement, ce bouton prend l'apparence d'une icône d'enregistrement rouge

   

4. Pour arrêter l'enregistrement, placez le curseur de la souris sur l'icône d'enregistrement et cliquez sur l'icône carrée rouge.

   

5. Ce processus génère un fichier .utrace unique que vous pouvez charger immédiatement après l'enregistrement en cliquant sur Oui dans la boîte de dialogue.

   

Toutes les autres cibles

Pour enregistrer tous les autres types de cibles, procédez comme suit :

1. Vérifiez que votre ou vos applications cibles sont en cours d'exécution.

2. Dans le débogueur visuel de Chaos, activez les canaux de données que vous souhaitez enregistrer.

   

3. Pour sélectionner une cible à enregistrer, cliquez sur le menu déroulant Cible de session dans la barre d'outils principale du débogueur visuel de Chaos et choisissez une ou plusieurs cibles prédéfinies ou personnalisées.

   

4. Pour commencer un enregistrement, dans la barre d'outils principale du débogueur visuel de Chaos, cliquez sur Enregistrer dans un fichier. Pendant l'enregistrement, ce bouton prend l'apparence d'une icône d'enregistrement rouge

   

5. Pour arrêter l'enregistrement, sélectionnez l'icône d'enregistrement et cliquez sur l'icône carrée rouge.

   

Selon que vous enregistrez une ou plusieurs cibles, ce processus génère un ou plus fichiers .utrace . Si vous enregistrez plusieurs cibles, la boîte de dialogue vous invitant à charger l'enregistrement ne s'affiche pas.

(Ancienne fonctionnalité) Enregistrer dans un fichier en utilisant l'interface en ligne de commande

Nous vous recommandons d'utiliser l'IU du débogueur visuel de Chaos pour commencer et arrêter les enregistrements. Cependant, vous pouvez utiliser la ligne de commande pour enregistrer des sessions PIE, des clients et serveurs de jeu et des versions empaquetées.

Activer un canal de données

1. Pour modifier les canaux de données, ouvrez la ligne de commande dans l'application cible. Dans une version empaquetée, appuyez sur la touche d'accent grave (`).

2. Saisissez la commande de console suivante, en remplaçant [newstate] par true ou false et [channelname] par le canal de données souhaité :

   p.Chaos.VD.SetCVDDataChannelEnabled [newstate] [channelname]

   Par exemple :

   

3.  Appuyez sur la touche Entrée pour exécuter la commande.

Activer plusieurs canaux de données

Pour activer ou désactiver plusieurs canaux, répertoriez-les en les séparant par des virgules. L'exemple suivant permet d'activer les canaux PostIntegrate et SceneQueries :

p.Chaos.VD.SetCVDDataChannelEnabled true SceneQueries,PostIntegrate

Activer les canaux de données prédéfinis

Pour lancer un client ou un serveur de jeu avec un ensemble prédéfini de canaux activés, ajoutez l'argument de ligne de commande suivant :

CVDDataChannelsOverride=[ChannelName1,ChannelName2]

L'exemple suivant permet d'activer les canaux d'intégration et de requête de scène :

CVDDataChannelsOverride=SceneQueries,PostIntegrate

Lancer un enregistrement en utilisant la ligne de commande

1. Pour lancer un enregistrement, ouvrez la ligne de commande dans l'application cible. Si vous lancez une version empaquetée, vous pouvez appuyer sur la touche d'accent grave (`).

2. Saisissez la commande suivante et appuyez sur la touche Entrée pour l'exécuter :

   p.Chaos.StartVDRecording

   

   

   Lorsque l'enregistrement commence, la chaîne Enregistrement du débogueur visuel de Chaos en cours… s'affiche à l'écran.

   

3. Pour arrêter un enregistrement, ouvrez la ligne de commande, saisissez la commande suivante et appuyez sur la touche Entrée pour l'exécuter.

   p.Chaos.StopVDRecording

   

Suivant

Dans le prochain tutoriel, vous apprendrez à localiser votre fichier .utrace et à démarrer la lecture de vos enregistrements.

Enregistrer une session en direct

Enregistrer une session en direct avec le débogueur visuel de Chaos

Lancer la lecture dans le débogueur visuel de Chaos

Lancer la lecture des enregistrements dans le débogueur visuel de Chaos.