# 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 größere 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 gültige `gd`-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');
?>`

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

### Siehe auch

- imagestring() - Zeichnet einen horizontalen String
- imageloadfont() - Lädt eine neue Schriftart

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open