imagefttext

imagefttext(GdImage $image, float $size, float $angle, int $x, int $y, int $color, string $font_filename, string $text, [array $options]): array
```php

> [!NOTE]
> Antes de PHP 8.0.0, `imagefttext` era una variante extendida de `imagettftext` que además soporta `extrainfo`. A partir de PHP 8.0.0, `imagefttext` es un alias de `imagettftext`.

## Parámetros

`image`  
Un objeto `GdImage`, retornado por una de las funciones de creación de imágenes, como `imagecreatetruecolor`.

`size`  
El tamaño de la fuente a utilizar, en número de puntos.

`angle`  
El ángulo, en grados; 0 grados para una lectura del texto de izquierda a derecha. Los grandes valores representan una rotación en el sentido de las agujas de un reloj. Por ejemplo, un valor de 90 tendrá como efecto leer el texto de abajo hacia arriba.

`x`  
Las coordenadas, proporcionadas por `x` y `y` definen el punto de inicio del primer carácter (y más precisamente, la esquina en la parte inferior izquierda del carácter). Este es un comportamiento diferente de la función `imagestring`, donde `x` y `y` definen la esquina superior, a la izquierda del primer carácter. Por ejemplo, en la parte superior izquierda vale 0, 0.

`y`  
La ordenada `y-ordinate`. Este parámetro configura la posición base de la fuente, y no la parte inferior de esta última.

`color`  
El índice del color deseado para el texto, ver la función `imagecolorexact`.

`font_filename`  
La ruta hacia la fuente TrueType a utilizar.

Dependiendo de la versión de GD utilizada por PHP, se buscarán los ficheros *que no comienzan con un '`/`', añadiendo la extensión '`.ttf`'*, y siguiendo la ruta de las fuentes definida por la biblioteca.

En la mayoría de los casos, cuando la fuente se encuentra en el mismo directorio que el script que intenta utilizarla, la siguiente solución permite evitar todos los problemas relativos a la inclusión.

`text`  
El texto a insertar en la imagen.

`options`  
| Clave         | Tipo    | Significado                                 |
|---------------|---------|---------------------------------------------|
| `linespacing` | `float` | Define el espaciado entre líneas al dibujar |

Índices posibles para el array `options`

## Valores devueltos

Esta función devuelve un array que define los 4 puntos de una caja, comenzando por la esquina inferior, a la izquierda, luego, los siguientes, en el sentido de las agujas de un reloj:

|     |                                                     |
|-----|-----------------------------------------------------|
| 0   | x : coordenada en la parte inferior, a la izquierda |
| 1   | y : coordenada en la parte inferior, a la izquierda |
| 2   | x : coordenada en la parte inferior, a la derecha   |
| 3   | y : coordenada en la parte inferior, a la derecha   |
| 4   | x : coordenada en la parte superior, a la derecha   |
| 5   | y : coordenada en la parte superior, a la derecha   |
| 6   | x : coordenada en la parte superior, a la izquierda |
| 7   | y : coordenada en la parte superior, a la izquierda |

En caso de error, `false` es devuelto.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.0.0 | `image` ahora espera una instancia de `GdImage` ; anteriormente, se esperaba un recurso `gd` de tipo `resource` válido. |

## Ejemplos

Ejemplo con `imagefttext`