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);
imagedestroy($im);
?>