imagecharup

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

imagecharup — Zeichnet ein vertikal ausgerichtetes Zeichen

Beschreibung

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

Zeichnet den Buchstaben char vertikal an der angegebenen Koordinate auf dem angegebenen image.

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 Anfangs.
y: y-Koordinate des Anfangs.
char: Der zu zeichnende Buchstabe.
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 imagecharup()-Beispiel

<?php

$im = imagecreate(100, 100);

$string = 'N wird aussehen wie ein Z';

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

// druckt ein schwarzes "Z" auf weißem Hintergrund
imagecharup($im, 3, 10, 10, $string, $black);

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

?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Siehe auch

imagechar() - Zeichnet ein horizontal ausgerichtetes Zeichen
imageloadfont() - Lädt eine neue Schriftart

add a note

User Contributed Notes 1 note

down

-4

php at corzoogle dot com ¶

19 years ago


<?php
// incredibly, no one has added this.
// write a string of text vertically on an image..
// ;o)

$string = '(c) corz.org';
$font_size = 2;
$img = imagecreate(20,90);
$bg = imagecolorallocate($img,225,225,225);
$black = imagecolorallocate($img,0,0,0);

$len = strlen($string);
for ($i=1; $i<=$len; $i++) {
    imagecharup($img, $font_size, 5, imagesy($img)-($i*imagefontwidth($font_size)), $string, $black);
    $string = substr($string,1);
}
header('Content-type: image/png');
imagepng($img);
imagedestroy($img); // dudes! don't forget this!
?>

add a note