ApngOptions Klasse

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

Name	Beschreibung
ApngOptions()	Initialisiert eine neue Instanz der ApngOptions Klasse.

Properties

Name	Type	Access	Beschreibung
DEFAULT_COMPRESSION_LEVEL [static]	PngCompressionLevel	r	Der Standard-Komprimierungsgrad.
bit_depth	System.Byte	r/w	Legt die Bit-Tiefenwerte im Bereich von 1, 2, 4, 8, 16 fest oder ruft sie ab. Beachten Sie die folgenden Grenzen: PngColorType.INDEXED_COLOR unterstützt Bit-Tiefen von 1, 2, 4, 8. PngColorType.GRAYSCALE, PngColorType.GRAYSCALE_WITH_ALPHA unterstützen Bit-Tiefen von 8. PngColorType.TRUECOLOR, PngColorType.TRUECOLOR_WITH_ALPHA unterstützen Bit-Tiefen von 8, 16.
buffer_size_hint	int	r/w	Liest oder setzt den Hinweis zur Puffergröße, der die maximal zulässige Größe für alle internen Puffer definiert.
color_type	PngColorType	r/w	Liest oder setzt den Typ der Farbe.
compression_level	int	r/w	Legt den Komprimierungsgrad der PngImage fest oder ruft ihn ab.
default_frame_time	int	r/w	Legt die Standard-Frame-Dauer fest oder ruft sie ab.
freigegeben	bool	r	Liest einen Wert, der angibt, ob diese Instanz freigegeben ist.
exif_data	ExifData	r/w	Liest oder setzt die Exif‑Instanz.
filter_type	PngFilterType	r/w	Legt den Filtertyp fest, der beim Speichern von PNG-Dateien verwendet wird, oder ruft ihn ab.
full_frame	bool	r/w	Liest oder setzt einen Wert, der angibt, ob [full frame].
keep_metadata	bool	r/w	Liest einen Wert, ob die ursprünglichen Bildmetadaten beim Export beibehalten werden sollen.
multi_page_options	MultiPageOptions	r/w	Die Mehrseiten‑Optionen
num_plays	int	r/w	Legt die Anzahl der Wiederholungen der Animation fest oder ruft sie ab. 0 bedeutet unendliche Wiederholung.
palette	IColorPalette	r/w	Liest oder setzt die Farbpalette.
png_compression_level	PngCompressionLevel	r/w	Legt den Komprimierungsgrad der PngImage fest oder ruft ihn ab.
progressive	bool	r/w	Legt einen Wert fest, der angibt, ob eine PngImage progressiv ist, oder ruft ihn ab.
resolution_settings	ResolutionSetting	r/w	Liest oder setzt die Auflösungseinstellungen.
source	Source	r/w	Liest oder setzt die Quelle, in der das Bild erstellt wird.
vector_rasterization_options	VectorRasterizationOptions	r/w	Liest oder setzt die Vektor‑Rasterisierungsoptionen.
xmp_data	XmpPacketWrapper	r/w	Liest oder setzt XMP-Daten.

Methods

Name	Beschreibung
clone()	Erstellt eine memberweise Kopie dieser Instanz.
try_set_metadata(metadata)	Versucht, eine metadata-Instanz zu setzen, falls diese Image‑Instanz unterstützt und eine IImageMetadataFormat‑Instanz implementiert.

Constructor: ApngOptions()

 ApngOptions()

Initialisiert eine neue Instanz der ApngOptions Klasse.

Property: default_frame_time

Legt die Standard-Frame-Dauer fest oder ruft sie ab.

See also:

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

Property: num_plays

Legt die Anzahl der Wiederholungen der Animation fest oder ruft sie ab.
0 bedeutet unendliche Wiederholung.

See also:

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

Method: clone()

 clone()

Erstellt eine memberweise Kopie dieser Instanz.

Returns

Typ	Beschreibung
ImageOptionsBase	Eine memberweise Kopie dieser Instanz.

Method: try_set_metadata(metadata)

 try_set_metadata(metadata)

Versucht, eine metadata-Instanz zu setzen, falls diese Image‑Instanz unterstützt und eine IImageMetadataFormat‑Instanz implementiert.

Parameters:

Parameter	Typ	Beschreibung
metadata	IImageMetadataFormat	Die Metadaten.

Returns

Typ	Beschreibung
bool	Wahr, wenn metadata nicht null ist und die Instanz von IMetadataContainer unterstützt und/oder eine Instanz von IImageMetadataFormat implementiert; andernfalls falsch.

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:
	# Exportieren zu APNG-Animation mit unbegrenzten Animationszyklen als Standard
	image.save("Animation1.webp.png", ApngOptions())
	# Einrichten von Animationszyklen
	obj_init = ApngOptions()
	# 5 Zyklen
	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:
	# Einrichten der Standard-Frame-Dauer
	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)

BigTiffOptions-Klasse