# imageloadfont

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

imageloadfont — Lädt eine neue Schriftart

### Beschreibung

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