imagechar

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

imagechar — Zeichnet ein horizontal ausgerichtetes Zeichen

Beschreibung

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

imagechar() zeichnet das erste in char enthaltene Zeichen in der mit image angegebenen Grafik dar. Das Zeichen wird mit seiner linken oberen Ecke in x, y positioniert (die linke obere Ecke der Grafik hat die Koordinaten 0,0), die Darstellung erfolgt in der Farbe color

Parameter-Liste

image: Ein GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.
font: Kann bei eingebauten Schriftarten in Latin2-Kodierung 1, 2, 3, 4 oder 5 sein (wobei größere Zahlen größeren Schriftarten entsprechen) oder eine GdFont-Instanz, die von imageloadfont() zurückgegeben wurde.
x: x-Koordinate des Startpunkts
y: y-Koordinate des Startpunkts
char: Das darzustellende Zeichen
color: Eine Farbkennung, die mit imagecolorallocate() erzeugt wurde.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Changelog

Version	Beschreibung
8.1.0	Der Parameter `font` akzeptiert jetzt sowohl eine GdFont-Instanz als auch ein Integer; vorher wurde nur Integer akzeptiert.
8.0.0	`image` erwartet nun eine GdImage-Instanz; vorher wurde eine gültige `gd`-Ressource erwartet.

Beispiele

Beispiel #1 imagechar()-Beispiel

<?php

$im = imagecreate(100, 100);

$string = 'PHP';

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

// schreibe ein schwarzes "P" in die linke obere Ecke
imagechar($im, 1, 0, 0, $string, $black);

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

?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Siehe auch

imagecharup() - Zeichnet ein vertikal ausgerichtetes Zeichen
imageloadfont() - Lädt eine neue Schriftart

add a note

User Contributed Notes 2 notes

down

liam dot wiltshire at lineone dot net ¶

15 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");



?>

down

sw at profilschmiede dot de ¶

19 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);
?>

add a note