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 recurso image, es devuelto por una de las funciones de creación de imágenes, como imagecreatetruecolor().

font

Puede ser 1, 2, 3, 4, 5 para fuentes built-in en latin2 encoding (los números más altos corresponden a large fonts) o cualquier de sus propios identificadores de fuentes registrados con imageloadfont().

x

X: coordenada de inicio.

y

Y: coordenada de inicio.

char

El carácter a dibujar.

color

Un identificador de color creato con imagecolorallocate().

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Historial de cambios

Versión Descripción
8.1.0 The font parameter now accepts both an GdFont instance and an entier; previously only entier was accepted.
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);

?>

El resultado del ejemplo sería algo similar a:

Visualización del ejemplo: imagechar()

Ver también