====== 3. Le tableau de bord ======

Dans la cabine de pilotage, on a sous les yeux une **vitesse**, une **distance restante**, un niveau de **charbon**, un état de **fatigue**. Plutôt que de répéter ces chiffres dans chaque description de lieu, on peut les afficher en permanence dans les **coins de l’écran** : c’est le //cartouche//.

===== Un compteur affiché par défaut =====

Le strict minimum : déclarer un compteur, puis dire qu’il est //affiché//. Sans précision, il se place en **haut à droite**.

<code donjon>
La vitesse est un compteur initialisé à 95 avec l’unité kmh.
La vitesse est affichée.
</code>

[[djnc>wiki_tuto-train_03_a_cartouche_simple|tester cet exemple]]

L’unité (''kmh'' dans cet exemple) est utilisée par le cartouche pour formater la valeur. Vous pouvez aussi la masquer si elle vous gêne : ''La vitesse est affichée sans unité.''. Idem pour le titre : ''sans titre''.

===== Plusieurs zones simultanées =====

Il y a **quatre coins** disponibles. On les nomme par couple //haut/bas// + //gauche/droite//.

<code donjon>
La vitesse est un compteur initialisé à 95 avec l’unité kmh.
La vitesse est affichée en haut à droite.

L’énergie est un compteur initialisé à 80 avec l’unité points.
L’énergie est affichée en bas à droite.

La distance est un compteur initialisé à 312 avec l’unité km.
La distance est affichée en haut à gauche.

Le charbon est un compteur initialisé à 47 avec l’unité kg.
Le charbon est affiché en bas à gauche.
</code>

[[djnc>wiki_tuto-train_03_b_cartouche_multi|tester cet exemple]]

Quatre indicateurs, quatre coins — on garde la scène centrale pour la narration, et toutes les données « techniques » restent visibles en périphérie. Très utile pour un escape game à compte à rebours, un RPG avec PV/PM, ou un jeu d’économie.

===== À retenir =====

  * Cartouche : ''<compteur> est affiché en {haut|bas} à {gauche|droite}.''.
  * Position par défaut (juste ''est affiché.'') : **haut à droite**.
  * Options : ''sans titre'', ''sans unité'' (cumulables avec ''et''). Le titre par défaut est le nom du compteur ; on peut le remplacer.
  * Les **propriétés numériques** (chapitre 2) ne sont pas affichables en cartouche — seuls les **compteurs** le sont. C’est une distinction utile à garder en tête.

Suite : [[tutoriels:train:partie4_temps|4. Le train tourne, le temps file]]