ApngImage

Inheritance: java.lang.Object, com.aspose.imaging.DisposableObject, com.aspose.imaging.DataStreamSupporter, com.aspose.imaging.Image, com.aspose.imaging.RasterImage, com.aspose.imaging.RasterCachedImage, com.aspose.imaging.RasterCachedMultipageImage

All Implemented Interfaces: com.aspose.imaging.IMultipageImageExt

public final class ApngImage extends RasterCachedMultipageImage implements IMultipageImageExt

Animated PNG（Animated Portable Network Graphics）图像文件格式的 API 是面向希望在其应用程序中集成动画内容的开发者的多功能解决方案。该 API 提供对帧设置的广泛控制，允许用户定义帧特定参数，包括循环持续时间和 PNG 文件设置。借助此功能丰富的工具，您可以轻松管理和优化 APNG 图像的显示，导入和导出图像，提升应用程序的动态和交互性。

构造函数

构造函数	描述
ApngImage(ApngOptions options, int width, int height)	通过轻松初始化新实例，开始使用 ApngImage 类。

方法

方法	描述
getFileFormat()	使用此便利属性，快速访问文件格式的信息。
getPageCount()	使用此属性，轻松检索图像文件的总页数。
getPages()	使用此便利属性，轻松访问图像的页面。
getNumPlays()	使用此多功能属性，轻松控制动画循环的次数。
setNumPlays(int value)	使用此多功能属性，轻松控制动画循环的次数。
getDefaultFrameTime()	使用此灵活属性，轻松调整创建新帧的默认帧持续时间。
setDefaultFrameTime(long value)	使用此灵活属性，轻松调整创建新帧的默认帧持续时间。
getInterlaced()	使用此便利属性，快速确定此 PngImage 对象是否为隔行扫描。
getOriginalOptions()	使用此直观方法，轻松根据原始文件设置检索选项。
getDefaultOptions(Object[] args)	使用此简洁方法轻松获取默认选项。
getModifyDate(boolean useDefault)	使用此用户友好方法，快速获取资源图像上次修改的日期和时间。
addPage(RasterImage page)	使用此直观方法，轻松向图像添加新页面。
addFrame()	/**
addFrame(RasterImage frameImage)	使用此直观方法，轻松在末尾添加新帧，从而扩展您的帧集合。
addFrame(RasterImage frameImage, long frameTime)	使用此直观方法，顺畅地通过追加新帧来扩展您的帧集合。
insertFrame(int index)	使用此直观方法，轻松在指定位置插入新帧到您的帧集合中。
insertFrame(int index, RasterImage frameImage)	在指定索引处向自身帧集合插入新帧。
insertFrame(int index, RasterImage frameImage, long frameTime)	在指定索引处向自身帧集合插入新帧。
popFrameAt(int index)	使用此直观方法，从您的帧集合中删除并获取指定索引处的帧。
removeFrameAt(int index)	使用此方法，顺畅地从您的帧集合中删除指定索引处的帧。
removeAllFrames()	使用此直观方法，通过删除所有帧来清空您的帧集合。
setDefaultImage(RasterImage image)	使用此方法，轻松将指定的光栅图像设置为当前动画的默认图像。
resetDefaultImage()	使用此直观方法，移除先前设置的默认图像。

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

import com.aspose.imaging;
import com.aspose.imaging.imageoptions;

try (Image image = Image.load("Animation1.webp"))
{
    // 默认导出为具有无限动画循环的 APNG 动画
    image.save("Animation1.webp.png", new ApngOptions());
    // 设置动画循环
    ApngOptions options = new ApngOptions();
    options.setNumPlays(5);
    image.save("Animation2.webp.png", options); // 5 cycles
}

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

import com.aspose.imaging;
import com.aspose.imaging.imageoptions;

try (Image image = Image.load("img4.tif"))
{
    // 设置默认帧持续时间
    ApngOptions options = new ApngOptions();
    options.setDefaultFrameTime(500);
    image.save("img4.tif.500ms.png", options); // 500 ms
    options.setDefaultFrameTime(250);
    image.save("img4.tif.250ms.png", options); // 250 ms
}

ApngImage(ApngOptions options, int width, int height)

public ApngImage(ApngOptions options, int width, int height)

通过轻松初始化新实例，开始使用 ApngImage 类。非常适合希望在项目中快速高效地使用 ApngImage 对象的开发者。

Parameters:

参数	类型	描述
options	ApngOptions	选项。
width	int	宽度。
height	int	高度。

getFileFormat()

public long getFileFormat()

使用此便捷属性，快速获取文件格式信息。非常适合需要轻松检索其 Apng 文件格式细节的开发者。

Returns: long

getPageCount()

public int getPageCount()

使用此属性，轻松获取图像文件的总页数。非常适合需要快速访问页数信息的开发者。

值：页面计数。

Returns: int

getPages()

public Image[] getPages()

使用此便捷属性，轻松访问图像的各页。非常适合希望快速轻松获取单页进行操作的开发者。

值：pages。

Returns: com.aspose.imaging.Image[]

getNumPlays()

public int getNumPlays()

使用此多功能属性，轻松控制动画循环次数。非常适合需要对动画行为进行精确控制的开发者，当值为 0 时支持无限循环。

值：循环次数。

Returns: int

setNumPlays(int value)

public void setNumPlays(int value)

使用此多功能属性，轻松控制动画循环次数。非常适合需要对动画行为进行精确控制的开发者，当值为 0 时支持无限循环。

值：循环次数。

Parameters:

参数	类型	描述
值	int

getDefaultFrameTime()

public long getDefaultFrameTime()

使用此灵活属性，轻松调整创建新帧的默认帧持续时间。非常适合希望在动画中高效自定义帧时序的开发者。

值：默认帧持续时间（毫秒）。

Returns: long

setDefaultFrameTime(long value)

public void setDefaultFrameTime(long value)

使用此灵活属性，轻松调整创建新帧的默认帧持续时间。非常适合希望在动画中高效自定义帧时序的开发者。

值：默认帧持续时间（毫秒）。

Parameters:

参数	类型	描述
值	long

getInterlaced()

public boolean getInterlaced()

使用此便捷属性，快速判断此 PngImage 对象是否为隔行扫描。非常适合需要轻松检查 PNG 图像隔行状态的开发者。

值：如果为隔行扫描则为 true；否则为 false。

Returns: boolean

getOriginalOptions()

public ImageOptionsBase getOriginalOptions()

使用此直观方法，轻松获取基于原始文件设置的选项。非常适合希望访问并利用与原文件特性保持一致的设置的开发者。这有助于保持原始图像的位深度和其他参数不变。例如，如果我们加载一张每像素 1 位的黑白 PNG 图像，然后使用 DataStreamSupporter.save(String) 方法保存，输出的 PNG 图像将是每像素 8 位。为避免这种情况并以每像素 1 位保存 PNG 图像，请使用此方法获取相应的保存选项，并将其作为第二个参数传递给 Image.save(String, ImageOptionsBase) 方法。

Returns: ImageOptionsBase - The options based on the original file settings.

getDefaultOptions(Object[] args)

public ImageOptionsBase getDefaultOptions(Object[] args)

使用此简洁方法，轻松获取默认选项。非常适合希望快速访问默认 Apng 图像设置的开发者。

Parameters:

参数	类型	描述
args	java.lang.Object[]	参数。

Returns: ImageOptionsBase - Default options

getModifyDate(boolean useDefault)

public Date getModifyDate(boolean useDefault)

使用此友好方法，快速获取资源图像的最后修改日期和时间。非常适合需要跟踪更改并有效管理资源的开发者。

Parameters:

参数	类型	描述
useDefault	boolean	如果设置为 true，则使用来自 FileInfo 的信息作为默认值。

Returns: java.util.Date - 资源图像上次修改的日期和时间。

addPage(RasterImage page)

public void addPage(RasterImage page)

使用此直观方法，轻松向图像添加新页。非常适合希望动态扩展图像文件内容的开发者。

Parameters:

参数	类型	描述
page	RasterImage	要添加的页面。

addFrame()

public ApngFrame addFrame()

/**

使用此简洁方法，轻松在帧集合末尾追加新帧。非常适合希望为多帧图像动画动态扩展帧集合的开发者。新帧将根据当前图像的尺寸创建。

Returns: ApngFrame - The newly created APNG frame.

addFrame(RasterImage frameImage)

public void addFrame(RasterImage frameImage)

使用此直观方法，轻松在末尾添加新帧以扩展您的帧集合。非常适合希望动态提升多帧图像动画的开发者。新帧的内容将从指定图像填充。

Parameters:

参数	类型	描述
frameImage	RasterImage	帧图像。

addFrame(RasterImage frameImage, long frameTime)

public void addFrame(RasterImage frameImage, long frameTime)

通过使用此直观方法将新帧追加到帧集合中，轻松扩展您的帧集合。适用于希望丰富多帧图像动画的开发者。新帧的内容将从指定图像填充。

Parameters:

参数	类型	描述
frameImage	RasterImage	帧图像。
frameTime	long	帧持续时间（毫秒）。

insertFrame(int index)

public ApngFrame insertFrame(int index)

通过此直观方法，轻松在指定位置将新帧插入到帧集合中。适用于希望在多帧图像动画中精确控制帧排列的开发者。新帧将根据当前图像的大小创建。

Parameters:

参数	类型	描述
索引	int	索引。

Returns: ApngFrame - The newly created APNG frame.

insertFrame(int index, RasterImage frameImage)

public void insertFrame(int index, RasterImage frameImage)

在指定索引处向自身帧集合插入新帧。新帧的内容将从指定图像填充。

Parameters:

参数	类型	描述
索引	int	索引。
frameImage	RasterImage	帧图像。

insertFrame(int index, RasterImage frameImage, long frameTime)

public void insertFrame(int index, RasterImage frameImage, long frameTime)

在指定索引处向自身帧集合插入新帧。新帧的内容将从指定图像填充。

Parameters:

参数	类型	描述
索引	int	索引。
frameImage	RasterImage	帧图像。
frameTime	long	帧持续时间（毫秒）。

popFrameAt(int index)

public ApngFrame popFrameAt(int index)

使用此直观方法从帧集合中移除并检索指定索引处的帧。非常适合寻求高效管理动画帧的开发者。

Parameters:

参数	类型	描述
索引	int	索引。

Returns: ApngFrame - The removed APNG frame.

removeFrameAt(int index)

public void removeFrameAt(int index)

使用此方法从帧集合中无缝移除指定索引处的帧。非常适合寻求简化多帧图像帧管理的开发者。待删除的帧将被释放。

Parameters:

参数	类型	描述
索引	int	索引。

removeAllFrames()

public void removeAllFrames()

使用此直观方法通过移除所有帧来清空帧集合。适用于希望重置或刷新动画的开发者。

setDefaultImage(RasterImage image)

public void setDefaultImage(RasterImage image)

使用此方法轻松将指定的光栅图像设置为当前动画的默认图像。非常适合希望自定义动画默认图像的开发者。

Parameters:

参数	类型	描述
image	RasterImage	图像。

resetDefaultImage()

public void resetDefaultImage()

使用此直观方法移除先前设置的默认图像。适用于希望在动画中重置或清除默认图像的开发者。此后，默认图像将是自身帧集合中的第一帧（无法通过此方法删除）。