Classe 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
| Name | Description |
|---|---|
| ApngOptions() | Initialise une nouvelle instance de la classe ApngOptions. |
Properties
| Name | Type | Access | Description |
|---|---|---|---|
| DEFAULT_COMPRESSION_LEVEL [static] | PngCompressionLevel | r | Le niveau de compression par défaut. |
| bit_depth | System.Byte | r/w | Obtient ou définit les valeurs de profondeur de bits dans la plage de 1, 2, 4, 8, 16. Respectez les limites suivantes : PngColorType.INDEXED_COLOR prend en charge une profondeur de bits de 1, 2, 4, 8. PngColorType.GRAYSCALE, PngColorType.GRAYSCALE_WITH_ALPHA prennent en charge une profondeur de bits de 8. PngColorType.TRUECOLOR, PngColorType.TRUECOLOR_WITH_ALPHA prennent en charge une profondeur de bits de 8, 16. |
| buffer_size_hint | int | r/w | Obtient ou définit l’indice de taille du tampon, qui correspond à la taille maximale autorisée pour tous les tampons internes. |
| color_type | PngColorType | r/w | Obtient ou définit le type de couleur. |
| compression_level | int | r/w | Obtient ou définit le niveau de compression du PngImage. |
| default_frame_time | int | r/w | Obtient ou définit la durée d’image par défaut. |
| libéré | bool | r | Obtient une valeur indiquant si cette instance est libérée. |
| exif_data | ExifData | r/w | Obtient ou définit l’instance Exif. |
| filter_type | PngFilterType | r/w | Obtient ou définit le type de filtre utilisé lors du processus d’enregistrement du fichier png. |
| full_frame | bool | r/w | Obtient ou définit une valeur indiquant si [full frame]. |
| keep_metadata | bool | r/w | Obtient une valeur indiquant s’il faut conserver les métadonnées d’image originales lors de l’exportation. |
| multi_page_options | MultiPageOptions | r/w | Les options multipages |
| num_plays | int | r/w | Obtient ou définit le nombre de répétitions de l’animation. 0 indique une boucle infinie. |
| palette | IColorPalette | r/w | Obtient ou définit la palette de couleurs. |
| png_compression_level | PngCompressionLevel | r/w | Obtient ou définit le niveau de compression du PngImage. |
| progressive | bool | r/w | Obtient ou définit une valeur indiquant si un PngImage est progressif. |
| resolution_settings | ResolutionSetting | r/w | Obtient ou définit les paramètres de résolution. |
| source | Source | r/w | Obtient ou définit la source dans laquelle créer l’image. |
| vector_rasterization_options | VectorRasterizationOptions | r/w | Obtient ou définit les options de rasterisation vectorielle. |
| xmp_data | XmpPacketWrapper | r/w | Obtient ou définit les données Xmp. |
Methods
| Name | Description |
|---|---|
| clone() | Crée un clone membre à membre de cette instance. |
| try_set_metadata(metadata) | Essaie de définir une instance metadata, si cette instance Image prend en charge et implémente l’instance IImageMetadataFormat. |
Constructor: ApngOptions()
ApngOptions()
Initialise une nouvelle instance de la classe ApngOptions.
Property: default_frame_time
Obtient ou définit la durée d’image par défaut.
See also:
Example # 1: The following example shows how to export apng APNG file format from other no…
Property: num_plays
Obtient ou définit le nombre de répétitions de l’animation.
0 indique une boucle infinie.
See also:
Example # 1: The following example shows how to export to APNG file format.
Method: clone()
clone()
Crée un clone membre à membre de cette instance.
Returns
| Type | Description |
|---|---|
| ImageOptionsBase | Un clone membre à membre de cette instance. |
Method: try_set_metadata(metadata)
try_set_metadata(metadata)
Essaie de définir une instance metadata, si cette instance Image prend en charge et implémente l’instance IImageMetadataFormat.
Parameters:
| Paramètre | Type | Description |
|---|---|---|
| metadata | IImageMetadataFormat | Les métadonnées. |
Returns
| Type | Description |
|---|---|
| bool | Vrai si metadata n’est pas nul et que l’instance IMetadataContainer prend en charge et/ou implémente l’instance IImageMetadataFormat ; sinon, faux. |
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:
# Exporter vers une animation APNG avec des cycles d'animation illimités par défaut
image.save("Animation1.webp.png", ApngOptions())
# Configuration des cycles d'animation
obj_init = ApngOptions()
# 5 cycles
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:
# Configuration de la durée du cadre par défaut
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)
