Clase ApngOptions

Summary: The API for Animated PNG (Animated Portable Network Graphics) image file format
creation is a dynamic tool for developers seeking to generate captivating
animated images. With customizable options such as frame duration and the
number of times to loop, this API allows for fine-tuning animated content
according to specific needs. Whether creating engaging web graphics or
interactive visuals, you can leverage this API to seamlessly incorporate
APNG images with precise control over animation parameters.

Module: aspose.imaging.imageoptions

Full Name: aspose.imaging.imageoptions.ApngOptions

Inheritance: IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, PngOptions

Constructors

NameDescripción
ApngOptions()Inicializa una nueva instancia de la clase ApngOptions.

Properties

NameTypeAccessDescripción
DEFAULT_COMPRESSION_LEVEL [static]PngCompressionLevelrEl nivel de compresión predeterminado.
bit_depthSystem.Byter/wObtiene o establece los valores de profundidad de bits en el rango de 1, 2, 4, 8, 16.


Tenga en cuenta los siguientes límites:


PngColorType.INDEXED_COLOR soporta profundidad de bits de 1, 2, 4, 8.


PngColorType.GRAYSCALE, PngColorType.GRAYSCALE_WITH_ALPHA soportan profundidad de bits de 8.


PngColorType.TRUECOLOR, PngColorType.TRUECOLOR_WITH_ALPHA soportan profundidad de bits de 8, 16.

buffer_size_hintintr/wObtiene o establece la sugerencia de tamaño del búfer, que se define como el tamaño máximo permitido para todos los búferes internos.
color_typePngColorTyper/wObtiene o establece el tipo de color.
compression_levelintr/wObtiene o establece el nivel de compresión del PngImage.
default_frame_timeintr/wObtiene o establece la duración predeterminada del fotograma.
disposedboolrObtiene un valor que indica si esta instancia está disposed.
exif_dataExifDatar/wObtiene o establece la instancia Exif.
filter_typePngFilterTyper/wObtiene o establece el tipo de filtro usado durante el proceso de guardado del archivo png.
full_frameboolr/wObtiene o establece un valor que indica si [full frame].
keep_metadataboolr/wObtiene un valor que indica si conservar los metadatos originales de la imagen al exportar.
multi_page_optionsMultiPageOptionsr/wLas opciones multipágina
num_playsintr/wObtiene o establece el número de repeticiones de la animación.
0 indica bucle infinito.
paletteIColorPaletter/wObtiene o establece la paleta de colores.
png_compression_levelPngCompressionLevelr/wObtiene o establece el nivel de compresión del PngImage.
progressiveboolr/wObtiene o establece un valor que indica si un PngImage es progresivo.
resolution_settingsResolutionSettingr/wObtiene o establece la configuración de resolución.
sourceSourcer/wObtiene o establece la fuente en la que crear la imagen.
vector_rasterization_optionsVectorRasterizationOptionsr/wObtiene o establece las opciones de rasterización vectorial.
xmp_dataXmpPacketWrapperr/wObtiene o establece los datos Xmp.

Methods

NameDescripción
clone()Crea una clonación por miembros de esta instancia.
try_set_metadata(metadata)Intenta establecer una instancia de metadata, si esta instancia de Image admite e implementa la instancia IImageMetadataFormat.

Constructor: ApngOptions()

 ApngOptions() 

Inicializa una nueva instancia de la clase ApngOptions.

Property: default_frame_time

Obtiene o establece la duración predeterminada del fotograma.

See also:

Example # 1: The following example shows how to export apng APNG file format from other no…

Property: num_plays

Obtiene o establece el número de repeticiones de la animación.
0 indica bucle infinito.

See also:

Example # 1: The following example shows how to export to APNG file format.

Method: clone()

 clone() 

Crea una clonación por miembros de esta instancia.

Returns

TipoDescripción
ImageOptionsBaseUna clonación por miembros de esta instancia.

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

Intenta establecer una instancia de metadata, si esta instancia de Image admite e implementa la instancia IImageMetadataFormat.

Parameters:

ParámetroTipoDescripción
metadataIImageMetadataFormatLos metadatos.

Returns

TipoDescripción
boolVerdadero si metadata no es nulo y la instancia de IMetadataContainer
admite y/o implementa la instancia de IImageMetadataFormat; de lo contrario, falso.

Examples

The following example shows how to export to APNG file format.


import aspose.pycore as aspycore
from aspose.imaging import *
from aspose.imaging.imageoptions import *

with Image.load("Animation1.webp") as image:
	# Exportar a animación APNG con ciclos de animación ilimitados por defecto
	image.save("Animation1.webp.png", ApngOptions())
	# Configurando ciclos de animación
	obj_init = ApngOptions()
	# 5 ciclos
	obj_init.num_plays = 5
	image.save("Animation2.webp.png", obj_init)

The following example shows how to export apng APNG file format from other non-animated multi-page format.


from aspose.imaging import Image
from aspose.imaging.imageoptions import ApngOptions

with Image.load("img4.tif") as image:
	# Configurando la duración del cuadro predeterminado
	obj_init = ApngOptions()
	# 500 ms
	obj_init.default_frame_time = 500
	image.save("img4.tif.500ms.png", obj_init)
	obj_init2 = ApngOptions()
	# 250 ms
	obj_init2.default_frame_time = 250
	image.save("img4.tif.250ms.png", obj_init2)