imagechar

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

imagechar — Dibuja 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 :

Ver también

imagecharup() - Dibuja un carácter verticalmente
imageloadfont() - Carga una nueva fuente

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 2 notes

down

sw at profilschmiede dot de ¶

20 years ago

For the sake of completeness, here is an example for imagechar. 
The base-image automatically adjusts to the size and the height of the given string. Using the rand()-function the y-position of each char is slightly varied with every loop-run. You can easily rewrite the script to use a randomly generated string - the one given here just serves as an example.

<?php

$string = '1 2 3 4 5 6 7 8 9 A B C D E F G';
$font_size = 5;
$width=imagefontwidth($font_size)*strlen($string);
$height=imagefontheight($font_size)*2;
$img = imagecreate($width,$height);
$bg = imagecolorallocate($img,225,225,225);
$black = imagecolorallocate($img,0,0,0);
$len=strlen($string);

for($i=0;$i<$len;$i++)
{
    $xpos=$i*imagefontwidth($font_size);
    $ypos=rand(0,imagefontheight($font_size));
    imagechar($img,$font_size,$xpos,$ypos,$string,$black);
    $string = substr($string,1);    
    
}
header("Content-Type: image/gif");
imagegif($img); 
imagedestroy($img);
?>

down

liam dot wiltshire at lineone dot net ¶

16 years ago

A quick function to automatically generate a multi line image from a string, with the image size automatically calculated from the string itself.



<?php



function multilineimage($string){



    // Probably not the best way of handling newlines, but bar OS9, doesn't really cause a problem

    $string = str_replace("\r","",$string);

    $string = explode("\n",$string);



    $maxlen = 0;

    foreach ($string as $str){

        if (strlen($str) > $maxlen){

            $maxlen = strlen($str);

        }

    }



    // Set font size

    $font_size = 4;



    // Create image width dependant on width of the string

    $width  = imagefontwidth($font_size)*$maxlen;

    // Set height to that of the font

    $height = imagefontheight($font_size) * count($string);

    // Create the image pallette

    $img = imagecreate($width,$height);

    // Grey background

    $bg    = imagecolorallocate($img, 205, 255, 255);

    // White font color

    $color = imagecolorallocate($img, 0, 0, 0);



    $ypos = 0;



    foreach ($string as $str){



        $len = strlen($str);

        for($i=0;$i<$len;$i++){

            // Position of the character horizontally

            $xpos = $i * imagefontwidth($font_size);

            // Draw character

            imagechar($img, $font_size, $xpos, $ypos, $str, $color);

            // Remove character from string

            $str = substr($str, 1);   

        }

        $ypos = $ypos + imagefontheight($font_size);   

    }



    // Return the image 

    header("Content-Type: image/gif");

    imagegif($img);

    // Remove image

    imagedestroy($img);

}



multilineimage("This is an image

This is line 2\nLine 3

Line 4");



?>

＋add a note