Класс 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() | Инициализирует новый экземпляр класса ApngOptions. |
Properties
| Name | Type | Access | Description |
|---|---|---|---|
| DEFAULT_COMPRESSION_LEVEL [static] | PngCompressionLevel | r | Уровень сжатия по умолчанию. |
| bit_depth | System.Byte | r/w | Получает или задаёт значения глубины цвета в диапазоне 1, 2, 4, 8, 16. Учтите следующие ограничения: PngColorType.INDEXED_COLOR поддерживает глубину цвета 1, 2, 4, 8. PngColorType.GRAYSCALE, PngColorType.GRAYSCALE_WITH_ALPHA поддерживают глубину цвета 8. PngColorType.TRUECOLOR, PngColorType.TRUECOLOR_WITH_ALPHA поддерживают глубину цвета 8, 16. |
| buffer_size_hint | int | r/w | Получает или задает подсказку о размере буфера, определяющую максимальный допустимый размер для всех внутренних буферов. |
| color_type | PngColorType | r/w | Получает или задает тип цвета. |
| compression_level | int | r/w | Получает или задаёт уровень сжатия PngImage. |
| default_frame_time | int | r/w | Получает или задаёт длительность кадра по умолчанию. |
| disposed | bool | r | Получает значение, указывающее, удалён ли этот экземпляр. |
| exif_data | ExifData | r/w | Получает или задаёт экземпляр Exif. |
| filter_type | PngFilterType | r/w | Получает или задаёт тип фильтра, используемый при сохранении PNG‑файла. |
| full_frame | bool | r/w | Получает или задает значение, указывающее, включен ли [full frame]. |
| keep_metadata | bool | r/w | Получает значение, указывающее, сохранять ли оригинальные метаданные изображения при экспорте. |
| multi_page_options | MultiPageOptions | r/w | Параметры multipage |
| num_plays | int | r/w | Получает или задаёт количество повторов анимации. 0 указывает на бесконечный цикл. |
| palette | IColorPalette | r/w | Получает или задает цветовую палитру. |
| png_compression_level | PngCompressionLevel | r/w | Получает или задаёт уровень сжатия PngImage. |
| progressive | bool | r/w | Получает или задаёт значение, указывающее, является ли PngImage прогрессивным. |
| resolution_settings | ResolutionSetting | r/w | Получает или задает параметры разрешения. |
| source | Source | r/w | Получает или задает источник, в котором создаётся изображение. |
| vector_rasterization_options | VectorRasterizationOptions | r/w | Получает или задает параметры растеризации вектора. |
| xmp_data | XmpPacketWrapper | r/w | Получает или задает данные Xmp. |
Methods
| Name | Description |
|---|---|
| clone() | Создаёт поверхностную копию этого экземпляра. |
| try_set_metadata(metadata) | Пытается установить экземпляр metadata, если этот экземпляр Image поддерживает и реализует экземпляр IImageMetadataFormat. |
Constructor: ApngOptions()
ApngOptions()
Инициализирует новый экземпляр класса ApngOptions.
Property: default_frame_time
Получает или задаёт длительность кадра по умолчанию.
See also:
Example # 1: The following example shows how to export apng APNG file format from other no…
Property: num_plays
Получает или задаёт количество повторов анимации.
0 указывает на бесконечный цикл.
See also:
Example # 1: The following example shows how to export to APNG file format.
Method: clone()
clone()
Создаёт поверхностную копию этого экземпляра.
Returns
| Тип | Описание |
|---|---|
| ImageOptionsBase | Поверхностная копия этого экземпляра. |
Method: try_set_metadata(metadata)
try_set_metadata(metadata)
Пытается установить экземпляр metadata, если этот экземпляр Image поддерживает и реализует экземпляр IImageMetadataFormat.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| metadata | IImageMetadataFormat | Метаданные. |
Returns
| Тип | Описание |
|---|---|
| bool | Истина, если metadata не равно null и экземпляр IMetadataContainer поддерживает и/или реализует экземпляр IImageMetadataFormat; в противном случае — ложь. |
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:
# Экспорт в анимацию APNG с неограниченным количеством циклов анимации по умолчанию
image.save("Animation1.webp.png", ApngOptions())
# Настройка циклов анимации
obj_init = ApngOptions()
# 5 циклов
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:
# Настройка длительности кадра по умолчанию
obj_init = ApngOptions()
# 500 мс
obj_init.default_frame_time = 500
image.save("img4.tif.500ms.png", obj_init)
obj_init2 = ApngOptions()
# 250 мс
obj_init2.default_frame_time = 250
image.save("img4.tif.250ms.png", obj_init2)
