Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fr:yaml:hud [2026/08/31 21:09] – Wiki : fins de pages homogènes, liens Discord retirés cyrilfiesta
+++ fr:yaml:hud [2026/11/04 23:31] (Version actuelle) – Documentation 4.17 : objets, evenements et mise en page verifies cyrilfiesta
@@ Ligne 1: / Ligne 1: @@
 **Language / Langue :** **FR** | [[en:yaml:hud|EN]]
-====== HUD - Encadrés persistants (YAML) ======
+====== HUD - Encadrés (YAML) ======
 Les encadrés HUD (''encadre:'') permettent d'afficher des informations permanentes à l'écran du joueur : PV, score, mini-carte, compte à rebours, etc.
-⚠ Les encadrés sont visibles sur **web et desktop uniquement**. Sur Discord et terminal, ils sont ignorés - si une information est essentielle, écrivez-la aussi dans le texte narratif.
+Les encadrés sont visibles sur **web et desktop uniquement**. Sur Discord et terminal, ils sont ignorés - si une information est essentielle, écrivez-la aussi dans le texte narratif.
 ===== Positions disponibles =====
 positions :
-  * ''haut'' · ''bas'' · ''gauche'' · ''droite''
+  * ''haut'' / ''bas'' / ''gauche'' / ''droite''
-  * ''haut-gauche'' · ''haut-droite'' · ''bas-gauche'' · ''bas-droite''
+  * ''haut-gauche'' / ''haut-droite'' / ''bas-gauche'' / ''bas-droite''
-Les bandes (''haut'', ''bas''…) remplacent les coins correspondants si elles coexistent.
+Les bandes (''haut'', ''bas''...) remplacent les coins correspondants si elles coexistent.
 ===== Syntaxe de base =====
@@ Ligne 42: / Ligne 42: @@
 ^ Clé ^ Effet ^
-| ''taille: 30'' | 30 % de la zone de jeu dans l'axe principal |
+| ''taille: 30'' | 30 % de la zone de jeu : hauteur en haut/bas, largeur sur les côtés et dans les coins |
 | ''largeur: 25'' | Largeur explicite en % |
 | ''hauteur: 15'' | Hauteur explicite en % |
@@ Ligne 48: / Ligne 48: @@
 ''largeur:'' et ''hauteur:'' sont indépendants - on peut en spécifier un seul.
 Si aucun n'est précisé : valeur par défaut selon la position.
+Sur mobile, les bandes latérales deviennent des bandes en haut/bas : leur taille règle alors la hauteur.
 ===== Style =====
@@ Ligne 65: / Ligne 67: @@
 <code yaml>
+vars: {pv: 10, pvmax: 10}
 encadre:
   position: haut-droite
@@ Ligne 77: / Ligne 80: @@
 ===== Split : deux zones côte à côte =====
-''[[split]]'' dans le texte divise l'encadré en deux zones. L'ordre dépend de la position :
+''%%[[split]]%%'' dans le texte divise l'encadré en deux zones. L'ordre dépend de la position :
-  * ''gauche/droite'' → zone haut / zone bas
+  * ''gauche/droite'' > zone haut / zone bas
-  * ''haut/bas'' → zone gauche / zone droite
+  * ''haut/bas'' > zone gauche / zone droite
 <code yaml>
@@ Ligne 93: / Ligne 96: @@
 </code>
-Les images ''[[url]]'' sont supportées dans les zones.
+Les images ''%%[[url]]%%'' sont supportées dans les zones.
 ===== Plusieurs encadrés simultanés =====
@@ Ligne 110: / Ligne 113: @@
 <code yaml>
-# Sur un choix ou événement :
+# Sur une salle, un choix ou un événement :
 supprimer-encadre:
   - all          # supprime tous les encadrés
-  # ou :
+</code>
-  - haut-droite  # supprime uniquement ce coin
-# Sur une salle :
+Pour ne supprimer qu'un coin :
+<code yaml>
 supprimer-encadre:
-  - all
+  - haut-droite
 </code>
@@ Ligne 130: / Ligne 134: @@
   texte:
     - "((loop;muted:https://exemple.com/video.mp4))"
+</code>
+===== Portée limitée à la salle (4.17) =====
+**Par défaut, les encadrés restent persistants**, jusqu'à leur remplacement ou leur suppression explicite. Pour effacer un encadré en quittant la salle qui l'a posé, ajouter ''portee: salle'' :
+<code yaml>
+encadre:
+  position: haut-gauche
+  portee: salle
+  texte: Le plan de cette pièce.
+</code>
+Cette option fonctionne sur les salles, actions, choix et événements, y compris globaux : la salle de rattachement est celle où l'encadré est effectivement posé. Une action sans déplacement, un rafraîchissement ou un retour vers la même salle ne l'efface pas. Un déplacement, le retour téléphone ou la fin de partie le retire. Les autres encadrés persistants restent affichés.
+Un encadré déclaré sur la salle est reposé à chaque entrée. Un encadré créé par une interaction attend que celle-ci soit exécutée à nouveau. Un encadré remplacé n'est pas restauré automatiquement. La sauvegarde conserve la portée et la salle de rattachement ; les anciens encadrés sans portée gardent leur comportement persistant.
+Dans l'éditeur, cocher **Effacer en quittant la salle** sur l'encadré. La case est décochée par défaut. La portée reste facultative dans les [[fr:yaml:modeles|modèles sur place]] ; ''grille_2d'' la demande explicitement. En anglais : ''scope: room''.
+===== Pourcentage et alignement dans un encadré =====
+À côté de ''%%[[split]]%%'', la forme ''%%[[split:40]]%%'' réserve 40 % à la zone précédente. Le partage suit l'axe de l'encadré. Les blocs ''%%[[align:centre]]texte[[/align]]%%'' acceptent aussi ''gauche'' / ''droite'', ''left'' / ''center'' / ''right'', ou une variable textuelle ''t_cote_t''.
+<code yaml>
+titre: 'Wiki 4.17 : HUD'
+vars:
+  pv: 10
+salles:
+- id: atelier
+  texte: Un coffre.
+  encadre:
+    position: haut
+    texte: |
+      [[align:centre]]Carte.[[/align]]
+      [[split:40]]
+      PV : v_pv_v
+  choix:
+  - commande: rester
+    bouton: Rester
+    vers: atelier
 </code>