imagecharup
(PHP 4, PHP 5, PHP 7, PHP 8)
imagecharup — Zeichnet ein vertikal ausgerichtetes Zeichen
Beschreibung
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 höhere 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
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
