Différences

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

--- fr:yaml:hud [2026/10/19 01:43] – Wiki 4.17 : corrections apres audit des exemples et traductions 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.
@@ Ligne 67: / Ligne 67: @@
 <code yaml>
+vars: {pv: 10, pvmax: 10}
 encadre:
   position: haut-droite
@@ Ligne 79: / 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
   * ''haut/bas'' > zone gauche / zone droite
@@ Ligne 95: / 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 133: / 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>