Animations
Animations ouvre les fichiers qui décident de la façon dont un personnage, un infecté ou un animal bouge : anim graphs, anim sets et clips. Vous l'utilisez pour étudier comment les créatures du jeu sont configurées, pour modifier les graphs et anim sets de votre mod, et pour jouer un clip sur un squelette. Pour parcourir les fichiers du jeu, il faut le dossier DayZ défini dans les Paramètres ; pour lister les vôtres, il faut un dossier de workspace (également dans les Paramètres).
La page est marquée Aperçu dans le rail. La lecture fonctionne sur les fichiers du jeu : les graphs et anim sets s'ouvrent avec tout ce qu'ils référencent, la validation s'exécute sur l'ensemble, et les clips se jouent sur un squelette. Modifier des graphs et des anim sets fonctionne et enregistre avec une sauvegarde, mais les fichiers modifiés ici n'ont pas été vérifiés dans le jeu : testez-les en jeu avant de vous y fier. Les clips peuvent être regardés, pas modifiés.
L'écran
- En-tête : badges d'état (erreurs ou avertissements, fichiers modifiés, fichiers en lecture seule), Annuler, Rétablir, Recharger, Enregistrer. Le sous-titre nomme le fichier ouvert et combien de fichiers ont été chargés avec lui.
- Liste des fichiers (à gauche) : le commutateur Workspace / Jeu, un bouton dossier pour ouvrir un fichier depuis le disque, Réanalyser, et un champ de recherche. Jeu liste les fichiers
.aw,.agr,.asiet.astdans les PBO du jeu (les archives dans lesquelles le jeu livre ses fichiers) ; les clips (.anm) sont ajoutés quand vous saisissez 3 lettres, car il y en a des milliers. Cliquez sur une ligne pour l'ouvrir. - Au centre, rien d'ouvert : ce que la page ouvre, avec des boutons pour ouvrir un exemple ou un fichier.
- Au centre, graph ou anim set ouvert : quatre onglets.
- Graph : le canevas de nœuds d'une feuille, avec une barre pour choisir la feuille et ajouter un nœud ou une feuille. Double-cliquez sur une machine à états (un nœud marqué d'un carré) pour voir ses états et ses transitions ; la barre ajoute alors des états et des transitions.
- Variables et commandes : les variables (nom, type, valeur par défaut, min, max) et les commandes du graph, avec des champs pour en ajouter une.
- Anim sets : à gauche les groupes du template ; à droite le tableau des slots de l'instance choisie : chaque slot, le clip qui lui est assigné et son état.
- Problèmes : ce que la validation a trouvé. Cliquez sur une ligne pour aller au nœud, à la variable ou au slot.
- Inspecteur (à droite, graph ou anim set ouvert) : les propriétés de ce que vous avez sélectionné : nom, valeurs, listes, et pour un nœud ses entrées avec Connecter et Déconnecter.
- Au centre, clip ouvert : une barre avec le format, la fréquence d'images, les nombres d'images, d'os et d'événements, le modèle d'aperçu et un curseur Rotation ; l'aperçu du squelette ; la timeline avec lecture, avance image par image, vitesse et marques d'événements.
- Os (à droite, clip ouvert) : les os du clip avec leur nombre de clés. Cliquez sur l'un pour le mettre en évidence et afficher ses pistes de clés sous la timeline.
Premiers pas
- Laissez la liste sur Jeu, saisissez
cowdans le champ de recherche et cliquez surcow_sample.aw. - L'onglet Graph s'ouvre sur la feuille « Master ». Glissez l'arrière-plan pour naviguer, utilisez la molette pour zoomer.
- Cliquez sur un nœud : l'inspecteur montre sa classe et ses propriétés. Ses entrées sont listées en bas ; cliquez sur le nom d'une entrée pour sauter à ce nœud.
- Choisissez une autre feuille dans la liste au-dessus du canevas (« Startled » est la plus grande).
- Ouvrez Variables et commandes : trois variables et deux commandes. Ce sont celles que les scripts utilisent pour piloter le graph.
- Ouvrez Problèmes : l'exemple n'en a aucun.
Faire la visite (dans l'app)
Tâches courantes
Jouer un clip
- Dans la liste Jeu, saisissez au moins 3 lettres du nom du clip (par exemple
walk_fast) et cliquez sur une ligne.anm. - Appuyez sur lecture, ou glissez le curseur d'images. Les marques sous le curseur sont des événements ; survolez-en une pour son nom et son image.
- Si le squelette a l'air faux, choisissez le modèle correspondant dans « Aperçu sur ». La page choisit l'infecté pour les clips
z_, la vache pour les clips de vache et le joueur dans les autres cas. - Cliquez sur un os à droite pour voir ses clés de translation, de rotation et d'échelle.
Faire la visite des clips (dans l'app)
Voir quel clip une action utilise
- Ouvrez une instance d'anim set (
.asi) ou un workspace qui en liste une. La page s'ouvre sur l'onglet Anim sets. - Saisissez une partie du nom d'un slot ou d'un clip dans le filtre du tableau des slots.
- Cliquez sur le bouton lecture au bout d'une ligne pour ouvrir ce clip.
Trouver les références cassées dans votre anim set
- Ouvrez votre
.asi(ou votre.aw). - Dans le tableau des slots, cliquez sur le filtre Clip introuvable : ces slots nomment un
.anmqui n'existe ni dans votre projet ni dans le jeu. - Cliquez sur Sans clip pour voir les slots que rien ne remplit. Les lignes qui ne correspondent à aucun slot du template sont listées sous le tableau.
Modifier un graph de votre mod
- Ouvrez votre
.aw,.agrou.agfdepuis la liste Workspace ou avec le bouton dossier. - Sur l'onglet Graph, choisissez une classe de nœud, saisissez un nom unique et cliquez sur Nœud. Glissez le nouveau nœud en place.
- Sélectionnez le nœud qui doit l'utiliser, saisissez le nom du nouveau nœud dans « Connecter un nœud… » et cliquez sur Connecter.
- Vérifiez l'onglet Problèmes, puis appuyez sur Ctrl+S.
Travailler à partir d'un fichier du jeu
- Les fichiers du jeu s'ouvrent en lecture seule : vous pouvez modifier à l'écran, mais Enregistrer reste désactivé et un badge rouge nomme les fichiers en lecture seule.
- Extrayez d'abord les fichiers dans votre projet (le lecteur P: ou un dossier de workspace), par exemple avec le Packer PBO, puis ouvrez vos copies.
Exemples
- Exemple de la vache (dans l'app) : le workspace d'exemple de Bohemia, cinq fichiers. Un fichier de graph avec quatre feuilles, trois variables, deux commandes. Son anim set est presque vide ; regardez celui de l'infecté pour cela.
- Infecté (dans l'app) : une vraie configuration, sept fichiers : trois fichiers de graph (locomotion, combat, interaction), sept feuilles, huit commandes.
- Anim set de l'infecté (dans l'app) : l'instance
infected_main.asiface à un template de 321 slots. Essayez les filtres du tableau des slots. - Marche de la vache (dans l'app) : un clip de 33 images à 30 fps avec des événements
StepetFootDown…. - Escalade du joueur (dans l'app) : un clip de joueur avec des événements de pas, de saut et de son, montré sur le squelette du joueur.
Les exemples s'ouvrent depuis le jeu, en lecture seule.
Concepts
- Anim workspace (.aw) : le fichier d'entrée d'une configuration. Il nomme le graph, le template d'anim set, les instances et les modèles d'aperçu. L'ouvrir les charge tous.
- Graph (.agr) : le côté contrôle : les variables et commandes que les scripts définissent, la liste des fichiers de graph, et le template d'anim set dans lequel puise le graph.
- Fichier de graph (.agf) : les nœuds, regroupés en feuilles. Un nœud joue un slot de clip (Source), mélange ses entrées (Blend), choisit entre elles (Switch, GroupSelect) ou contient des états et des transitions (StateMachine). Les liens vont d'un nœud vers ses entrées.
- Template d'anim set (.ast) : la liste des slots qu'un graph peut demander, sous forme de groupes × colonnes × animations. Un slot s'écrit
Group.Column.Animation. - Instance d'anim set (.asi) : une ligne par slot donnant le clip
.anmqui le remplit. Une instance peut hériter d'instances parentes : un slot qu'elle ne définit pas est repris d'elles. C'est ainsi qu'un graph sert de nombreux objets ou créatures. - Clip (.anm) : un fichier binaire avec, par os, des clés de translation, de rotation et d'échelle, plus des événements (pas, sons) à des images données. Les clips du jeu sont aux formats ANIMSET4, 5 et 6 ; les clés des clips ANIMSET4 ne sont pas décodées ici.
- Tables d'événements et de synchronisation (.ae, .asy) : des fichiers texte auxquels un graph fait référence. La page les charge avec le reste mais n'a pas d'éditeur dédié pour eux.
- Références de ressources : les fichiers se nomment les uns les autres sous la forme
{GUID}path. La page trouve le fichier par son chemin et ignore le GUID, en cherchant d'abord dans votre projet, puis dans les données du jeu, puis à côté du fichier ouvert (le chemin joint à chaque dossier au-dessus de lui) : le graphe et le template d'un mod s'ouvrent ensemble même quand le dossier du mod n'est pas un espace de travail. - Variables et commandes : les scripts pilotent un graph grâce à elles : les commandes sont testées avec
IsCommand(…)/GetCommandF(…), les variables sont utilisées par nom dans les conditions, les poids de blend et les nœuds VarUpdate. - Comment le jeu choisit une configuration : d'après les notes de format de ce projet, les classes d'infectés et d'animaux nomment leur graph et leur instance par défaut dans une classe de config
enfanimsys(graphName,defaultInstance), et les instances du joueur par objet en main sont enregistrées depuis un script (DayZPlayerTypeRegisterItems).
Référence : les pages Animation Editor du wiki communautaire de Bohemia Interactive (DayZ Workbench).
Pièges
- Les modifications ne sont pas testées en jeu. La page n'écrit que les lignes que vous changez et laisse le reste du fichier octet pour octet, mais savoir si le jeu accepte un graph modifié, c'est à vous de le vérifier en jeu.
- Graphs anciens. Les fichiers à l'ancienne syntaxe
$AnimGraphs'ouvrent et s'enregistrent sans changement ; le canevas de nœuds ne les lit pas et le dit. - Les fichiers du jeu ne peuvent pas être enregistrés. Enregistrer est désactivé tant qu'un fichier modifié vient des données du jeu. Copiez d'abord les fichiers dans votre projet.
- Renommage. Renommer un nœud dans l'inspecteur renomme aussi les liens qui y mènent. En supprimer un ne supprime pas les liens : ils apparaissent dans Problèmes.
- Les noms de nœuds sont uniques dans tout le graph, pas par feuille : le bouton Nœud reste désactivé tant que le nom est pris.
- L'aperçu d'un clip est un squelette en lignes vu du côté que vous choisissez avec Rotation : pas de maillage, pas de mélange entre clips. Un clip prévisualisé sur le mauvais modèle a l'air cassé.
- Quelqu'un d'autre a modifié un fichier. Si un fichier a changé sur le disque après son ouverture, Enregistrer s'arrête et propose Recharger ou Enregistrer quand même. Chaque enregistrement conserve les fichiers précédents dans
.beans-anim-backups/à côté d'eux. - La liste Jeu est plafonnée à 400 fichiers par type : restreignez la recherche pour trouver un clip.
- Quitter la page garde les fichiers ouverts, leurs modifications non enregistrées et leur historique d'annulation ; la lecture se met en pause jusqu'à votre retour.
Pour les agents
Outils de dzt qui font le même travail sans la fenêtre :
anim_info: inspecter un.aw,.agr,.agf,.ast,.asiou.anm(chemin de fichier ou chemin virtuel du jeu commedz\anims\workspaces\…) : les fichiers chargés, variables, commandes, feuilles et nœuds, groupes du template, lignes d'instance ; pour un clip son format, fps, images, os et événements.anim_validate: les vérifications de l'onglet Problèmes sur une configuration et les fichiers qu'elle référence : liens de nœuds pendants, transitions vers des états inconnus, noms Source / GroupSelect absents du template, commandes et variables non déclarées (y compris les variables lues par les conditions des transitions et des états), noms de nœuds en double, lignes d'instance ne correspondant à aucun slot, clips manquants et fichiers référencés manquants. Un même message venu de plusieurs transitions est listé une fois, avec le nombre.vfs_searchavec"ext"valantaw,agr,agf,ast,asiouanm: trouver les fichiers du jeu ;vfs_readrenvoie le texte des formats texte.
Fichiers que la page lit et écrit :
- Lit les fichiers d'animation des dossiers de workspace et des PBO du jeu, plus les fichiers qu'ils référencent, et les modèles d'aperçu (
.xob) pour le squelette de la visionneuse de clips. - Écrit uniquement les fichiers texte modifiés qui existent sur le disque (
.aw,.agr,.agf,.ast,.asi). Avant d'écrire, la version précédente de chacun va dans.beans-anim-backups/<time>/à côté. Les clips ne sont jamais écrits. - Les fichiers ouverts sont surveillés : une modification faite par un autre programme est rechargée (ou signalée, si vous avez des modifications non enregistrées).
Ce que la page dit à l'assistant : le fichier ouvert, le clip ouvert le cas échéant, l'onglet courant (graph, variables, sets, problèmes), s'il y a des modifications non enregistrées, et les problèmes de validation (erreurs et avertissements). Elle propose l'action « Expliquer ce graph ».
Ancres des étapes guidées : animations-save, animations-browser, animations-source, animations-open, animations-main, animations-tabs, animations-graph-bar, animations-graph, animations-slots, animations-inspector, animations-clip, animations-timeline, animations-bones.
Voir aussi
- Modèles : le squelette et le model.cfg du modèle sur lequel joue une animation.
- Éditeur de scripts : les scripts qui définissent les variables et commandes d'un graph.
- Config (CfgConvert) : les classes de config qui nomment un graph et une instance.
- Packer PBO : extraire les fichiers du jeu pour travailler sur des copies, et empaqueter votre mod.
- Le Workbench