imagettftext

(PHP 3, PHP 4 , PHP 5)

imagettftext -- Escribir un texto sobre la imagen usando fuentes TrueType

Descripción

array imagettftext ( resource imagen, int tamanyo, int angulo, int x, int y, int color, string archivo_fuente, string texto)

imagettftext() dibuja la cadena texto en la imagen identificada por imagen, comenzando en las coordenadas x, y (la esquina superior izquierda es 0, 0), a un ángulo de angulo en el color color, usando el archivo de fuente TrueType identificado por archivo_fuente. Dependiendo en la versión de la biblioteca GD que PHP usa, cuando archivo_fuente no comienza con un caracter '/', '.ttf' se agregará al nombre de archivo y la biblioteca intentará buscar por ese archivo en una ruta de fuentes definida por la biblioteca.

Las coordenadas dadas por x, y definirán el punto base del primer caracter (a grandes rasgos la esquina inferior izquierda del caracter). Esto a diferencia de imagestring(), en donde x, y definen la esquina superior derecha del primer caracter.

angulo se encuentra en grados, en donde el grado 0 produce la lectura del texto de izquierda a derecha (en dirección de las 3 en punto), y los valores más altos representan una rotación en sentido contrario al de las manecillas del reloj. (Es decir, un valor de 90 resultarío en un texto que se lee de abajo a arriba).

archivo_fuente es la ruta a la fuente TrueType que desea usar.

texto es la cadena de texto, que puede incluir secuencias de caracteres UTF-8 (de la forma: {) para acceder a caracteres más alla de los primeros 255 en una fuente.

color es el índice de color. El uso del valor negativo de un índice de color tiene el efecto de deshabilitar el anti-alias.

imagettftext() devuelve una matriz con 8 elementos que representan cuatro puntos que forman la caja circundante del texto. El orden de los puntos es inferior izquierdo, inferior derecho, superior derecho y superior izquierdo. Los puntos son relativos al texto independientemente del ángulo, así que "superior izquierdo" quiere decir la esquina del lado superior izquierdo cuando ve el texto horizontalmente.

Este script de ejemplo producirá un JPEG negro de 400x30 pixeles, con las palabras "Probando..." en blanco en la fuente Arial.

Ejemplo 1. Ejemplo de imagettftext()

<?php
  header
("Content-type: image/jpeg");
  
$im = imagecreate(400, 30);
  
$blanco = imagecolorallocate($im, 255, 255, 255);
  
$negro = imagecolorallocate($im, 0, 0, 0);
  
  
// Reemplaze la ruto con su propio ruta a la fuente
  
imagettftext($im, 20, 0, 10, 20, $negro, "/ruta/a/arial.ttf",
  
"Probando... Omega: &amp;#937;");
  
imagejpeg($im);
  
imagedestroy($im);
?>

Esta función requiere tanto la biblioteca GD como la biblioteca FreeType.

Vea también imagettfbbox().