Différences

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

--- reference:instructions:afficher_ecran [2022/12/26 16:58] – créée jonathan
+++ reference:instructions:afficher_ecran [2022/12/26 17:23] (Version actuelle) – jonathan
@@ Ligne 3: / Ligne 3: @@
 //Cette instruction permet d’afficher un écran de jeu spécifique.//
-Il y a 3 écrans disponibles :
+Changer d’écran vous permet de produire différents effets spéciaux durant votre jeu car chaque écran a son historique qui lui est propre.
+Vous pouvez par exemple changer d’écran lorsque vous changez le point de vue du joueur (autre dimension, autre personnage contrôlé par le joueur, …)
+===== Les différents écrans =====
+Il y a 3 écrans disponibles :
   * principal
   * secondaire
   * temporaire
-En début de partie, c’est l’écran principal qui est affiché.
+===== Écran principal =====
-Si vous souhaitez afficher l’écran secondaire, utilisez l’instruction suivante :
+En début de partie, c’est l’écran principal qui est affiché. L’historique de cet écran est conservé.
+===== Écran secondaire =====
+Cet écran se comporte comme l’écran principal mais il possède un historique qui lui est propre.
+Si vous souhaitez afficher l’écran secondaire, utilisez l’instruction suivante :
 <code donjon>
 afficher l’écran secondaire.
@@ Ligne 26: / Ligne 37: @@
 </code>
+===== Écran temporaire =====
+Cet écran est particulier car son historique n’est pas conservé lorsque l’écran n’est plus affiché.
+Cela vous évite d’avoir à le vider chaque fois que vous l’utilisez.
+Il est par exemple utilisé par l’instruction « faire une pause » pour afficher la mention « partie interrompue » à la place de la sortie du jeu.
+Pour afficher l’écran temporaire utilisez l’instruction suivante :
+<code donjon>
+afficher l’écran temporaire.
+</code>
+Pour revenir à l’écran précédent, utilisez l’instruction suivante :
+<code donjon>
+afficher l’écran précédent.
+</code>
+Vous pouvez aussi spécifier directement l’écran à afficher.
+====== Exemple d’utilisation ======
+Voici l’action « faire une pause » :
+<code donjon>
+-- ==========
+--   FAIRE
+-- ==========
+action faire ceci:
+  définitions:
+    ceci est un intitulé.
+  phase prérequis:
+    si ceci ne vaut pas une pause, refuser "Je sais seulement faire une pause.".
+  phase exécution:
+    si ceci vaut une pause:
+      interrompre la partie.
+      dire "{/Partie interrompue./}".
+      afficher l’écran temporaire.
+      dire "Jeu en pause.".
+      attendre une touche.
+      continuer la partie.
+      afficher l’écran précédent.
+      dire "{/Reprise de la partie./}".
+    fin si
+fin action
+</code>