imagepng

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

imagepngEnví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 recurso image, es devuelto por una de las funciones de creación de imágenes, como imagecreatetruecolor().

file

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.

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

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

Precaución

Sin embargo, si libgd falla al 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 expects a GdImage instance now; previously, a valid gd resource was expected.

Ejemplos

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

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

imagepng($im);
?>

Ver también

  • imagegif() - Exportar la imagen al navegador o a un fichero
  • imagewbmp() - Exportar la imagen al navegador o a un fichero
  • imagejpeg() - Exportar la imagen al navegador o a un fichero
  • imagetypes() - Devuelve los tipos de imágenes soportados por la versión actual de PHP
  • imagesavealpha() - Determina si la información completa del canal alpha debe conservarse al guardar imágenes