imagestringup

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

imagestringup — Zeichnet einen vertikalen String

Beschreibung

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

Zeichnet einen string vertikal 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 unteren linken Ecke.
y: Die y-Koordinate der unteren 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 imagestringup()-Beispiel


<?php
// Erzeuge ein 100*100 Bild
$im = imagecreatetruecolor(100, 100);

// Schreibe den Text
$textfarbe = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
imagestringup($im, 3, 40, 80, 'gd library', $textfarbe);

// Speichere das Bild
imagepng($im, './stringup.png');
imagedestroy($im);
?>