PHP Handbuch
Zurück |  | Nach vorne

# ImageTTFText

(PHP 3 <= 3.0.18, PHP 4 >= 4.0.0)

ImageTTFText -- Erzeugt TTF-Text im Bild

## Beschreibung:

``array imagettftext` (int im, int size, int angle, int x, int y, int col, string fontfile, string text)`

ImageTTFText() zeichnet den Text `text` in das per `im` angegebene Bild, beginnend bei den Koordinaten `x` und `y` (oben links ist 0, 0) mit einem Ausgabewinkel von `angle` in der Farbe `col` unter Verwendung der TTF-Datei, die mittels `fontfile` benannt wurde.

Die per `x` und `y` angegebenen Koordinaten definieren den Startpunkt des ersten Zeichens (in etwa die linke untere Ecke). Das ist anders als bei der ImageString()-Funktion, bei der x und y die obere rechte Ecke des ersten Zeichens darstellen.

`Angle` ist in Grad anzugeben. 0 ist eine normale Ausrichtung von links nach rechts (von 9 nach 3 Uhr). Höhere Werte entsprechen einer immer weiteren Drehung entgegen dem Uhrzeiger-Sinn. Eine Drehung von 90 Grad entspricht also einer Text-Ausrichtung von unten nach oben (von 6 nach 12 Uhr).

`Fontfile` ist der Pfad zur TTF-Datei, die Sie verwenden wollen.

`Text` ist der auszugebende String, der auch UTF-8-Zeichenfolgen enthalten darf (z.B. &#123;)

`Col` ist der Farbindex. Verwenden Sie den negativen Index-Wert, führt das zum Aufheben des Farbüberlaufs (Antialiasing).

ImageTTFText() gibt ein Array aus acht Elementen zurück, das die vier Ecken des Textausgabe-Bereichs enthält (wie ImageTTFBBox()). Die Reihenfolge ist dabei oben links, oben rechts, unten rechts und unten links. Die Punkte sind dabei relativ zum Text. Deshalb gibt oben links die linke Ecke bei horizontaler Sichtweise an.

Das Beispiel-Skript erzeugt eine schwarze GIF-Grafik von 400x30 Pixel mit dem weissen Text "Teste..." im TT-Font Arial.

Beispiel 1. ImageTTFText
    <?php
    Header ("Content-type: image/gif");
    $im = imagecreate (400, 30);
    $black = ImageColorAllocate ($im, 0, 0, 0);
    $white = ImageColorAllocate ($im, 255, 255, 255);
    ImageTTFText ($im, 20, 0, 10, 20, $white, "/path/arial.ttf",
                  "Teste... Omega: &#937;");
    ImageGif ($im);
    ImageDestroy ($im);
    ?>

Diese Funktion erfordert sowohl die GD- als auch die FreeType-Bibliothek.

Siehe auch imagettfbbox().

Zurück | Zum Anfang | Nach vorne
ImageTTFBBox | Nach oben | ImageTypes