imageftbbox
imagegammacorrect
GD Functions
PHP Manual

# imagefttext

(PHP 4 >= 4.0.7, PHP 5)

imagefttext — Write text to the image using fonts using FreeType 2

### Description

array imagefttext ( resource `$image` , float `$size` , float `$angle` , int `$x` , int `$y` , int `$color` , string `$font_file` , string `$text` [, array `$extrainfo` ] )

### Parameters

`image`

  An image resource, returned by one of the image creation functions, such as imagecreatetruecolor().

`size`

  The font size to use in points

`angle`

  The angle in degrees, with 0 degrees being left-to-right reading text. Higher values represent a counter-clockwise rotation. For example, a value of 90 would result in bottom-to-top reading text.

`x`

  The coordinates given by `x` and `y` will define the basepoint of the first character (roughly the lower-left corner of the character). This is different from the imagestring(), where `x` and `y` define the upper-left corner of the first character. For example, "top left" is 0, 0.

`y`

  The y-ordinate. This sets the position of the fonts baseline, not the very bottom of the character.

`color`

  The index of the desired color for the text, see imagecolorexact()

`font_file`

  The full path to the font being used.

`text`

  Text to be inserted into image.

`extrainfo`

### Return Values

This function returns an array defining the four points of the box, starting in the lower left and moving counter-clockwise:

0 | lower left x-coordinate
1 | lower left y-coordinate
2 | lower right x-coordinate
3 | lower right y-coordinate
4 | upper right x-coordinate
5 | upper right y-coordinate
6 | upper left x-coordinate
7 | upper left y-coordinate

### Notes

> Note: This function requires GD 2.0.1 or later (2.0.28 or later is recommended).

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

### ChangeLog

Version | Description
--- | ---
4.3.5 | `extrainfo` was made optional.

imageftbbox
imagegammacorrect
GD Functions
PHP Manual