imagestring
(PHP 4, PHP 5, PHP 7, PHP 8)
imagestring — Zeichnet einen horizontalen String
Beschreibung
Zeichnet einen string an den angegebenen Koordinaten.
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 -
Die x-Koordinate der oberen linke Ecke.
-
y -
Die y-Koordinate der oberen linken Ecke.
-
string -
Die zu schreibende Zeichenkette.
-
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 imagestring()-Beispiel
<?php
// Erzeuge ein 100*30 Bild
$im = imagecreate(100, 30);
// Weißer Hintergrund und blauer Text
$bg = imagecolorallocate($im, 255, 255, 255);
$textfarbe = imagecolorallocate($im, 0, 0, 255);
// Schreibe die Zeichenkette oben links
imagestring($im, 5, 0, 0, 'Hello world!', $textfarbe);
// Gib das Bild aus
header('Content-type: image/png');
imagepng($im);
imagedestroy($im);
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Siehe auch
- imagestringup() - Zeichnet einen vertikalen String
- imageloadfont() - Lädt eine neue Schriftart
- imagettftext() - Schreibe Text ins Bild unter Verwendung von True-Type-Schriftarten
