缩放2D ROI内的图像

功能描述

将图像的感兴趣区域缩放至指定尺寸。

使用场景

用于深度学习相关步骤的图像预处理阶段，通常会与深度学习相关步骤、 还原缩放后ROI内的图像 连用。

输入与输出

参数

彩色图ROI设置

默认值：ROIByFile

值列表：ROIByFile（通过文件读取彩色图ROI），ROIByParam（通过参数设置彩色图ROI）

ROIByFile

彩色图ROI文件

调节说明：点击 进入 设置目标区域 窗口，使用参数仿真时创建并连接虚拟相机，在选择完需要加载的图像数据后 图像显示 栏出现被选图像，此时可以在图像上框选感兴趣区域，如 图2所示。 若为实际应用场景，连接真实相机采集图像后框选感兴趣区域。

图2 设置目标区域

ROIByParam

Start X

默认值：0

调节说明：根据检测需求设定，不能大于图像最大x值。

Start Y

默认值：0

调节说明：根据检测需求设定，不能大于图像最大y值。

Width

默认值：0

调节说明：根据检测需求设定，不能大于图像最大宽度。

Height

默认值：0

调节说明：根据检测需求设定，不能大于图像最大高度。

参数调节说明

如图3所示，1为 Start X ，2为 Start Y，用以确定ROI区域的左上角；3为 Width ，4为 Heigth ，用来确定ROI区域。

图3 用参数设置ROI区域示例

更新彩色图ROI区域的方法

默认值: Origin

值列表：

Origin ：根据设置提取彩色图ROI。

AdapativeModifiedRoiOriginP ：使用图像的边框调整彩色图ROI。

BoundRect ：提取输入图像的边界矩形的区域。

调节说明：调节输入图像对应的区域。

Origin 是使用原图。

AdaptivemodifiedRoiOrigin 是自适应的调整图像非零点区域的中心到ROI中心。

BoundRect 是用图像非零点的外接矩形替换原图计算缩放比例。

当输入图片中要检测的物体位置不定且占整图面积比例小时要根据实际需求从后两种中选择。

彩色图ROI缩放设置

自动缩放

默认值：True

值列表：True，False

调节说明：设置为False时，可更改缩放系数（默认为 1 )。如 图4所示，左侧为默认状态下的输出图，右侧为更改自定义缩放系数为 0.5 的输出图。

调节示例：在 自定义缩放系数计算示例 中，详细描述了自行计算缩放比例的步骤。

图4 更改缩放系数

输出图像的理想长宽设置

与输入彩色图ROI长宽相同（不缩放）

默认值：False

值列表：True，False

调节说明：更改为True时，即代表不缩放。使用默认值时可修改横向长度（默认为 1024 pixel）与纵向宽度（默认为 1024 pixel），可按时实际工程需求设置。图5中，左侧图像为默认状态下的输出图，右侧为长度更改为512 pixel，纵向宽度为1024 pixel的输出图。

图5 修改图像大小

填充图像至目标大小

填充

默认值：True

值列表：True，False

调节说明：该参数值为 True 时可将缺少区域填充成指定颜色。在一般情况下填充成黑色(0,0,0)或者灰色(128,128,128)

调节示例：如 图6所示，左侧是填充值为 False 的结果，右侧是填充值为(0,255,0)的结果。

图6 图像填充对比

r

默认值：0

调节说明：填充R分量数值，取值范围 0~255。

g

默认值：0

调节说明：填充G分量数值，取值范围 0~255。

b

默认值：0

调节说明：填充B分量数值，取值范围 0~255。

常用步骤组合

实例分割组合