裁剪、填充或缩放图像

您正在查看最新版本（V2.2.0）的文档。如果您想查阅其他版本的文档，可以点击页面右上角“切换版本”按钮进行切换。

■ 如果您不确定当前使用的产品是哪个版本，请随时联系梅卡曼德技术支持。

功能描述

该步骤可对输入图像进行裁剪、填充或缩放处理。

使用场景

该步骤为通用的图像处理步骤，无固定用法。

输入与输出

输入

输入端口 数据类型 说明

图像

Image

待处理的图像。

对齐参数组

Pose2D

根据目标物体的位姿变换，同步调整目标区域的位姿。

输出

输出端口 数据类型 说明

处理后的图像

Image / Image[]

经过裁剪、填充或缩放处理后生成的图像。执行填充或缩放时，输出为 Image；执行裁剪时，若勾选合并裁剪结果，输出为 Image，否则输出为 Image[]。

缩放参数

JsonValue

执行填充或缩放操作后输出的缩放相关信息，包含是否进行填充（is_padding）和缩放比例（scale_factor）。

其中，执行填充操作时，缩放比例为1；执行缩放操作时，缩放比例为“目标宽度与原图宽度的比例”和“目标高度与原图高度的比例”中较小的值。

ROI参数

Number[]

执行填充或缩放操作后输出的ROI相关参数信息，对应原图尺寸。

参数说明

参数 解释

操作类型

用于选择对输入图像执行的操作，包括裁剪、填充或缩放。

  • 裁剪：截取图像的指定区域。查看裁剪参数了解调参详情。

  • 填充：扩展图像边界。查看填充参数了解调参详情。

  • 缩放：调整图像整体尺寸。查看缩放参数了解调参详情。

裁剪参数

参数 解释

ROI设置

设置ROI确定图像的裁剪范围。步骤运行后，将仅保留ROI内的图像区域。未设置ROI时，表示不进行裁剪。

合并裁剪结果

勾选后，将保留各裁剪区域在原图中的相对位置，并将所有裁剪区域合并输出为一张图像。

未勾选时，每个裁剪区域单独输出为一张图像。

填充参数

参数 解释

目标宽度

该参数用于设置填充后输出图像的宽度（单位为像素）。

目标高度

该参数用于设置填充后输出图像的高度（单位为像素）。

填充颜色（R）

用于指定图像扩展区域的R通道填充值。若输入的是灰度图，仅R通道的数值生效，并作为填充的灰度值。

填充颜色（G）

用于指定图像扩展区域的G通道填充值。仅当输入为彩色图时才生效。

填充颜色（B）

用于指定图像扩展区域的B通道填充值。仅当输入为彩色图时才生效。

缩放参数

参数 解释

锁定宽高比

勾选后，图像的目标宽度与目标高度的比例将被锁定，修改一项时另一项自动按比例调整。

目标宽度

该参数用于指定缩放后图像最终的宽度值。

目标高度

该参数用于指定缩放后图像最终的高度值。

缩放后填充

勾选时（默认），图像的原始宽高比保留，图像会按设置的目标尺寸进行最大程度缩放，如有空白区域，空白区域使用黑色进行填充，图像不变形。

未勾选时，图像会被拉伸或压缩以适应目标尺寸，图像可能会变形。

错误排查

填充操作未生效

问题现象：

目标宽度或高度小于输入图像尺寸，填充操作未生效，输出图像尺寸与输入图像一致。

可能原因：

设置的目标宽度或高度小于或等于输入图像的实际尺寸，无法进行填充操作。

解决方案：

请检查并调整目标宽度和高度参数，确保其大于输入图像的尺寸后重新运行步骤。

该页面是否有帮助？

可以通过以下方式反馈意见：

我们重视您的隐私

我们使用 cookie 为您在我们的网站上提供最佳体验。继续使用该网站即表示您同意使用 cookie。如果您拒绝，将使用一个单独的 cookie 来确保您在访问本网站时不会被跟踪或记住。

  • Preference
  • 同意
  • 不同意