Studio de styles
Le Studio de styles fabrique l'aspect de vos widgets. Un bouton ou un panneau du jeu est dessiné à partir d'un style : une petite image étirée à la taille du widget, avec une variante par état (survolé, appuyé, désactivé...). Ici, vous décrivez des styles avec quelques couleurs et un rayon de coin, vous les voyez en direct, et vous générez les trois fichiers dont le jeu a besoin : un atlas de textures, un .imageset et un fichier .styles. La page liste aussi tous les styles que le jeu et vos mods définissent déjà, et dessine des icônes d'UI. Vous en avez besoin quand les styles vanilla ne suffisent pas pour une UI faite dans l'Éditeur de layouts. Rien n'est requis pour commencer : la page s'ouvre sur deux styles d'exemple.
L'écran
- En-tête : un sélecteur des configs de styles trouvées dans vos workspaces, Ouvrir (un fichier de config), Nouveau (retour aux deux exemples), Nouvelle icône (la boîte de dialogue d'icône) et Enregistrer (la config ; une étoile marque les modifications non enregistrées).
- Panneau de gauche, Styles : les styles de la config, chacun avec sa couleur d'arrière-plan et son type. Les boutons de l'en-tête ajoutent un style, dupliquent ou suppriment celui qui est sélectionné.
- Au centre, onglet Aperçu : une carte par style, avec une image par état de son type. Cliquez sur une carte pour sélectionner le style.
- Au centre, onglet JSON : toute la config sous forme de texte. Une modification est appliquée dès qu'elle est analysable ; une erreur s'affiche dans l'éditeur. Les surcharges par état et les rayons par coin ne sont modifiables qu'ici.
- Au centre, onglet Bibliothèque : chaque style du jeu et des workspaces : un aperçu, le nom, la classe de widget, la source (Vanilla ou un dossier de workspace), les états et l'imageset (vert quand il est trouvé, rouge quand il manque). Filtrez par texte, source ou classe de widget. Cliquez sur une ligne pour copier le nom du style.
- Panneau de droite, Style : nom, type, rayon et découpe du style sélectionné, puis ses couleurs : Arrière-plan, Bordure, Survol, Actif, Focus, Coché, Remplissage et quatre barres d'accent (gauche, droite, haut, bas). Chaque couleur a un sélecteur et un champ de texte ; vide signifie « aucune ».
- Panneau de droite, Générer : nom de sortie, chemin de texture, échelle (1×, 2×, 4×), les formats (PNG, EDDS, CSS DZML), le dossier de sortie et le bouton Générer. Les avertissements de la dernière génération sont listés sous le bouton.
Premiers pas
- Ouvrez le Studio de styles. Deux exemples s'y trouvent :
MyPaneletMyButton. - Cliquez sur
MyButton. Dans le panneau de droite, changez Survol : l'image de survol de sa carte change. - Renommez-le (par exemple
MyModButton) : c'est le nom que les layouts utiliseront. - Dans Générer, définissez Nom de sortie avec un nom court de votre mod, par exemple
mymod. - Choisissez le Dossier de sortie : un dossier dans votre mod, par exemple
MyMod/gui/looknfeel. - Cliquez sur Générer. Les fichiers sont écrits et le Workbench relit sa liste de styles.
- Cliquez sur Enregistrer pour garder la config sous forme de fichier JSON, à côté des fichiers générés ou n'importe où dans le mod.
- Listez le
.imagesetet le.stylesgénérés dans leconfig.cppdu mod (voir Concepts), puis choisissez le style dans la propriétéstylede l'Éditeur de layouts.
Faire la visite (dans l'app)
Tâches courantes
Ajouter un style pour un autre type de widget
- Cliquez sur + dans l'en-tête Styles.
- Dans le panneau de droite, donnez-lui un nom et choisissez son Type : panel, button, editbox, checkbox, slider ou progressbar.
- Renseignez les couleurs que ses états utilisent : Survol et Actif pour un bouton, Focus pour un champ de saisie ou un slider, Coché pour une case à cocher, Remplissage pour une barre de progression.
- Vérifiez chaque état sur sa carte.
Changer un seul état
- Ouvrez l'onglet JSON.
- Dans le style, ajoutez
"states": { "highlight": { "bg": "#262019" } }. Les clés d'état sonthighlight,pushed,focus,disabled,checkedetfill. - Revenez à Aperçu pour le voir.
Trouver un style qui existe déjà
- Ouvrez l'onglet Bibliothèque.
- Choisissez la classe de widget (par exemple
ButtonWidget) et, si vous ne voulez que ceux du jeu, la sourceVanilla. - Cliquez sur la ligne du style qui vous plaît : son nom est copié.
- Collez-le dans la propriété
styled'un widget dans l'Éditeur de layouts, ou dansdata-styleen DZML.
Régénérer après un changement
- Ouvrez la config depuis le sélecteur de l'en-tête ou avec Ouvrir. Le dossier de sortie est défini sur le dossier de la config s'il était vide.
- Changez les couleurs.
- Cliquez sur Générer, puis sur Enregistrer. Les noms de fichiers ne changent pas, donc
config.cppreste tel quel.
Dessiner une icône
- Cliquez sur Nouvelle icône.
- Choisissez un modèle et modifiez son glyphe (éléments SVG sur une grille de 24 × 24), ou choisissez « SVG personnalisé » et collez un document SVG entier.
- Vérifiez l'aperçu en 32, 64 et 128 px sur fond sombre et clair.
- Donnez un nom, le dossier du mod, éventuellement l'imageset où l'ajouter, et la taille. Cliquez sur Enregistrer l'icône.
- La boîte de dialogue affiche alors la ligne à utiliser dans un layout. Une icône ajoutée à un imageset demande aussi que cet imageset soit listé dans
config.cpp.
Le deuxième onglet de la boîte de dialogue demande une icône réaliste à un modèle d'image. Il faut une clé OpenRouter (mode développeur), elle est facturée sur cette clé, et le bouton indique le prix estimé avant que rien ne soit envoyé.
Exemples
- Un kit d'UI complet (dans l'app) : une config avec un style de chaque type. Regardez les couleurs qu'utilise chaque type et les états sur les cartes. Elle est chargée en mémoire seulement.
- Les styles du jeu (dans l'app) : la Bibliothèque sur les styles vanilla. Voyez combien d'aspects existent avant de dessiner le vôtre.
- Styles de boutons vanilla (dans l'app) : pareil, pour
ButtonWidgetuniquement.
Concepts
- Style : un aspect nommé pour une classe de widget, avec une image par état. Un widget d'un layout l'utilise avec
style <Name>(data-style="<Name>"en DZML). Les noms de styles sont cherchés par classe de widget : un style de bouton n'est pas un style de panneau. - .styles : le fichier qui déclare les styles : pour chaque classe de widget, les noms de styles et, par état, l'image à dessiner. Ceux du jeu sont dans
gui/looknfeel/dayzwidgets.styles. Ici, le fichier généré est<output>_styles.styles. - Imageset : un fichier
.imagesetdécoupe une texture (l'atlas) en rectangles nommés. Un layout y fait référence avecset:NAME image:IMG. Ici, le fichier généré est<output>_ui.imageset, et le chemin de sa texture est le champ Chemin de texture : le chemin de l'atlas tel que le jeu le voit (préfixe de votre mod + dossier + fichier). - Atlas : la texture unique contenant chaque état de chaque style :
<output>_atlas.svg, plus.pnget.eddsquand ils sont cochés. EDDS est le format que charge le jeu. - 9-slice : l'image d'un état est découpée en neuf parties : quatre coins gardés à leur taille, quatre côtés étirés dans une direction, le centre étiré dans les deux. Une petite image peut ainsi habiller un widget de n'importe quelle taille sans déformer ses coins. Découpe est la taille des coins (0 à 3 pixels d'atlas, 3 par défaut) ; le rayon ne peut pas la dépasser.
- États : un bouton a normal, survol et actif ; un champ de saisie et un slider ont normal, focus et désactivé ; une case à cocher a normal, coché et désactivé ; une barre de progression a normal, remplissage et désactivé ; un panneau a normal et désactivé.
- Déclaration dans config.cpp : le jeu ne charge que les fichiers
.styleset.imagesetqu'un mod liste dansCfgMods> sa classe >class defs:class widgetStyles { files[] = {...}; };etclass imageSets { files[] = {...}; };, avec des chemins en jeu. - CSS DZML :
dzml-styles.cssdonne les mêmes aspects à l'aperçu navigateur des pages DZML. Le jeu ne le lit pas.
Pièges
- Le style s'affiche dans le Workbench mais pas dans le jeu : ses fichiers ne sont pas listés dans
config.cpp. L'onglet Problèmes de l'Éditeur de layouts et l'outilui_style_checkle signalent. Non déclaré, un style retombe sur l'aspect par défaut et une image reste vide. - Chemin de texture laissé à sa valeur par défaut (
{GUID}<output>_atlas.edds) : l'imageset enregistre ce chemin pour son atlas. Vérifiez qu'il correspond à l'emplacement de l'atlas dans votre mod (par exempleMyMod/gui/looknfeel/mymod_atlas.edds). - Renommer un style ou le nom de sortie après que des layouts l'utilisent : les layouts font référence aux styles par leur nom et
config.cppaux fichiers par leur nom. Changez les deux. - Générer n'enregistre pas la config, et Enregistrer ne génère pas : ce sont deux boutons. La config (JSON) est ce que vous rouvrirez plus tard.
- Supprimer ne s'annule pas : un style supprimé est perdu, sauf si vous rouvrez la config enregistrée.
- Une découpe hors limites est ramenée dans la plage ; l'avertissement apparaît sous Générer.
- La config a changé sur le disque (l'assistant, un autre éditeur) : sans modifications locales, elle est relue ; avec des modifications, un bandeau vous laisse choisir.
Pour les agents
Outils de dzt qui font le même travail sans la fenêtre :
style_generate: à partir d'une config{output, texture, styles: [{name, type, bg, border, radius, hover, active, focus, checked, fill, left, right, top, bottom, states, slice}]}, écrit l'atlas,<output>_ui.imageset,<output>_styles.styleset le CSS DZML.style_preview: rend un style d'une config en PNG 9-slice à une taille et un état donnés.ui_style_check: vérifie que chaque style utilisé par les layouts d'un mod est défini et que ses.styleset.imagesetsont déclarés.icon_templates,icon_create: liste les modèles d'icônes, puis crée une icône dans un mod (EDDS, éventuellement dans un imageset).icon_generate: la variante payante avec modèle d'image.layout_render: voir un layout qui utilise les styles comme le jeu le dessinerait.vfs_readavecgui/looknfeel/dayzwidgets.styles: les styles du jeu.
Fichiers :
- Lus : la config (un fichier JSON avec un tableau
styles; le sélecteur de l'en-tête liste ceux trouvés dans les workspaces), et pour la Bibliothèque chaque.styleset.imagesetdu jeu et des workspaces. - Écrits : la config à Enregistrer ; à Générer, dans le dossier de sortie :
<output>_atlas.svg,<output>_atlas.pnget<output>_atlas.eddsquand ils sont cochés,<output>_ui.imageset,<output>_styles.styles, etdzml-styles.cssquand il est coché. La boîte de dialogue d'icône écrit les fichiers d'icône dans le dossier de mod choisi.
Ce que la page dit à l'assistant : le chemin de la config ouverte (vide quand elle n'est pas enregistrée), le nombre de styles, le style sélectionné sous la forme name (type), le dossier de sortie, s'il y a des modifications non enregistrées, et les avertissements de la dernière génération.
Les exemples du panneau d'aide sont des demandes que la page traite : kit charge la config d'exemple, library ouvre la Bibliothèque sur les styles vanilla, library:<WidgetClass> sur une classe de widget.
Voir aussi
- Éditeur de layouts : utiliser les styles et icônes dans un écran.
- Comment fonctionne DZML :
data-styleet le CSS d'aperçu. - Textures (PAA) : regarder un atlas ou une texture d'icône.