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

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

  • imagegif() - Enviar la imagen al navegador o a un archivo
  • imagewbmp() - Enviar la imagen al navegador o a un archivo
  • imagejpeg() - Enviar la imagen al navegador o a un archivo
  • 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