Dibuja una cadena horizontal

# imagestring

(PHP 4, PHP 5, PHP 7, PHP 8)

imagestring — Dibuja una cadena horizontal

### Descripción

function imagestring(
GdImage `$image`,
GdFont|int `$font`,
int `$x`,
int `$y`,
string `$string`,
int `$color`
): true

Dibuja una cadena en las coordenadas especificadas.

### Parámetros

`image`
  Un objeto GdImage, retornado por una de las funciones de creación de imágenes, como imagecreatetruecolor().
`font`
  Puede ser 1, 2, 3, 4, 5 para las fuentes internas de codificación Latin2 (donde los números más grandes corresponden a fuentes anchas) o una instancia de GdFont retornado por imageloadfont().
`x`

  X: coordenada de la esquina superior izquierda.

`y`

  Y: coordenada de la esquina superior izquierda.

`string`

  La cadena a escribir.

`color`

  Un identificador de color creado con imagecolorallocate().

### Valores devueltos

Retorna siempre `true`.

### Historial de cambios

Versión | Descripción
--- | ---
8.1.0 | El parámetro `font` ahora acepta una instancia de GdFont y un int; anteriormente solo un int era aceptado.
8.0.0 | `image` ahora espera una instancia de GdImage; anteriormente, se esperaba un resource `gd` válido.

### Ejemplos

Ejemplo #1 Ejemplo con imagestring()

    <?php
    // Nueva imagen 100*30
    $im = imagecreate(100, 30);

    // Fondo blanco y texto azul
    $bg = imagecolorallocate($im, 255, 255, 255);
    $textcolor = imagecolorallocate($im, 0, 0, 255);

    // Añadir la frase en la esquina superior izquierda
    imagestring($im, 5, 0, 0, 'Hello world!', $textcolor);

    // Mostrar la imagen
    header('Content-type: image/png');

    imagepng($im);
    ?>

Resultado del ejemplo anterior es similar a:

### Ver también

- imagestringup() - Dibuja una cadena vertical
- imageloadfont() - Carga una nueva fuente
- imagettftext() - Dibuja un texto con una fuente TrueType

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open