# imageloadfont

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

imageloadfont — Charge une nouvelle police

### Description

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

imageloadfont() charge une nouvelle police utilisateur et retourne son identifiant.

### Liste de paramètres

`filename`

  Le format des polices dépend actuellement du système d'exploitation. Ce qui signifie qu'il vous faut générer des fichiers de polices pour la machine qui fait tourner PHP.

  Format de fichier de police
  Position | Type de données C | Description
  --- | --- | ---
  Octets 0-3 | int | Nombre de caractères de la police
  Octets 4-7 | int | Valeur du premier caractère de la police (souvent 32 pour espace)
  Octets 8-11 | int | Largeur en pixels des caractères
  Octets 12-15 | int | Hauteur en pixels des caractères
  Octets 16- | char | Tableau avec les données des caractères, un octet par pixel pour chaque caractère, avec un total de (nombre de caractères * largeur * hauteur) octets.

### Valeurs de retour

Retourne une instance GdFont, ou `false` si une erreur survient.

### Historique

Version | Description
--- | ---
8.1.0 | Retourne désormais une instance de GdFont; auparavant, un entier était retourné.

### Exemples

Exemple #1 Exemple avec imageloadfont()

`<?php
// Création d'une nouvelle image
$im = imagecreatetruecolor(50, 20);
$black = imagecolorallocate($im, 0, 0, 0);
$white = imagecolorallocate($im, 255, 255, 255);
// Définit l'arrière-plan en blanc
imagefilledrectangle($im, 0, 0, 49, 19, $white);
// Charge la police GD et écrit 'Bonjour !'
$font = imageloadfont('./04b.gdf');
imagestring($im, $font, 0, 0, 'Bonjour !', $black);
// Affichage sur le navigateur
header('Content-type: image/png');
imagepng($im);
?>`

### Voir aussi

- imagefontwidth() - Retourne la largeur de la police
- imagefontheight() - Retourne la hauteur de la police
- imagestring() - Dessine une chaîne horizontale