# imagestring

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

imagestring — Zeichnet einen horizontalen String

### Beschreibung

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

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

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

### Siehe auch

- imagestringup() - Zeichnet einen vertikalen String
- imageloadfont() - Lädt eine neue Schriftart
- imagettftext() - Schreibt Text mit TrueType-Schriftarten ins Bild

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