imageftbbox

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

    imageftbbox — Give the bounding box of a text using fonts via freetype2

    Beschreibung

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

    This function calculates and returns the bounding box in pixels for a FreeType text.

    Hinweis:

    Prior to PHP 8.0.0, imageftbbox() was an extended variant of imagettfbbox() which additionally supported the options. As of PHP 8.0.0, imagettfbbox() is an alias of imageftbbox().

    Parameter-Liste

    size

    Die Schriftgröße in Punkten.

    angle

    Angle in degrees in which string will be measured.

    font_filename

    The name of the TrueType font file (can be a URL). Depending on which version of the GD library that PHP is using, it may attempt to search for files that do not begin with a leading '/' by appending '.ttf' to the filename and searching along a library-defined font path.

    string

    The string to be measured.

    options

    Possible array indexes for options
    KeyTypeMeaning
    linespacingfloatDefines drawing linespacing

    Rückgabewerte

    imageftbbox() returns an array with 8 elements representing four points making the bounding box of the text:

    0lower left corner, X position
    1lower left corner, Y position
    2lower right corner, X position
    3lower right corner, Y position
    4upper right corner, X position
    5upper right corner, Y position
    6upper left corner, X position
    7upper left corner, Y position

    The points are relative to the text regardless of the angle, so "upper left" means in the top left-hand corner seeing the text horizontally.

    On failure, false is returned.

    Beispiele

    Beispiel #1 imageftbbox() example

    <?php
    // Create a 300x150 image
    $im = imagecreatetruecolor(300, 150);
    $black = imagecolorallocate($im, 0, 0, 0);
    $white = imagecolorallocate($im, 255, 255, 255);

    // Set the background to be white
    imagefilledrectangle($im, 0, 0, 299, 299, $white);

    // Path to our font file
    $font = './arial.ttf';

    // First we create our bounding box
    $bbox = imageftbbox(10, 0, $font, 'The PHP Documentation Group');

    // This is our cordinates for X and 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');

    // Output to browser
    header('Content-Type: image/png');

    imagepng($im);
    imagedestroy($im);
    ?>

    Anmerkungen

    Hinweis: Diese Funktion ist nur verfügbar wenn PHP mit Freetype unterstützung (--with-freetype-dir=DIR) kompiliert wurde

    Siehe auch

    • imagefttext() - Write text to the image using fonts using FreeType 2
    • imagettfbbox() - Ermittelt das umgebende Rechteck eines Textes, der eine TrueType-Schriftart verwendet
    To Top