imagettfbbox

FunctionParams and return types changed in PHP 8.0

Give the bounding box of a text using TrueType fonts.

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

imagettfbbox Function synopsis

imagettfbbox(
    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

$string

Typestring

The string to be measured.

$options

OptionalTypearrayDefault value[]

Same as in imagettftext.

Return value

Typearray|false

imagettfbbox returns an array with 8 elements representing four points making the bounding box of the text on success and false on error.

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.

Changes to the imagettfbbox Function

PHP 8.0

  • Return type added: array|false
  • Optional parameter added - #5: array $options = []
 imagettfbbox(
-    $size,
-    $angle,
-    $font_file,
-    $text
-  )
+    float $size,
+    float $angle,
+    string $font_filename,
+    string $string,
+    array $options = []
+  ): array|false

imagettfbbox 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