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)