Manual de PHP
AnteriorSiguiente

ImageTTFText

(PHP 3, PHP 4 )

ImageTTFText -- Escribe texto en la imagen usando fuentes TrueType

Descripción

array ImageTTFText ( int im, int size, int angle, int x, int y, int col, string fontfile, string text)

ImageTTFText escribe la cadenatext en la imagen identificada por im, comenzando en las coordenadas x,y (arriba izquierda es 0,0), con un ángulo de angle en el color col, usando el ficheor de fuente TrueType identificado por fontfile.

Las coordenadas dadas por x,y definirán el punto base del primer carácter. (la esquina inferior izquierda del carácter). Esto es diferente de la función ImageString(), donde x,y definen la esquina superior derecha del primer carácter.

El angle viene dado en grados, donde 0 grados representa el texto de izquierda a derecha (dirección las 3 en punto), y valores superiores representan una rotación en el sentido de las agujas de un reloj. (ej. un valor de 90 representaría un texto que fuese de abajo hacia arriba).

fontfile es la ruta hacia la fuente TrueType que desee usar.

text es la cadena de texto que puede incluir secuencias de caracteres UTF-8 (de la forma: &123; ) para acceder a caracteres de la fuente más allá de los primeros 255.

col es el índice de color. El uso de un índice de color negativo tiene el efecto de desactivar el antialiasing.

ImageTTFText() devuelve una matriz con 8 elementos representando cuatro puntos que hace una caja que cubre el texto.El orden de los puntos en arriba izquierda, arriba derecha, abajo derecha, abajo izquierda. Los puntos son relativos al texto a pesar del ángulo, por lo que "arriba izquierda" significa en la esquina superior izquierda cuando ve el texto horizontalmente.

Este script de ejemplo producirá un GIF negro de 400x30 pixels, con las palabras "Testing..." en blanco con la fuente Arial.

Ejemplo 1. ImageTTFText

<?php
Header("Content-type: image/gif");
$im = imagecreate(400,30);
$black = ImageColorAllocate($im, 0,0,0);
$white = ImageColorAllocate($im, 255,255,255);
ImageTTFText($im, 20, 0, 10, 20, $white, "/path/arial.ttf", "Testing... Omega: &#937;");
ImageGif($im);
ImageDestroy($im);
?>

Esta función requiere la libreria GD y la libreria FreeType.

Vea también ImageTTFBBox().

AnteriorInicioSiguiente
ImageTTFBBoxSubirimagetypes