處理動畫影像檔案

目錄

• 目標
• 原始碼
• 解釋
• 初始化動畫結構
• 載入幀
• 顯示幀
• 儲存動畫
• 總結

原始作者	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;
      }
   
      while (true)
      for (size_t i = 0; i < animation.frames.size(); ++i) {
          imshow("Animation", animation.frames[i]);
          int key_code = waitKey(animation.durations[i]); // Delay between frames
          if (key_code == 27)
  exit(0);
      }
   
      return 0;
  }

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
   
          # 將動畫寫入檔案
          cv.imwriteanimation(filename, animation_to_save, [cv.IMWRITE_WEBP_QUALITY, 100])
          
   
      
  animation = cv.Animation()
      
   
      
  success, animation = cv.imreadanimation(filename)
      if not success
  print("Failed to load animation frames")
          return
      
   
      
      while True
          for i, frame in enumerate(animation.frames)
              cv.imshow("Animation", frame)
  key_code = cv.waitKey(animation.durations[i])
              if key_code == 27: # 如果按下“Esc”鍵則退出
                  return
      
   
  if __name__ == "__main__"
      import sys
      main(sys.argv[1] if len(sys.argv) > 1 else "animated_image.webp")

解釋

初始化動畫結構

初始化一個 cv::Animation 結構來儲存來自動畫影像檔案的幀。

C++

    Animation animation;

Python

animation = cv.Animation()

載入幀

使用 cv::imreadanimation 從指定檔案載入幀。 在這裡，我們從動畫 WebP 影像載入所有幀。

C++

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

Python

success, animation = cv.imreadanimation(filename)
    if not success
print("Failed to load animation frames")
        return

顯示幀

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]); // Delay between frames
        if (key_code == 27)
exit(0);
    }

Python

    while True
        for i, frame in enumerate(animation.frames)
            cv.imshow("Animation", frame)
key_code = cv.waitKey(animation.durations[i])
            if key_code == 27: # 如果按下“Esc”鍵則退出
                return

儲存動畫

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("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 });
    }

Python

    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.imwriteanimation(filename, animation_to_save, [cv.IMWRITE_WEBP_QUALITY, 100])

總結

cv::imreadanimation 和 cv::imwriteanimation 函式使處理動畫影像檔案變得容易，方法是將幀載入到 cv::Animation 結構中，從而允許逐幀處理。 使用這些函式，您可以從動畫影像檔案（如 GIF、AVIF、APNG 和 WebP）載入、處理和儲存幀。