Lädt eine neue Schriftart

# imageloadfont

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

imageloadfont — Lädt eine neue Schriftart

### Beschreibung

function imageloadfont(string `$filename`): GdFont|false

ImageLoadFont() lädt eine benutzerdefinierte Bitmap-Schriftart und gibt deren Kennung zurück.

### Parameter-Liste

`filename`

  Das Schriftart-Dateiformat ist zurzeit ein architekturabhängiges, binäres Format. Das bedeutet, dass Schriftart-Dateien immer auf derselben Architektur erzeugt werden müssen, auf dem diese verwendet werden sollen.

  Scrhiftart-Dateiformat
  Byte-Position | C Daten-Typ | Beschreibung
  --- | --- | ---
  Byte 0-3 | int | Anzahl der Zeichen der Schriftart
  Byte 4-7 | int | Wert des ersten Zeichens der Schriftart (meist 32 für Leerzeichen)
  Byte 8-11 | int | Pixel-Breite jedes Zeichens
  Byte 12-15 | int | Pixel-Höhe jedes Zeichens
  Byte 16- | char | Zeichen-Daten als Array, ein Byte je Pixel für jedes Zeichen; in der Summe also insgesamt (Anzahl Zeichen * Breite * Höhe) Byte.

### Rückgabewerte

Gibt eine GdFont-Instanz zurück. Bei einem Fehler wird `false` zurückgegeben.

### Changelog

Version | Beschreibung
--- | ---
8.1.0 | Gibt nun eine GdFont-Instanz zurück; vorher wurde ein Integer zurückgegeben.

### Beispiele

Beispiel #1 imageloadfont()-Beispiel

    <?php
    // Erzeuge ein neues Bild
    $im = imagecreatetruecolor(50, 20);
    $black = imagecolorallocate($im, 0, 0, 0);
    $white = imagecolorallocate($im, 255, 255, 255);

    // Färbe den Hintergrund weiß
    imagefilledrectangle($im, 0, 0, 49, 19, $white);

    // Lade die GD-Schriftart und schreibe 'Hallo'
    $font = imageloadfont('./04b.gdf');
    imagestring($im, $font, 0, 0, 'Hallo', $black);

    // Ausgabe an Browser
    header('Content-type: image/png');

    imagepng($im);
    ?>

### Siehe auch

- imagefontwidth() - Ermittelt die Breite einer Schriftart
- imagefontheight() - Ermittelt die Höhe einer Schriftart
- imagestring() - Zeichnet einen horizontalen String

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