Ceci est une ancienne révision du document !
Table des matières
Language / Langue : FR | EN
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.
Extraire une tuile
texte: "Tuile : [[/scenarios/images/test/tiles.png:4x4:1:2]]"
La forme complète est [[url:NxM:col:row]].
Nest le nombre de colonnes de la spritesheet.Mest le nombre de lignes de la spritesheet.coletrowsont 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.
Assembler une grille
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 |.
Variables dynamiques
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.
Comportements utiles
- 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é.
Grille alimentée par une liste (4.17)
listes: images: [portrait.png, '', 'tiles.png:8x16:2:1'] salles: - id: galerie texte: '[[grid:3:images]]'
Le premier nombre donne les colonnes ; les lignes sont calculées. Chaque valeur est une adresse d'image ou de sprite, sans balises. Une chaîne vide réserve une case. La dernière ligne est complétée au besoin ; une liste vide affiche une ligne vide. Le total est limité à 1 000 cases, vides comprises.
Un chemin de liste fonctionne aussi, notamment dans une boucle. Le rendu ne modifie rien et n'ajoute ni déplacement ni collision. La forme [[grid:3x2]]...[[/grid]] reste disponible.
L'export HTML recense les images connues des listes et collections déclarées. Les adresses calculées ou reçues pendant la partie suivent les règles des médias dynamiques. Voir Un petit plateau 2D.
