图像翻转

概述

图像翻转算法将输入图像的镜像版本写入输出图像。它支持沿水平轴、垂直轴和两个轴同时镜像。后者是一种有用且快速的 180 度图像旋转方法。

输入	VPI_FLIP_HORIZ
VPI_FLIP_VERT	VPI_FLIP_BOTH

实现

图像翻转的工作原理是根据用户的需求，跨 x 轴、y 轴或两个轴交换像素。

• VPI_FLIP_HORIZ - 水平翻转图像。
• VPI_FLIP_VERT - 垂直翻转图像。
• VPI_FLIP_BOTH - 水平和垂直翻转图像。

C API 函数

有关实现该算法的限制、约束和后端列表，请查阅以下函数的参考文档

函数	描述
vpiSubmitImageFlip	水平、垂直或同时翻转二维图像。

用法

语言 C/C++ Python

1. 导入 VPI 模块

   import vpi

2. 使用 CUDA 后端在输入图像上运行图像翻转。它使用翻转模式 BOTH。输入和输出都是 VPI 图像。

   with vpi.Backend.CUDA
   output = input.image_flip(vpi.Flip.BOTH)

1. 初始化阶段
   1. 包含定义图像翻转函数的头文件。

      #include <vpi/algo/ImageFlip.h>

   2. 定义输入图像。

          VPIImage input = /*...*/;

   3. 创建输出图像。它从输入图像获取其尺寸和格式。

      int32_t w, h;
          vpiImageGetSize(input, &w, &h);
       
          VPIImageFormat type;
          vpiImageGetFormat(input, &type);
       
          VPIImage output;
          vpiImageCreate(w, h, type, 0, &output);

   4. 创建将在其上提交算法以执行的流。

          VPIStream stream;
          vpiStreamCreate(0, &stream);

2. 处理阶段
   1. 使用 CPU 后端将算法连同所有参数提交到流。

          vpiSubmitImageFlip(stream, VPI_BACKEND_CPU, input, output, flipMode);

   2. 可选地，等待直到处理完成。

          vpiStreamSync(stream);

3. 清理阶段
   1. 释放流以及输入和输出图像所持有的资源。

          vpiStreamDestroy(stream);
          vpiImageDestroy(input);
          vpiImageDestroy(output);

有关更多信息，请参阅 VPI - 视觉编程接口 的“C API 参考”部分中的 图像翻转。

性能

有关如何使用下表性能表的信息，请参阅算法性能表。
在比较测量结果之前，请查阅比较算法运行时间。
有关性能基准测试方式的更多信息，请参阅性能基准。

清除过滤器 设备 Jetson AGX Orin  - 流 1 2 4 8