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

