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 objeto GdImage, retornado por una de las funciones de creación de imágenes, como imagecreatetruecolor().

file

The path or an open stream resource (which is automatically closed after this function returns) to save the file to. If not set or null, the raw image stream will be output directly.

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

However, if libgd fails to output the image, this function returns 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() - Output image to browser or file
  • imagewbmp() - Output image to browser or file
  • imagejpeg() - Output image to browser or file
  • 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