Calcule le rectangle d'encadrement pour un texte, en utilisant la police courante et freetype2

# imageftbbox

(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)

imageftbbox — Calcule le rectangle d'encadrement pour un texte, en utilisant la police courante et freetype2

### Description

function imageftbbox(
float `$size`,
float `$angle`,
string `$font_filename`,
string `$string`,
array `$options` = []
): array|false

Cette fonction calcule et retourne le rectangle d'encadrement en pixels pour un texte FreeType.

> Note:

> Antérieurement à PHP 8.0.0, imageftbbox() était une variante étendue de imagettfbbox() qui en plus supportait `options`. À partir de PHP 8.0.0, imagettfbbox() est un alias de imageftbbox().

### Liste de paramètres

`size`

  La taille de la police de caractères en point.

`angle`

  Angle, en degrés, dans lequel le paramètre `string` sera mesuré.

`font_filename`

  Le nom du fichier de la police TrueType (peut être une URL). Suivant la version de GD utilisée par PHP, il sera recherché les fichiers qui ne commencent pas par un '/', en y ajoutant l'extension '.ttf', et suivant le chemin des polices défini par la bibliothèque.

`string`

  La chaîne à mesurer.

`options`

  Index possibles pour le tableau `options`
  Clé | Type | Signification
  --- | --- | ---
  `linespacing` | float | Représente l'espacement entre les lignes lors du dessin

### Valeurs de retour

imageftbbox() retourne un tableau contenant 8 éléments représentant les 4 points du rectangle entourant le texte :

0 | Coin en bas, à gauche, position en X
1 | Coin en bas, à gauche, position en Y
2 | Coin en bas, à droite, position en X
3 | Coin en bas, à droite, position en Y
4 | Coin en haut, à droite, position en X
5 | Coin en haut, à droite, position en Y
6 | Coin en haut, à gauche, position en X
7 | Coin en haut, à gauche, position en Y

Les points sont relatifs au texte indépendamment du paramètre `angle`, ainsi, "en haut à gauche" signifie le coin en haut à gauche lorsque l'on regarde le texte horizontalement.

En cas d'échec, `false` est retourné.

### Exemples

Exemple #1 Exemple avec imageftbbox()

    <?php
    // Création d'une image de 300x150 pixels
    $im = imagecreatetruecolor(300, 150);
    $black = imagecolorallocate($im, 0, 0, 0);
    $white = imagecolorallocate($im, 255, 255, 255);

    // Définit l'arrière-plan en blanc
    imagefilledrectangle($im, 0, 0, 299, 299, $white);

    // Chemin vers notre fichier de police
    $font = './arial.ttf';

    // D'abord, nous créons un rectangle contenant notre texte
    $bbox = imageftbbox(10, 0, $font, 'The PHP Documentation Group');

    // Nos coordonnées en X et en Y
    $x = $bbox[0] + (imagesx($im) / 2) - ($bbox[4] / 2) - 5;
    $y = $bbox[1] + (imagesy($im) / 2) - ($bbox[5] / 2) - 5;

    imagefttext($im, 10, 0, $x, $y, $black, $font, 'The PHP Documentation Group');

    // Affichage vers le navigateur
    header('Content-Type: image/png');

    imagepng($im);
    ?>

### Notes

> Note: Cette fonction n'est disponible que si si PHP est compilé avec le support Freetype (--with-freetype-dir=DIR)

### Voir aussi

- imagefttext() - Écrit du texte dans une image avec la police courante FreeType 2
- imagettfbbox() - Retourne le rectangle entourant un texte et dessiné avec une police TrueType

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