Nel caso che GD2 e Freetype siano installati sul sito [1], SPIP può creare da solo delle immagini a partire dai titoli (o da qualsiasi elemento del database) utilizzando un font di caratteri di propria scelta.
La funzione che crea questo effetto è image_typo. Questo articolo presenta le diverse variabili che è possibile utilizzare con questa funzione.
[(#TITRE|image_typo)]
Se non si specifica alcuna variabile image_typo utilizzerà il font predefinito fornito con SPIP: Dustismo, un font GPL di Dustin Norlander.
police
È possibile specificare il nome di un altro font precedentemente installato sul proprio sito.
[(#TITRE|image_typo{police=dustismo_bold.ttf})]
(Anche Dustismo-bold fa parte del pacchetto di SPIP.)
In teoria, è possibile usare numerosi formati di font: TrueType, PostScript Type 1, OpenType... In base alla configurazione del proprio sito è possibile che alcuni formati non siano accettati.
I font devono essere inseriti in una sotto-cartella /polices della cartella /ecrire, oppure della cartella che contiene i propri modelli.
Per esempio, se inseriamo un file TrueType in questo modo:/ecrire/polices/stencil.ttf
è possibile usare questo nuovo font [2].
[(#TITRE|image_typo{police=stencil.ttf})]
taille
È possibile specificare la dimensione della visualizzazione del font. Ciò si fa usando la variabile taille.
[(#TITRE|image_typo{police=stencil.ttf,taille=36})]
Nota: non si specifica «36pt», ma solamente «36», senza indicare l’unità.
couleur
Questa variabile permette di indicare il colore. Il colore predefinito è il nero. Questa variabile è un colore RVB esadecimale, sempre nel formato «3399BB». Nota bene: il segno «#» che precede normalmente questo tipo di codice di colore deve essere omesso.
[(#TITRE|image_typo{police=stencil.ttf,taille=36,couleur=4433bb})]
largeur
La variabile largeur permette di stabilire la larghezza massima dell’immagine. Nota bene: questo è un valore massimo; l’immagine reale viene «inquadrata» in maniera automatica, successivamente, al fine di applicare le dimensioni del testo realmente composto.
Il primo riquadro sottostante è composto con una larghezza massima di 300 pixel, il secondo con una larghezza di 400 pixel.
[(#TITRE|image_typo{police=stencil.ttf,largeur=300})]
[(#TITRE|image_typo{police=stencil.ttf,largeur=400})]
align
La variabile align permette di forzare l’allineamento di più righe di testo (se è il caso) a sinistra, a destra o centrato. In maniera del tutto eccezionale qui si utilizza una sintassi inglese, simile a quella usata per i fogli di stile.
[(#TITRE|image_typo{police=stencil.ttf,align=left})]
[(#TITRE|image_typo{police=stencil.ttf,align=center})]
[(#TITRE|image_typo{police=stencil.ttf,align=right})]
hauteur_ligne
hauteur_ligne permette di stabilire l’altezza da una riga di testo all’altra (nel caso che l’immagine sia su più righe).
[(#TITRE|image_typo{police=stencil.ttf,taille=36,hauteur_ligne=80})]
padding
Alcuni font «superano» il box in cui si trovano causando un effetto disastroso (font «tagliati»). La variabile padding permette, in maniera del tutto eccezionale, di forzare uno spazio supplementare intorno all’immagine tipografica.
[(#TITRE|image_typo{police=stencil.ttf,padding=5})]
Filtrare l’immagine
Poiché il risultato di image_typo è un’immagine, è possibile applicare ad essa i filtri delle immagini. Per esempio, i filtri sottostanti rendono l’immagine semi-trasparente o si applica una texture.
[(#TITRE|image_typo{police=stencil.ttf,couleur=aa2244}|image_alpha{60})]
[(#TITRE|image_typo{police=stencil.ttf,couleur=aa2244}|image_masque{carre-mur.png})]
