Genera una imagen en formato GD, hacia el navegador o un fichero

# imagegd

(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)

imagegd — Genera una imagen en formato GD, hacia el navegador o un fichero

### Descripción

function imagegd(GdImage `$image`, ?string `$file` = `null`): bool

Genera o guarda el fichero `file` en formato GD.

### Parámetros

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

  La ruta o un recurso de flujo abierto (que se cierra automáticamente después de que esta función retorne) donde guardar el archivo. Si no se define o es `null`, el flujo de imagen sin procesar se enviará directamente.

### Valores devueltos

Esta función retorna `true` en caso de éxito o `false` si ocurre un error.

Precaución

Sin embargo, si libgd no logra producir la imagen, esta función devuelve `true`.

### Historial de cambios

Versión | Descripción
--- | ---
8.0.3 | `file` ahora es nullable.
8.0.0 | `image` ahora espera una instancia de GdImage; anteriormente, se esperaba un resource `gd` válido.
7.2.0 | imagegd() ahora permite producir imágenes TrueColor. Anteriormente, eran convertidas implícitamente a paleta.

### Ejemplos

Ejemplo #1 Mostrar una imagen GD

    <?php
    // Creación de una imagen vacía y adición de texto
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5,  "Un texto simple", $text_color);

    // Mostrar la imagen
    imagegd($im);

    ?>

Ejemplo #2 Guardar una imagen GD

    <?php
    // Creación de una imagen vacía y adición de texto
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5,  "Un texto simple", $text_color);

    // Guardar la imagen GD
    // El formato de fichero para imágenes GD es .gd, ver http://www.libgd.org/GdFileFormats
    imagegd($im, 'simple.gd');

    ?>

### Notas

> Nota:

> El formato GD se utiliza comúnmente para permitir la carga rápida de partes de una imagen. Tenga en cuenta que el formato GD solo es utilizable en aplicaciones compatibles con GD.

Advertencia

Los formatos de imagen GD y GD2 son formatos propietarios de libgd. Deben considerarse obsoletos, y solo deben utilizarse con fines de desarrollo y pruebas.

### Ver también

- imagegd2() - Genera una imagen en formato GD2, hacia el navegador o un fichero

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