imagepstext

(PHP 4, PHP 5)

imagepstext — Dibujar un texto sobre una imagen usando fuentes PostScript Type1

Descripción

array imagepstext ( resource $image , string $text , resource $font_index , int $size , int $foreground , int $background , int $x , int $y [, int $space = 0 [, int $tightness = 0 [, float $angle = 0.0 [, int $antialias_steps = 4 ]]]] )

Dibuja un texto sobre una imagen usando fuentes PostScript Type1.

Consulte la documentación de PostScript sobre fuentes y sus sistemas de medidas si tiene problemas en entender cómo funciona esto.

Parámetros

image

Un recurso image, es devuelto por una de las funciones de creación de imágenes, como imagecreatetruecolor().

text

El texto que va a ser escrito.

font_index

Un recurso de fuente, devuelto por imagepsloadfont().

size

size, el tamaño expresado en píxeles.

foreground

El color en el cual el texto será pintado.

background

El color en el cual el texto intentará fundirse con antialias. Ningún píxel con el color background se pinta en realidad, por lo que la imagen de fondo no necesita ser de un color sólido.

x

Coordenada x de la esquina inferior izquierda del primer carácter.

y

Coordenada y de la esquina inferior izquierda del primer carácter.

space

Permite cambiar el valor predeterminado de un espacio en una fuente. Esta cantidad se añade al valor normal y puede ser negativa también. Expresado en unidades de espacio de carcteres, donde 1 unidad es la 1/1000 parte de una 'M' (em-square).

tightness

tightness permite controlar la cantidad de espacio en blanco entre caracteres. Esta cantidad se añade al ancho de un carácter normal y puede ser negativo. Expresado en unidades de espacio de carcteres, donde 1 unidad es la 1/1000th parte de una 'M' (em-square).

angle

angle, ángulo en grados.

antialias_steps

Permite controlar el número de colores usados para el texto con antialias. Los valores permitidos son 4 y 16. Se recomienda el valor más alto para tamaños de texto menores que 20, donde el efecto en la calidad del texto es bastante visible. Con tamaños mayores, use 4. Es menos intensivo computacionalmente.

Valores devueltos

Esta función devuleve una matriz que contiene los siguientes elementos:
0 coordenada x inferior izquierda
1 coordenada y inferior izquierda
2 coordenada x superior derecha
3 coordenada x superior derecha

Ejemplos

Ejemplo #1 Uso de imagepstext()

<?php
// Crear un gestor de imagen
$im = imagecreatetruecolor(200, 200);

// Asignar colores
$negro = imagecolorallocate($im, 0, 0, 0);
$blanco = imagecolorallocate($im, 255, 255, 255);

// Cargar la fuente PostScript
$fuente = imagepsloadfont('fuente.pfm');

// Escribir la fuente en la imagen
imagepstext($im, 'Sample text is simple', $fuente, 12, $negro, $blanco, 50, 50);

// Imprimir y liberar memoria
header('Content-type: image/png');

imagepng($im);
imagedestroy($im);
?>

Notas

Nota: Esta función sólo está disponible si PHP fue compilado usando --with-t1lib[=DIR] .

Ver también

  • imagepsbbox() - Devolver la caja circundante de un rectángulo de texto usando fuentes PostScript Type1