Générer les illustrations des trains en SVG avec PHP
Dans Ramedex, les cartes des trains ne sont pas dessinées une par une : une fiche par famille (silhouette, livrée, composition) et une fonction PHP qui assemble le SVG. Une livrée régionale devient une ligne de données, pas un fichier à refaire.
Chaque capture dans Ramedex se termine par une carte, avec l'illustration du train qu'on vient d'attraper. Derrière ces illustrations, une fiche par famille et une fonction PHP.
Le jeu référence des familles de trains très différentes les unes des autres. Chacune a sa silhouette, certaines se déclinent en compositions différentes, et les TER portent la livrée de la région qui les exploite. Chaque illustration doit aussi exister dans plusieurs contextes, de la vignette dans la collection au grand format sur la carte partagée. Dessiner tout ça à la main, c'est un produit cartésien de fichiers.
L'idée qui vient en premier est l'export massif : une silhouette par variante dans un logiciel de dessin, puis des fichiers rangés partout. Elle tient mal. Chaque retouche de silhouette doit être rejouée sur chaque déclinaison. Une livrée qui évolue devient une série d'exports à refaire, sans compter ceux qu'on oublie. Et rien ne garantit que la vignette et le grand format restent cohérents.
Une fiche par famille
J'ai décrit chaque famille par une fiche. Trois blocs : la silhouette, la livrée, la composition. La silhouette désigne un gabarit de dessin, la forme des caisses et du nez. La livrée ( livery ) associe des couleurs à des zones du train, la caisse, la bande, le toit. La composition ( cars ) dit combien d'éléments se suivent. En version simplifiée :
$fiche = [
'silhouette' => 'autorail_deux_caisses',
'livery' => [
'body' => '#ffffff',
'stripe' => '#b5252b',
'roof' => '#51504f',
],
'cars' => 2,
];Le générateur assemble le SVG à partir de là. Le principe tient en quelques lignes, très en dessous de la version réelle :
function trainSvg(array $fiche): string
{
$c = $fiche['livery'];
$svg = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 310 90">';
for ($i = 0; $i < $fiche['cars']; $i++) {
$x = 10 + $i * 150;
$svg .= "<rect x='{$x}' y='24' width='130' height='42' rx='10' fill='{$c['body']}'/>";
$svg .= "<rect x='{$x}' y='24' width='130' height='8' rx='4' fill='{$c['roof']}'/>";
$svg .= "<rect x='{$x}' y='44' width='130' height='9' fill='{$c['stripe']}'/>";
$svg .= "<circle cx='" . ($x + 25) . "' cy='70' r='7' fill='#232323'/>";
$svg .= "<circle cx='" . ($x + 105) . "' cy='70' r='7' fill='#232323'/>";
}
return $svg . '</svg>';
}La version réelle pioche un gabarit de formes selon la silhouette et dessine plus de détails, mais l'idée est là : des formes paramétrées par des couleurs, répétées selon la composition. Comme le rendu est du SVG, la même chaîne sert toutes les tailles. Une vignette de collection et une grande carte affichent le même balisage, à des largeurs différentes, et le vectoriel suit. Pas de déclinaison par densité d'écran, pas de script de resize. Le SVG n'est que du texte, et PHP sait produire du texte.
Comme toutes les illustrations sortent du même code, elles se ressemblent. Mêmes proportions, même rendu des couleurs. C'est ce qu'on veut pour une collection qu'on feuillette.
La région comme paramètre
Le cas des TER montre ce que ça change. En fichiers, il faudrait une illustration par livrée régionale, puis une par livrée et par taille. En fiches, il y a une silhouette et des tableaux de couleurs. La même caisse rendue avec une bande verte ou une bande rouge change de région sans changer de fichier.
Si une région modernise son habillage, la correction est une ligne de données. Si je me suis trompé sur une teinte, je la corrige une fois et elle se propage partout où cette livrée apparaît. La région est devenue un paramètre, au même rang que la composition.
Deux leçons de Blade
Deux mésaventures avec Blade, toujours dans Ramedex, poussent dans le même sens.
La première vient du JSON-LD. La fiche de métadonnées des pages contient une clé @context . Blade, le moteur de template de Laravel, y a vu une directive et a essayé de l'exécuter. La fiche est désormais construite en PHP, assemblée comme un tableau puis encodée.
La deuxième vient du sitemap. Un sitemap commence par un prologue <?xml . En production, là où short_open_tag est actif, PHP prend ce <? pour une balise d'ouverture, et la vue Blade partait en erreur. Le sitemap est maintenant écrit en PHP, qui renvoie du XML aussi tranquillement que du JSON.
Ces deux formats, et le SVG avec eux, ont un point commun. Ce sont des formats machine, répétitifs, sans mise en page. Un moteur de template y apporte sa syntaxe, ses échappements et ses interprétations surprises. Une fonction qui construit une chaîne n'apporte rien de tout ça. Blade, je le garde pour les pages HTML, où il rend service.
Ce que ça coûte
Deux limites, assumées. La première est le style. Dessiner des trains en formes paramétrées donne un rendu volontairement simplifié. Pour un jeu qu'on lit en vignette sur un téléphone, la lisibilité compte plus que le détail, et un rendu épuré vieillit mieux qu'un dessin qui court après le réalisme. Je ne prétends pas avoir gagné au change sur ce terrain : un illustrateur ferait mieux en s'en donnant les moyens.
La deuxième limite est l'entretien. Quand un matériel change d'habillage dans la réalité, la fiche doit suivre. Et une erreur dans une fiche n'est pas isolée, elle se retrouve partout où la donnée est utilisée, bien après l'endroit où je l'ai introduite.
Il y a enfin une frontière que je n'ai pas encore atteinte. Tant qu'une silhouette tient en formes simples, la fiche reste une donnée. Le jour où je voudrais des nez de rame dessinés au trait près, la silhouette deviendrait un dessin, et un dessin se maintient autrement qu'un tableau de couleurs. Pour l'instant, les fiches suffisent : ajouter un train à une famille existante, c'est lui donner des couleurs et une composition, pas le dessiner.