array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.imagepng.php', 1 => 'imagepng', 2 => 'Envía una imagen PNG a un navegador o a un fichero', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'Funciones de GD e Imágenes', ), 'prev' => array ( 0 => 'function.imagepalettetotruecolor.php', 1 => 'imagepalettetotruecolor', ), 'next' => array ( 0 => 'function.imagepolygon.php', 1 => 'imagepolygon', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/image/functions/imagepng.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

imagepng

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

imagepng — Envía una imagen PNG a un navegador o a un fichero

Descripción

imagepng(
    GdImage $image,
    resource|string|null $file = null,
    int $quality = -1,
    int $filters = -1
): bool

imagepng() muestra o guarda una imagen en formato PNG utilizando la imagen image.

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.

Nota:

El valor null es inválido si el argumento quality y el argumento filters no son utilizados.

quality

Grado de compresión: desde 0 (ninguna compresión) hasta 9. El valor por omisión (-1) utiliza la compresión por omisión de zlib. Para más información ver el » manual zlib.

filters

Permite la reducción del tamaño del fichero PNG. Es una máscara que puede ser definida por una combinación de las constantes PNG_FILTER_*. PNG_NO_FILTER o PNG_ALL_FILTERS pueden ser utilizados para, respectivamente, desactivar o activar todos los filtros. El valor por omisión (-1) desactiva el filtrado.

Precaución

El argumento filters es ignorado por system libgd.

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.

Errores/Excepciones

Genera una ValueError si quality es inválido.

Historial de cambios

Versión Descripción
8.4.0 Genera ahora una ValueError si quality es inválido.
8.0.0 image ahora espera una instancia de GdImage; anteriormente, se esperaba un resource gd válido.

Ejemplos

<?php
$im = imagecreatefrompng("test.png");

header('Content-Type: image/png');

imagepng($im);
?>

Ver también