Si GD2 y Freetype están instalados en tu sitio web [1], SPIP puede crear, por sí solo, imágenes a partir de los títulos (o de cualquier elemento de la base de datos) utilizando el tipo de letra que tú elijas.
La función que realiza este efecto es image_typo. La presente página presentará las diferentes variables que se pueden utilizar con esta función.
[(#TITRE|image_typo)]
Si no se le especifica ninguna variable, image_typo utilizará el tipo de letra por defecto proporcionada por SPIP: Dustismo, un tipo de letra GPL de Dustin Norlander.
Se encuentra en el subdirectorio polices del directorio dist (en las versiones anteriores de SPIP, estaba en el directorio ecrire).
police
Puedes indicar el nombre de un tipo de letra diferente, siempre que esté instalado en tu servidor.
[(#TITRE|image_typo{police=dustismo_bold.ttf})]
(Dustismo-bold también se proporciona con SPIP).
En teoría, puedes utilizar numerosos formatos de tipo de letra: TrueType, PostScript Type 1, OpenType... Según la configuración de tu servidor, es posible que algunos formatos no sean aceptados.
Los tipos de letra han de estar instalados en un subdirectorio /polices del directorio que contenga tus esqueletos.
Si instalamos, por ejemplo, un archivo TrueType de esta manera: polices/stencil.ttf
es posible usar este nuevo tipo de letra [2].
[(#TITRE|image_typo{police=stencil.ttf})]
taille
Se puede determinar el tamaño de presentación del tipo de letra. Esto se hace con la variable taille.
[(#TITRE|image_typo{police=stencil.ttf,taille=36})]
Nota: no es necesario escribir «36pt», se indica únicamente «36», sin indicar la unidad.
couleur
Esta variable permite indicar el color. Por omisión, el resultado es negro. La variable consiste en un color RGB (rojo, verde, azul) hexadecimal, siempre con el formato «3399BB». Nota: se omite el «#» que precede habitualmente este tipo de código de color.
[(#TITRE|image_typo{police=stencil.ttf,taille=36,couleur=4433bb})]
largeur
La variable largeur permite fijar el ancho máximo de la imagen. Fíjate bien que este es un valor máximo; la imagen real se «reajusta» de forma automática para adoptar las dimensiones del texto una vez compuesto.
El primero de los bloques de abajo está compuesto con un ancho máximo de 300 píxels, y el segundo con un ancho de 400 píxels.
[(#TITRE|image_typo{police=stencil.ttf,largeur=300})]
[(#TITRE|image_typo{police=stencil.ttf,largeur=400})]
align
La variable align permite forzar la alineación de varias líneas de texto (como en este caso) a la izquierda, a la derecha o al centro. Excepcionalmente, se utiliza aquí una sintaxis en inglés, similar a la que se usa en las hojas de estilo.
[(#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 permite fijar la altura entre cada una de las líneas del texto (en caso que la imagen tenga varias líneas).
[(#TITRE|image_typo{police=stencil.ttf,taille=36,hauteur_ligne=80})]
padding
Algunos tipos de letra «sobrepasan» el espacio que tienen asignado, con lo que se obtiene un efecto desastroso (tipos de letra «cortados»). La variable padding permite, excepcionalmente, forzar un espacio suplementario alrededor del resultado tipográfico.
[(#TITRE|image_typo{police=stencil.ttf,padding=5})]
Filtrar la imagen
Como el resultado de image_typo es una imagen, es posible aplicarle filtros de imágenes. Por ejemplo, a continuación se ve cómo se hace semitransparente la imagen, o se le aplica una textura.
[(#TITRE|image_typo{police=stencil.ttf,couleur=aa2244}|image_alpha{60})]
[(#TITRE|image_typo{police=stencil.ttf,couleur=aa2244}|image_masque{carre-mur.png})]
