====== Afficher (écran) ======

//Cette instruction permet d’afficher un écran de jeu spécifique.//

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

===== Écran principal =====

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.
</code>

Pour revenir à l’écran principal, utilisez l’une des 2 instructions suivantes :

<code donjon>
afficher l’écran principal.
</code>

<code donjon>
afficher l’écran précédent.
</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 à tester ======

Un journal consulté sur l’écran temporaire : son contenu ne pollue pas l’historique de l’écran principal, qu’on retrouve intact en revenant.

<file donjon wiki_instructions_ecrans>
Le bureau est un lieu.

action consulter le journal:
  afficher l'écran temporaire.
  dire "— Journal de bord — Jour 12 : rien à signaler.".
  attendre une touche.
  afficher l'écran précédent.
fin action

règle avant commencer le jeu:
  dire "Essayez : {/consulter le journal/}.".
fin règle
</file>

[[djnc>wiki_instructions_ecrans|tester cet exemple]]

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

{{tag>afficher ecran écran ecrans écrans principal secondaire temporaire precedent précédent historique instruction instructions}}