====== Afficher (image) ======

Cette instruction permet d’afficher des images dans votre jeu.

===== Instruction afficher une image =====
<code donjon>
afficher l'image affiche.png.
</code>

==== Afficher une image de couverture au lancement du jeu ====
<code donjon>
règle avant commencer le jeu:
  afficher l’image affiche.png.
  attendre touche.
  effacer l’écran.
fin règle
</code>

===== Inclure une image dans un texte =====
<code donjon>
L’ordinateur se trouve sur la table.
Sa description est "Votre ordinateur. Vous prenez le temps d'apprécier le logo de donjon.fi: [image logo.png] Il s’agit d’une tour.".
</code>

===== Emplacement des fichiers d’images =====

Le //nom des fichiers// ressources ne peut contenir que des lettres non-accentuées, des chiffres et des tirets.

==== Par défaut ====

Par défaut, vous devez placer les ressources du jeux dans le dossier ''./assets/ressources'' :
  * ''./assets/ressources/images/affiche.png''  (pour ''afficher l’image affiche.png;'')

==== Sous-dossier ====

Si vous mettez plusieurs jeux sur le même site web, vous pouvez définir un dossier spécifique pour chacun des jeux. Un même dossier peut-être réutilisé pour plusieurs jeux.

<code donjon>
-- Définition du dossier qui contient les ressources du jeu (ici « mon_donjon »):
Les ressources du jeu se trouvent dans le dossier mon_donjon.
</code>

Vous devez alors placer les ressources du jeu dans ce dossier ''./assets/ressources/mon_donjon'':
  * ''./assets/ressources/mon_donjon/images/affiche.png''  (pour ''afficher l’image affiche.png'')

==== Fichier manquant et exemples ====

Si un fichier image est manquant, cela n’empêche pas le reste du jeu de fonctionner normalement. Le nom de l’image s’affichera à la place de l’image elle-même.

Les images utilisées dans les exemples de cette page sont disponibles par défaut dans Donjon afin que vous puissiez faire des tests.

===== Exemple complet =====

<code donjon>
PARTIE "description du monde".

Le titre du jeu est "Mon Donjon".

avant commencer le jeu:
  -- A) INSTRUCTION AFFICHER UNE IMAGE:
  --    au lancement du jeu, afficher une image de couverture
  afficher l’image affiche.png.
  attendre touche.
  effacer l’écran.
  -- introduction
  dire "Vous allumez votre ordinateur et vous naviguez vers votre site préféré afin de vous lancer dans la création d’une fiction interactive !
    
        À présent vous êtes prêt à créer un monde merveilleux !".

Le bureau est un lieu.
La chaise est un support ici.
La table est un support ici.
L'ordinateur se trouve sur la table.
Interpréter ordi comme ordinateur.
-- B) INCLURE UNE IMAGES DANS UN TEXTE:
--    la description de l’ordinateur contient une image
Sa description est "Votre ordinateur. Vous prenez le temps d'apprécier le logo de donjon.fi: [image logo.png] Il s’agit d’une tour.".

PARTIE "emplacement des ressources du jeu"

-- Définition du dossier qui contient les ressources du jeu (ici « mon_donjon »):
Les ressources du jeu se trouvent dans le dossier mon_donjon.
</code>

[[djnb>ex_images| tester cet exemple]]