imagechar

(PHP 4, PHP 5, PHP 7, PHP 8)

imagecharDibuja un carácter horizontalmente

Descripción

imagechar(
    GdImage $image,
    GdFont|int $font,
    int $x,
    int $y,
    string $char,
    int $color
): bool

imagechar() dibuja el primer carácter de la cadena char en la imagen image con la esquina superior izquierda situada en la posición x,y (la esquina superior izquierda es el origen (0,0)) con el color color.

Parámetros

image

Un objeto GdImage, retornado por una de las funciones de creación de imágenes, como imagecreatetruecolor().

font

Puede ser 1, 2, 3, 4, 5 para las fuentes internas de codificación Latin2 (donde los números más grandes corresponden a fuentes anchas) o una instancia de GdFont retornado por imageloadfont().

x

X: coordenada de inicio.

y

Y: coordenada de inicio.

char

El carácter a dibujar.

color

A color identifier created with imagecolorallocate().

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Historial de cambios

Versión Descripción
8.1.0 El parámetro font ahora acepta una instancia de GdFont y un entero; anteriormente solo un entero era aceptado.
8.0.0 image expects a GdImage instance now; previously, a valid gd resource was expected.

Ejemplos

Ejemplo #1 Ejemplo con imagechar()

<?php

$im
= imagecreate(100, 100);

$string = 'PHP';

$bg = imagecolorallocate($im, 255, 255, 255);
$black = imagecolorallocate($im, 0, 0, 0);

// muestra un "P" negro en la esquina superior izquierda
imagechar($im, 1, 0, 0, $string, $black);

header('Content-type: image/png');
imagepng($im);

?>

Resultado del ejemplo anterior es similar a :

Visualización del ejemplo: imagechar()

Ver también