Studio de styles

Tutoriel (en anglais) · 3:07

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

Premiers pas

  1. Ouvrez le Studio de styles. Deux exemples s'y trouvent : MyPanel et MyButton.
  2. Cliquez sur MyButton. Dans le panneau de droite, changez Survol : l'image de survol de sa carte change.
  3. Renommez-le (par exemple MyModButton) : c'est le nom que les layouts utiliseront.
  4. Dans Générer, définissez Nom de sortie avec un nom court de votre mod, par exemple mymod.
  5. Choisissez le Dossier de sortie : un dossier dans votre mod, par exemple MyMod/gui/looknfeel.
  6. Cliquez sur Générer. Les fichiers sont écrits et le Workbench relit sa liste de styles.
  7. 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.
  8. Listez le .imageset et le .styles générés dans le config.cpp du mod (voir Concepts), puis choisissez le style dans la propriété style de l'Éditeur de layouts.

Faire la visite (dans l'app)

Tâches courantes

Ajouter un style pour un autre type de widget

  1. Cliquez sur + dans l'en-tête Styles.
  2. Dans le panneau de droite, donnez-lui un nom et choisissez son Type : panel, button, editbox, checkbox, slider ou progressbar.
  3. 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.
  4. Vérifiez chaque état sur sa carte.

Changer un seul état

  1. Ouvrez l'onglet JSON.
  2. Dans le style, ajoutez "states": { "highlight": { "bg": "#262019" } }. Les clés d'état sont highlight, pushed, focus, disabled, checked et fill.
  3. Revenez à Aperçu pour le voir.

Trouver un style qui existe déjà

  1. Ouvrez l'onglet Bibliothèque.
  2. Choisissez la classe de widget (par exemple ButtonWidget) et, si vous ne voulez que ceux du jeu, la source Vanilla.
  3. Cliquez sur la ligne du style qui vous plaît : son nom est copié.
  4. Collez-le dans la propriété style d'un widget dans l'Éditeur de layouts, ou dans data-style en DZML.

Régénérer après un changement

  1. 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.
  2. Changez les couleurs.
  3. Cliquez sur Générer, puis sur Enregistrer. Les noms de fichiers ne changent pas, donc config.cpp reste tel quel.

Dessiner une icône

  1. Cliquez sur Nouvelle icône.
  2. 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.
  3. Vérifiez l'aperçu en 32, 64 et 128 px sur fond sombre et clair.
  4. Donnez un nom, le dossier du mod, éventuellement l'imageset où l'ajouter, et la taille. Cliquez sur Enregistrer l'icône.
  5. 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

Concepts

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 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