缩放 2D ROI 内的图像

功能描述

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

../../../../../_images/function_description4.png

使用场景

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

输入与输出

../../../../../_images/usage_scenario4.png

参数调节说明

彩色图 ROI 设置

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

ROIByFile

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

ROIByParam

Start X
默认值：0
调节说明：根据检测需求设定，不能大于图像最大 x 值。
Start Y
默认值：0
调节说明：根据检测需求设定，不能大于图像最大 y 值。
Width
默认值：0
调节说明：根据检测需求设定，不能大于图像最大宽度。
Height
默认值：0
调节说明：根据检测需求设定，不能大于图像最大高度。

参数调节说明

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

../../../../../_images/scale_param.png
更新彩色图ROI区域的方法
默认值: Origin
值列表：
Origin ：根据设置提取彩色图 ROI。
AdapativeModifiedRoiOriginP ：使用图像的边框调整彩色图 ROI。
BoundRect ：提取输入图像的边界矩形的区域。
调节说明：调节输入图像对应的区域。
Origin 是使用原图。
AdaptivemodifiedRoiOrigin 是自适应的调整图像非零点区域的中心到 ROI 中心。
BoundRect 是用图像非零点的外接矩形替换原图计算缩放比例。
当输入图片中要检测的物体位置不定且占整图面积比例小时要根据实际需求从后两种中选择。

彩色图 ROI 缩放设置

自动缩放
默认值：True
值列表：True，False
调节说明：设置为False时，可更改缩放系数（默认为 1 ）。如下图所示，左侧为默认状态下的输出图，右侧为更改自定义缩放系数为 0.5 的输出图。
../../../../../_images/scale_zoom.png

输出图像的理想长宽设置

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

填充图像至目标大小

填充
默认值：True
值列表：True，False
调节说明：该参数值为 True 时可将缺少区域填充成指定颜色。在一般情况下填充成黑色(0,0,0)或者灰色(128,128,128)
调节示例：如下图所示，左侧是填充值为 False 的结果，右侧是填充值为(0,255,0)的结果。
../../../../../_images/scale_filling.png
r
默认值：0
调节说明：填充 R 分量数值，取值范围 0~255。
g
默认值：0
调节说明：填充 G 分量数值，取值范围 0~255。
b
默认值：0
调节说明：填充 B 分量数值，取值范围 0~255。