Tuiles et tilemaps

Les tuiles permettent d'extraire une case d'une spritesheet. Les tilemaps assemblent plusieurs tuiles dans une grille, directement dans le texte ou dans un encadré persistant.

texte: "Tuile : [[/scenarios/images/test/tiles.png:4x4:1:2]]"

La forme complète est [[url:NxM:col:row]].

• N est le nombre de colonnes de la spritesheet.
• M est le nombre de lignes de la spritesheet.
• col et row sont les coordonnées de la tuile, en partant de 0.

Dans le texte, une tuile s'affiche à sa taille réelle : elle n'est jamais agrandie sans que vous l'ayez demandé. Seule une tuile trop grande pour la zone de texte est réduite. Un clic l'agrandit en n'affichant que la case choisie, pas la spritesheet entière.

La règle vaut pour tous les supports, y compris la pièce jointe produite par Discord.

Cette grille 3×2 contient 3 colonnes et 2 lignes. Elle mélange des images directes et des cases extraites du tileset 8×16 du showcase :

texte: |
  [[grid:3x2]]
  https://cyril-fiesta.fr/jdr-bot/scenarios/images/showcase/un.png | https://cyril-fiesta.fr/jdr-bot/scenarios/images/showcase/tileset-8-16.png:8x16:0:2 | https://cyril-fiesta.fr/jdr-bot/scenarios/images/showcase/un.png
  https://cyril-fiesta.fr/jdr-bot/scenarios/images/showcase/tileset-8-16.png:8x16:0:4 | https://cyril-fiesta.fr/jdr-bot/scenarios/images/showcase/un.png | https://cyril-fiesta.fr/jdr-bot/scenarios/images/showcase/tileset-8-16.png:8x16:3:6
  [[/grid]]

Les dimensions après grid: décrivent la grille assemblée ; celles après une URL d'image décrivent sa planche source. N'entourez pas les cellules individuelles de [[…]]. Chaque ligne fournit une rangée de trois cellules séparées par |.

Chaque cellule contient soit une tuile extraite avec url:NxM:col:row, soit une image directe. Les cellules sont séparées par |.

Les coordonnées peuvent utiliser des variables entre accolades. C'est utile pour une mini-carte ou un HUD mis à jour par des événements.

encadre: |
  [[grid:3x3]]
  /scenarios/images/test/tiles.png:4x4:0:0 | /scenarios/images/test/tiles.png:4x4:1:0 | /scenarios/images/test/tiles.png:4x4:2:0
  /scenarios/images/test/tiles.png:4x4:0:1 | /scenarios/images/test/tiles.png:4x4:{map_x}:{map_y} | /scenarios/images/test/tiles.png:4x4:2:1
  /scenarios/images/test/tiles.png:4x4:0:2 | /scenarios/images/test/tiles.png:4x4:1:2 | /scenarios/images/test/tiles.png:4x4:2:2
  [[/grid]]

Les grilles placées dans encadre: sont rafraîchies avec la salle, comme les autres informations persistantes.

• Si la grille contient moins de cellules que prévu, les cases manquantes sont remplies par des emplacements blancs.
• Si des tuiles de tailles différentes sont mélangées, la case adopte la taille de la plus petite : une grande illustration se réduit au format des tuiles, plutôt que de leur imposer le sien.
• Plusieurs cellules peuvent utiliser la même spritesheet, y compris lorsqu'elle est déjà en cache.
• Le linter signale les grilles incomplètes.
• Sur les adaptateurs qui ne peuvent pas afficher une tilemap interactive, un rendu de secours est utilisé.