imageftbbox

PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8
imageftbbox - Give the bounding box of a text using fonts via freetype2
Manual
Code Examples

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.

Note:

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.

Parameters

size

The font size in points.

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
Key Type Meaning
linespacing float Defines drawing linespacing

Return Values

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

0 lower left corner, X position
1 lower left corner, Y position
2 lower right corner, X position
3 lower right corner, Y position
4 upper right corner, X position
5 upper right corner, Y position
6 upper left corner, X position
7 upper 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.

Notes

Note:

This function is only available if PHP is compiled with freetype support (--with-freetype-dir=DIR)

Related Functions

Example of imageftbbox

Show all examples for imageftbbox

PHP Version:


Function imageftbbox:

Image Processing and GD Functions

Most used PHP functions