(PHP 4, PHP 5, PHP 7, PHP 8)
imagepng — Envía una imagen PNG a un navegador o a un fichero
$image
,$file
= null
,$quality
= -1,$filters
= -1
imagepng() muestra o guarda una
imagen en formato PNG utilizando
la imagen image
.
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 argumentoquality
y el argumentofilters
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.
El argumento filters
es ignorado por system libgd.
Devuelve true
en caso de éxito o false
en caso de error.
Sin embargo, si libgd falla al producir la imagen, esta función devuelve true
.
Genera una ValueError si quality
es inválido.
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.
|
<?php
$im = imagecreatefrompng("test.png");
header('Content-Type: image/png');
imagepng($im);
?>