SPIP 1.9.2
La fonction qui réalise cet effet est image_typo. La présente page va vous présenter les différentes variables que l’on peut utiliser avec cette fonction.
Si vous ne précisez aucune variable, image_typo va utiliser la police par défaut fournie avec SPIP : Dustismo, une police GPL de Dustin Norlander.
Elle figure dans le sous-dossier polices du dossier
dist (dans les versions précédentes de SPIP, il s’agissait du dossier ecrire).
police
Vous pouvez préciser le nom d’une autre police, que vous aurez pris soin d’installer sur votre site.
(Dustismo-bold est également livré avec SPIP.)
En théorie, vous pouvez utiliser de nombreux formats de police : TrueType, PostScript Type 1, OpenType... Selon la configuration de votre site, il est possible que certains formats ne soient pas acceptés.
Les polices doivent être installées dans un sous-dossier /polices du dossier contenant vos squelettes.
Si nous installons, par exemple, un fichier TrueType ainsi :
polices/stencil.ttf
il est possible d’utiliser cette nouvelle police [2].
taille
On peut préciser la taille d’affichage de la police. Cela s’utilise avec la variable taille.
Note : on ne précise pas « 36pt », on indique seulement « 36 », sans indication de l’unité.
couleur
Cette variable permet d’indiquer la couleur. Par défaut, le rendu est noir. Cette variable est une couleur RVB hexadécimale, toujours de la forme « 3399BB ». Notez : on omet le « # » qui précède habituellement ce type de code couleur.
largeur
La variable largeur permet de fixer la largeur maximale de l’image. Notez bien : c’est une valeur maximale ; l’image réelle est « recadrée » automatiquement, ensuite, pour adopter les dimensions du texte réellement composé.
Le premier pavé ci-dessous est composé avec une largeur maximale de 300 pixels, le second avec une largeur de 400 pixels.
align
La variable align permet de forcer l’alignement de plusieurs lignes de texte (lorsque c’est le cas) à gauche, droite, ou au centre. Exceptionnellement, on utilise ici une syntaxe anglaise, proche de ce qui se fait pour les feuilles de style.
hauteur_ligne
hauteur_ligne permet de fixer la hauteur entre chaque ligne de texte (dans le cas où l’image comporte plusieurs lignes).
padding
Certaines polices « dépassent » de leur boîte de rendu, et on obtient un effet désastreux (polices « coupées »). La variable padding permet, exceptionnellement, de forcer un espace supplémentaire autour du rendu typographique.
Filtrer l’image
Le résultat de image_typo étant une image, il est tout à fait possible de lui appliquer des filtres d’images. Par exemple, ci-après, on rend l’image semi-transparente, ou on lui applique une texture.
