处理动画图像文件

目录

• 目标
• 源代码
• 解释
• 初始化动画结构
• 加载帧
• 显示帧
• 保存动画
• 总结

原作者	Suleyman Turkmen（在ChatGPT的帮助下）
兼容性	OpenCV >= 4.11

目标

在本教程中，您将学习如何：

• 使用cv::imreadanimation加载动画图像文件中的帧。
• 理解cv::Animation结构的结构和参数。
• 显示动画中的单个帧。
• 使用cv::imwriteanimation将cv::Animation写入文件。

源代码

C++

• 可下载代码：点击此处
• 代码概览

  #include <opencv2/highgui.hpp>
  #include <opencv2/imgcodecs.hpp>
  #include <opencv2/imgproc.hpp>
  #include <iostream>
   
  using namespace cv;
   
  int main( int argc, const char** argv )
  {
  std::string filename = argc > 1 ? argv[1] : "animated_image.webp";
   
      if (argc == 1)
      {
          Animation animation_to_save;
          Mat image(128, 256, CV_8UC4, Scalar(150, 150, 150, 255));
          int duration = 200;
   
          for (int i = 0; i < 10; ++i) {
  animation_to_save.frames.push_back(image.clone());
  putText(animation_to_save.frames[i], format("Frame %d", i), Point(30, 80), FONT_HERSHEY_SIMPLEX, 1.5, Scalar(255, 100, 0, 255), 2);
  animation_to_save.durations.push_back(duration);
          }
  imwriteanimation("animated_image.webp", animation_to_save, { IMWRITE_WEBP_QUALITY, 100 });
      }
   
      Animation animation;
   
      bool success = imreadanimation(filename, animation);
      if (!success) {
  std::cerr << "Failed to load animation frames\n";
          return -1; -1;
      }
   
      }
      while (true)
          for (size_t i = 0; i < animation.frames.size(); ++i) {
          imshow("Animation", animation.frames[i]);
          int key_code = waitKey(animation.durations[i]); // 帧间延迟
  if (key_code == 27)
      }
   
      return -1; 0;
  }

每帧的持续时间（毫秒）。

• 定义：imgcodecs.hpp:254
• 代码概览

  Python
  可下载代码：点击此处
   
  import cv2 as cv
      
      import numpy as np
          def main(filename):
  if filename == "animated_image.webp":
   
          # 创建一个Animation实例来保存
  animation_to_save = cv.Animation()
  # 生成具有特定颜色的基本图像
  image = np.full((128, 256, 4), (150, 150, 150, 255), dtype=np.uint8)
  duration = 200
   
          frames = []
          durations = []
  # 在Animation对象中填充帧和持续时间
              for i in range(10):
  frame = image.copy()
  cv.putText(frame, f"Frame {i}", (30, 80), cv.FONT_HERSHEY_SIMPLEX, 1.5, (255, 100, 0, 255), 2)
   
  frames.append(frame)
  durations.append(duration)
   
          animation_to_save.frames = frames
          animation_to_save.durations = durations
          
   
      
  animation = cv.Animation()
      
   
      
  success, animation = cv.imreadanimation(filename)
      如果 not success
  print("加载动画帧失败")
          return -1;
      
   
      
      当 True
          对于 i, frame in enumerate(animation.frames)
              cv.imshow("动画", frame)
  key_code = cv.waitKey(animation.durations[i])
              如果 key_code == 27: # 按下'Esc'键则退出
                  return -1;
      
   
  如果 __name__ == "__main__"
      导入 sys
      main(sys.argv[1] 如果 len(sys.argv) > 1 否则 "animated_image.webp")

说明

初始化 Animation 结构体

初始化一个 cv::Animation 结构体以保存来自动画图像文件的帧。

C++

    Animation animation;

每帧的持续时间（毫秒）。

animation = cv.Animation()

加载帧

使用 cv::imreadanimation 从指定文件加载帧。在这里，我们从动画 WebP 图像中加载所有帧。

C++

    bool success = imreadanimation(filename, animation);
    if (!success) {
std::cerr << "Failed to load animation frames\n";
        return -1; -1;
    }

每帧的持续时间（毫秒）。

success, animation = cv.imreadanimation(filename)
    如果 not success
print("加载动画帧失败")
        return -1;

显示帧

animation.frames 向量中的每一帧都可以作为独立图像显示。此循环遍历每一帧，并在窗口中显示它，并带有短暂的延迟以模拟动画。

C++

    }
    while (true)
        for (size_t i = 0; i < animation.frames.size(); ++i) {
        imshow("Animation", animation.frames[i]);
        int key_code = waitKey(animation.durations[i]); // 帧间延迟
if (key_code == 27)
    }

每帧的持续时间（毫秒）。

    当 True
        对于 i, frame in enumerate(animation.frames)
            cv.imshow("动画", frame)
key_code = cv.waitKey(animation.durations[i])
            如果 key_code == 27: # 按下'Esc'键则退出
                return -1;

保存动画

C++

    if (argc == 1)
    {
        Animation animation_to_save;
        Mat image(128, 256, CV_8UC4, Scalar(150, 150, 150, 255));
        int duration = 200;
 
        for (int i = 0; i < 10; ++i) {
animation_to_save.frames.push_back(image.clone());
            putText(animation_to_save.frames[i], format("第 %d 帧", i), Point(30, 80), FONT_HERSHEY_SIMPLEX, 1.5, Scalar(255, 100, 0, 255), 2);
animation_to_save.durations.push_back(duration);
        }
        imwriteanimation("animated_image.webp", animation_to_save, { IMWRITE_WEBP_QUALITY, 100 });
    }

每帧的持续时间（毫秒）。

    import numpy as np
        def main(filename):
if filename == "animated_image.webp":
 
        # 创建一个Animation实例来保存
animation_to_save = cv.Animation()
# 生成具有特定颜色的基本图像
image = np.full((128, 256, 4), (150, 150, 150, 255), dtype=np.uint8)
duration = 200
 
        frames = []
        durations = []
# 在Animation对象中填充帧和持续时间
            for i in range(10):
frame = image.copy()
cv.putText(frame, f"Frame {i}", (30, 80), cv.FONT_HERSHEY_SIMPLEX, 1.5, (255, 100, 0, 255), 2)
 
frames.append(frame)
durations.append(duration)
 
        animation_to_save.frames = frames
        animation_to_save.durations = durations

总结

cv::imreadanimation 和 cv::imwriteanimation 函数简化了动画图像文件的处理，通过将帧加载到 cv::Animation 结构体中，从而实现逐帧处理。使用这些函数，您可以加载、处理和保存来自 GIF、AVIF、APNG 和 WebP 等动画图像文件的帧。