imageftbbox

Function • Params and return types changed in PHP 8.0

Give the bounding box of a text using fonts via freetype2.

PHP 5
PHP 7
PHP 8.0
Improved
PHP 8.1
PHP 8.2-8.3
PHP 8.4
PHP 8.5
PHP 8.6

imageftbbox Function synopsis

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

Parameters

$size

Typefloat

The font size in points.

$angle

Typefloat

Angle in degrees in which $string will be measured.

$font_filename

Typestring

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

Typestring

The string to be measured.

$options

OptionalTypearrayDefault value[]

Return value

Typearray|false

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

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.

Changes to the imageftbbox Function

PHP 8.0

  • Return type added: array|false
  • Parameter type added for parameter #1 ($size): float
  • Parameter type added for parameter #2 ($angle): float
  • Parameter name of parameter #3 changed: $font_file to $font_filename
  • Parameter type added for parameter #3 ($font_filename): string
  • Parameter name of parameter #4 changed: $text to $string
  • Parameter type added for parameter #4 ($string): string
  • Parameter name of parameter #5 changed: $extrainfo to $options
  • Parameter type added for parameter #5 ($options): array
  • Parameter default value added for position #5 ($options): []
  imageftbbox(
-     $size,
+     float $size,
-     $angle,
+     float $angle,
-     $font_file,
+     string $font_filename,
-     $text,
+     string $string,
-     $extrainfo
+     array $options = []
-   )
+   ): array|false

imageftbbox Function Availability

PHP VersionAvailability
PHP 8.6Upcoming Release Yes
PHP 8.5Supported (Latest) Yes
PHP 8.4Supported Yes
PHP 8.3Security-Fixes Only Yes
PHP 8.2Security-Fixes Only Yes
PHP 8.1Unsupported Yes
PHP 8.0Unsupported Yes
PHP 7.4Unsupported Yes
PHP 7.3Unsupported Yes
PHP 7.2Unsupported Yes
PHP 7.1Unsupported Yes
PHP 7.0Unsupported Yes
PHP 5.6Unsupported Yes
PHP 5.5Unsupported Yes
PHP 5.4Unsupported Yes
PHP 5.3Unsupported Yes