複数のフレームを持つアニメーションを表す。Animation 構造体は、アニメーション形式 (例: GIF, AVIF, APNG, WebP) のような連続したアニメーションシーケンスのデータを保存・管理するために設計されている。ループ、背景色設定、フレームのタイミング、フレームの保存をサポートする。続きを見る...

#include <opencv2/imgcodecs.hpp>

Collaboration diagram for cv::Animation:

公開メンバ関数
	Animation (int loopCount=0, Scalar bgColor=Scalar())
	省略可能なループ回数と背景色を指定して Animation オブジェクトを構築する。

公開変数類
Scalar	bgcolor
	BGRA形式のアニメーションの背景色。

std::vector< int >	durations
	各フレームの表示時間 (ミリ秒)。

std::vector< Mat >	frames
	フレームのベクトル。各 Mat が単一のフレームを表す。

int	loop_count
	アニメーションをループさせる回数。0 は無限ループを意味する。

Mat	still_image
	アニメーションに加えて、またはリーダーがアニメーションをサポートしない場合に (PNGのように) その形式に使用できる画像。

詳細説明

複数のフレームを持つアニメーションを表す。Animation 構造体は、アニメーション形式（例: GIF, AVIF, APNG, WebP）のような連続したアニメーションのデータを格納・管理するために設計されている。ループ、背景色設定、フレームのタイミング、フレーム格納をサポートする。

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

構築子と解体子の詳解

◆ Animation()

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

省略可能なループ回数と背景色を指定して Animation オブジェクトを構築する。

引数

loopCount

アニメーションをループさせる回数を表す整数:

0 (デフォルト) は無限ループを示し、アニメーションが連続的に再生され続けることを意味する。
正の値は有限の繰り返し回数を表し、アニメーションを限られた回数だけ再生できるようにする。
負の値、または最大値 0xffff (65535) を超える値が指定された場合、有効な範囲を維持するために 0 (無限ループ) にリセットされる。

bgColor

BGR形式の背景色を表す Scalar オブジェクト:

デフォルトは Scalar() で、空の色を示す (サポートされている場合は通常は透明)。
この背景色は、透明部分を持つフレームの背後に単色の塗りつぶしを提供し、一貫した表示外観を保証する。

メンバ変数詳解

◆ bgcolor

Scalar cv::Animation::bgcolor

BGRA形式によるアニメーションの背景色。

◆ durations

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

各フレームの表示時間（ミリ秒単位）。

覚え書き

(GIF) Due to file format limitation

表示時間は10ミリ秒の倍数でなければならない。指定された値は最も近い10ミリ秒に切り下げられる（例: 88ms → 80ms）。
0ミリ秒（またはユーザーアプリケーションで想定されるより小さい値）の表示時間は未定義の動作を引き起こす可能性があり、例えばデフォルトの表示時間として扱われる。
65535 * 10 ミリ秒を超える表示時間はサポートされていない。

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

◆ frames

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

フレームのベクトル。各 Mat は1つのフレームを表す。

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

◆ loop_count

int cv::Animation::loop_count

アニメーションをループさせる回数。0は無限ループを意味する。

覚え書き

At some file format, when N is set, whether it is displayed N or N+1 times depends on the implementation of the user application. This loop times behaviour has not been documented clearly.

(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

Mat cv::Animation::still_image

アニメーションに加えてその形式で使用できる画像。または、リーダーがアニメーションをサポートしていない場合（PNGなど）に使用できる画像。

この構造体詳解は次のファイルから抽出されました:

opencv2/imgcodecs.hpp

公開メンバ関数

公開変数類