表示具有多个帧的动画。Animation 结构体旨在存储和管理动画序列的数据，例如来自动画格式（例如，GIF、AVIF、APNG、WebP）。它提供对循环、背景颜色设置、帧定时和帧存储的支持。更多...

#include <opencv2/imgcodecs.hpp>

cv::Animation 的协作图

公共成员函数
CV_WRAP	Animation (int loopCount=0, Scalar bgColor=Scalar())
	构造一个 Animation 对象，具有可选的循环计数和背景颜色。

公共属性
CV_PROP_RW Scalar	bgcolor
	动画的 BGRA 格式的背景颜色。

CV_PROP_RW std::vector< int >	durations
	每帧的持续时间（以毫秒为单位）。

CV_PROP_RW std::vector< Mat >	frames
	帧向量，其中每个 Mat 表示单个帧。

CV_PROP_RW int	loop_count
	动画应循环的次数。 0 表示无限循环。

CV_PROP_RW Mat	still_image
	除了动画之外，还可以用于该格式的图像，或者如果读取器不支持动画（例如 PNG 中）。

详细描述

表示具有多个帧的动画。Animation 结构体旨在存储和管理动画序列的数据，例如来自动画格式（例如，GIF、AVIF、APNG、WebP）。它提供对循环、背景颜色设置、帧定时和帧存储的支持。

示例: samples/cpp/tutorial_code/imgcodecs/animations.cpp.

构造函数 & 析构函数文档

◆ Animation()

CV_WRAP cv::Animation::Animation	(	int	loopCount = 0,
		Scalar	bgColor = Scalar() )

构造一个 Animation 对象，具有可选的循环计数和背景颜色。

参数

loopCount	一个整数，表示动画应循环的次数 `0` (默认) 表示无限循环，意味着动画将持续重播。正值表示有限的重复计数，允许动画播放有限的次数。如果提供负值或超出 `0xffff` (65535) 最大值的值，它将被重置为 `0` (无限循环) 以保持有效范围。
bgColor	一个 `Scalar` 对象，表示 BGR 格式的背景颜色默认为 `Scalar()`，表示空颜色（如果支持，通常是透明的）。此背景颜色为具有透明度的帧提供纯色填充，从而确保一致的显示外观。

成员数据文档

◆ bgcolor

CV_PROP_RW Scalar cv::Animation::bgcolor

动画的 BGRA 格式的背景颜色。

◆ durations

CV_PROP_RW std::vector<int> cv::Animation::durations

每帧的持续时间（以毫秒为单位）。

注意

(GIF) 由于文件格式限制

持续时间必须是 10 毫秒的倍数。任何提供的值都将向下舍入到最接近的 10 毫秒（例如，88 毫秒 → 80 毫秒）。
0 毫秒（或在用户应用程序中小于预期）的持续时间可能会导致未定义的行为，例如，它以默认持续时间处理。
不支持超过 65535 * 10 毫秒的持续时间。

示例: samples/cpp/tutorial_code/imgcodecs/animations.cpp.

◆ frames

CV_PROP_RW std::vector<Mat> cv::Animation::frames

帧向量，其中每个 Mat 表示单个帧。

示例: samples/cpp/tutorial_code/imgcodecs/animations.cpp.

◆ loop_count

CV_PROP_RW int cv::Animation::loop_count

动画应循环的次数。 0 表示无限循环。

注意

在某些文件格式中，设置 N 时，是显示 N 次还是 N+1 次取决于用户应用程序的实现。此循环时间行为尚未明确记录。

(GIF) 见 https://issues.chromium.org/issues/40459899 带循环的动画 GIF 使用 Netscape Application Block (NAB) 扩展，它不是 GIF89a 规范的一部分。见 https://en.wikipedia.org/wiki/GIF#Animated_GIF 。
(WebP) 见 https://issues.chromium.org/issues/41276895

◆ still_image

CV_PROP_RW Mat cv::Animation::still_image

除了动画之外，还可以用于该格式的图像，或者如果读取器不支持动画（例如 PNG 中）。

此结构体的文档是从以下文件生成的

opencv2/imgcodecs.hpp

公共成员函数

公共属性