Éditeur de layouts

Tutoriel (en anglais) · 3:02

L'Éditeur de layouts construit les écrans d'un mod : menus, éléments de HUD, boîtes de dialogue. Un écran de DayZ est un fichier .layout, un arbre de widgets (frames, panneaux, textes, boutons, images) qu'un script crée et remplit. Ici, vous modifiez cet arbre sur un canevas dessiné avec les polices, images et styles du jeu, ou vous écrivez l'écran en DZML, une forme HTML qui se compile en .layout. Il ne faut rien pour commencer : la page s'ouvre sur un layout vide. Avec le dossier DayZ défini dans les Paramètres, les layouts du jeu s'ouvrent en lecture seule comme exemples, et leurs images et styles sont affichés.

L'écran

Premiers pas

  1. Ouvrez l'Éditeur de layouts. Un layout vide nommé untitled.layout est prêt, avec un frame racine.
  2. Dans la palette, cliquez sur Panel : un panneau est ajouté dans la racine. Glissez-le sur le canevas et redimensionnez-le par ses bords.
  3. Le panneau étant sélectionné, cliquez sur Text dans la palette : le texte est ajouté dans le panneau. Dans Propriétés, définissez son text.
  4. Donnez un nom aux deux widgets dans Propriétés (F2) : les scripts trouvent les widgets par leur nom.
  5. Regardez l'onglet Problèmes et corrigez ce qu'il liste.
  6. Appuyez sur F5 pour voir l'écran sans les repères de l'éditeur, Échap pour revenir.
  7. Cliquez sur Enregistrer (Ctrl+S) et écrivez le fichier dans votre mod, par exemple MyMod/gui/layouts/my_panel.layout.

Faire la visite (dans l'app)

Tâches courantes

Démarrer un menu en DZML

  1. Cliquez sur + dans la barre d'onglets et choisissez Document DZML (HTML). Un panneau avec un titre et un bouton Fermer s'ouvre sur son HTML.
  2. Modifiez le HTML ; passez à Design pour voir et ajuster le résultat.
  3. Enregistrez : la première fois, vous choisissez le nom du .html, dans votre mod.
  4. Cliquez sur Compiler et acceptez le .layout proposé à côté du .html. Une page avec des modèles de lignes obtient aussi un <page>_<row>.layout par modèle.
  5. Dans l'onglet Script, gardez le type « Menu » et cliquez sur Écrire dans le mod : la classe est écrite sous scripts/5_Mission/<Mod>/GUI/ (le chemin est modifiable ; un fichier existant n'est remplacé qu'après votre confirmation).

Étudier un layout du jeu

  1. Cliquez sur Parcourir les layouts du jeu (la loupe) et saisissez une partie du nom, par exemple inventory.
  2. Cliquez sur un résultat : il s'ouvre en lecture seule dans un onglet, avec le badge « Fichier du jeu ».
  3. Cochez Masqués pour voir les widgets que les scripts affichent à l'exécution ; utilisez Source pour lire le texte.
  4. Pour garder une copie modifiée, cliquez sur Enregistrer : il demande où l'écrire. Le fichier du jeu n'est jamais modifié.

Vérifier un écran à plusieurs résolutions

  1. Dans la barre d'outils du canevas, choisissez une autre résolution (1280 × 720, 2560 × 1440, 3840 × 2160, un format ultra-large et un format portrait sont listés).
  2. Observez ce qui bouge : les tailles en % suivent l'écran, les tailles en pixels non.
  3. Choisissez une zone de sécurité (95, 90 ou 85 %) pour voir où les écrans de console peuvent couper l'image.
  4. Jouer a le même sélecteur de résolution.

Convertir un layout existant en DZML

  1. Ouvrez le .layout.
  2. Cliquez sur Vers DZML et choisissez où écrire le .html (à côté du layout par défaut).
  3. Le nouveau document s'ouvre. Ne touchez plus au .layout à partir de maintenant : il est produit par Compiler.

Réutiliser un groupe de widgets

  1. Sélectionnez les widgets (Ctrl+clic, ou tracez un rectangle sur une zone vide).
  2. Dans l'onglet Widgets, cliquez sur l'icône d'enregistrement de Prefabs et nommez-le.
  3. Dans n'importe quel document, cliquez sur le prefab pour l'insérer dans la sélection, ou glissez-le sur le canevas ou la hiérarchie.

Générer le script d'un layout

  1. Enregistrez le layout dans un mod (un dossier avec un $PBOPREFIX$ ou un config.cpp) : l'éditeur connaît alors le chemin que le jeu utilisera.
  2. Ouvrez l'onglet Script et choisissez le type : un menu ouvert avec ShowScriptedMenu, ou un handler pour un sous-panneau.
  3. Copiez la classe, ou cliquez sur Écrire dans le mod, puis Ouvrir dans Scripts.

Exemples

Concepts

Deux manières de travailler : le .layout ou DZML

Un .layout devient du DZML avec Vers DZML ; une page DZML devient un .layout avec Compiler. Faire la visite de DZML (dans l'app)

Notions du jeu

Référence : le wiki communautaire de Bohemia Interactive (DayZ Workbench, GUI editor) et docs/FORMATS.md de ce projet.

Pièges

Pour les agents

Outils de dzt qui font le même travail sans la fenêtre :

Fichiers :

Ce que la page dit à l'assistant : le fichier ouvert (ou untitled.layout), le widget sélectionné sous la forme name (class), la vue (design, source ou browser preview), la résolution du canevas, s'il y a des modifications non enregistrées, et les messages de l'onglet Problèmes. Elle propose une action à l'assistant, « Vérifier ce layout ».

Les ancres des visites et du pointage sont listées dans le fichier de guide de la page (layout-palette, layout-hierarchy, layout-canvas, layout-inspector, layout-save, layout-play...).

Voir aussi