ApngOptions-klass

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

NameDescription
ApngOptions()Initierar en ny instans av klassen ApngOptions.

Properties

NameTypeAccessDescription
DEFAULT_COMPRESSION_LEVEL [static]PngCompressionLevelrStandardkomprimeringsnivån.
bit_depthSystem.Byter/wHämtar eller anger bitdjupsvärdena i intervallet 1, 2, 4, 8, 16.


Observera följande begränsningar:


PngColorType.INDEXED_COLOR stöder bitdjup på 1, 2, 4, 8.


PngColorType.GRAYSCALE, PngColorType.GRAYSCALE_WITH_ALPHA stöder bitdjup på 8.


PngColorType.TRUECOLOR, PngColorType.TRUECOLOR_WITH_ALPHA stöder bitdjup på 8, 16.

buffer_size_hintintr/wHämtar eller anger en ledtråd för buffertstorlek som definierar maximal tillåten storlek för alla interna buffertar.
color_typePngColorTyper/wHämtar eller anger färgens typ.
compression_levelintr/wHämtar eller anger komprimeringsnivån för PngImage.
default_frame_timeintr/wHämtar eller anger standardramens varaktighet.
disposedboolrHämtar ett värde som indikerar om den här instansen är frigjord.
exif_dataExifDatar/wHämtar eller anger Exif-instans.
filter_typePngFilterTyper/wHämtar eller anger filtertypen som används under sparprocessen för png‑filen.
full_frameboolr/wHämtar eller anger ett värde som indikerar om [full frame].
keep_metadataboolr/wHämtar ett värde som anger om originalmetadata för bilden ska behållas vid export.
multi_page_optionsMultiPageOptionsr/wFlersidiga alternativ
num_playsintr/wHämtar eller anger antalet gånger animationen ska loopas.
0 indikerar oändlig loopning.
paletteIColorPaletter/wHämtar eller anger färgpaletten.
png_compression_levelPngCompressionLevelr/wHämtar eller anger komprimeringsnivån för PngImage.
progressiveboolr/wHämtar eller anger ett värde som indikerar om en PngImage är progressiv.
resolution_settingsResolutionSettingr/wHämtar eller anger upplösningsinställningarna.
sourceSourcer/wHämtar eller anger källan där bilden ska skapas.
vector_rasterization_optionsVectorRasterizationOptionsr/wHämtar eller anger vektorrasteriseringsalternativen.
xmp_dataXmpPacketWrapperr/wHämtar eller anger Xmp-data.

Methods

NameDescription
clone()Skapar en medlemsvis klon av detta objekt.
try_set_metadata(metadata)Försöker sätta en metadata-instans, om detta Image-instans stödjer och implementerar IImageMetadataFormat-instansen.

Constructor: ApngOptions()

 ApngOptions() 

Initierar en ny instans av klassen ApngOptions.

Property: default_frame_time

Hämtar eller anger standardramens varaktighet.

See also:

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

Property: num_plays

Hämtar eller anger antalet gånger animationen ska loopas.
0 indikerar oändlig loopning.

See also:

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

Method: clone()

 clone() 

Skapar en medlemsvis klon av detta objekt.

Returns

TypBeskrivning
ImageOptionsBaseEn medlemsvis klon av detta objekt.

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

Försöker sätta en metadata-instans, om detta Image-instans stödjer och implementerar IImageMetadataFormat-instansen.

Parameters:

ParameterTypBeskrivning
metadataIImageMetadataFormatMetadata.

Returns

TypBeskrivning
boolSant om metadata inte är null och IMetadataContainer‑instansen
stöder och/eller implementerar IImageMetadataFormat‑instansen; annars falskt.

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:
	# Exportera till APNG-animation med obegränsade animationscykler som standard
	image.save("Animation1.webp.png", ApngOptions())
	# Ställa in animationscykler
	obj_init = ApngOptions()
	# 5 cykler
	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:
	# Ställa in standardramens varaktighet
	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)