# imagegd

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

imagegd — Imprime una imagen GD2 a un navegador o archivo

### Descripción

imagegd(resource `$image`, string `$filename` = ?): bool

Imprime una imagen GD en `filename`.

### Parámetros

`image`

  Un recurso image, es devuelto por una de las funciones de creación de imágenes, como imagecreatetruecolor().

`filename`

  La ruta o un recurso de flujo de apertura (el cual se cierra automáticamente después de que devuelva esta función) donde guardar el fichero. Si no se establece, o su valor es `null`, se mostrará directamente en la salida el flujo de imagen sin tratar.

### Valores devueltos

Devuelve `true` en caso de éxito o `false` en caso de error.

### Ejemplos

Ejemplo #1 Imprimir una imagen GD

`<?php
// Crear una imagen en blanco y añadir algún texto
$im = imagecreatetruecolor(120, 20);
$color_texto = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, "Una Sencilla Cadena De Texto", $color_texto);
// Imprimir la imagen
imagegd($im);
// Liberar memoria
imagedestroy($im);
?>`

Ejemplo #2 Saving a GD image

`<?php
// Crear una imagen en blanco y añadir algún texto
$im = imagecreatetruecolor(120, 20);
$color_texto = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, "Una Sencilla Cadena De Texto", $color_texto);
// Guardar la imagen gd
// El formato de archivo para imágenes GD es .gd, véase http://www.libgd.org/GdFileFormats
imagegd($im, 'simple.gd');
// Liberar memoria
imagedestroy($im);
?>`

### Notas

> Nota:

> El formato GD2 se usa comúnmente para permitir una carga rápida de partes de imágenes. Observe que el formato GD2 sólo es utilizable en aplicaciones compatibles con GD2.

### Ver también

- imagegd2() - Imprime una imagen GD2 a un navegador o fichero