COGNEX-VisionPro-CopyRegionTool

Carl Lu2025-09-142025-09-14

CopyRegionTool

在一张或两张图像上执行复制操作，主要包括以下三类功能：

拖动工具到toolblock

工具参数依次是输入图像、目标图像、输出图像

参数选项卡

区域内：

参数	说明
拷贝图像	从输入图像的输入区域中获取像素以复制到输出图像。
填充固定值	根据您使用的输入区域以及输入图像的格式，使用恒定灰度或颜色值填充输出图像。
如果您使用的是灰度图像，请指定灰度值。
如果您使用的是彩色图像，请指定 RedPlaneValue、GreenPlaneValue 和 BluePlaneValue 的值，它们对应于 RGB 图像中红色、绿色和蓝色的单独平面，或 HSI 图像中的色调、饱和度和强度。

区域外：

参数	描述
不写入像素	如果您不使用目标图像，则此选项将使用未初始化的值填充区域之外但在封闭边界框内的像素。但是，如果您正在使用目标图像，则此选项允许区域之外的像素保留底层目标图像的值。
填充固定值	根据您使用的输入区域以及输入图像的格式，使用恒定的灰度或颜色值填充区域之外但在边界框内的像素。
如果您使用的是灰度图像，请指定灰度值。
如果您使用彩色图像，请指定红色通道值、绿色通道值和蓝色通道值，它们对应于 RGB 图像中红色、绿色和蓝色的单独平面，或 HSI 图像中的色调、饱和度和强度。

区域选项卡

| 原点中心

3点	当选择区域类型为矩形或旋转矩形时可用。选择用于定义矩形的参数集。

参数	说明
原点
中心
3点	当选择区域类型为矩形或旋转矩形时可用。选择用于定义矩形的参数集。
原点X
原点Y	矩形区域的中心点位置坐标。
边长X
边长Y	矩形区域的长宽。
旋转	矩形旋转的角度。
倾斜	矩形倾斜的角度。

图形选项卡

选项	描述
显示输出图像	您可以选择为 LastRun.OutputImage 生成图像记录。
显示目标区域	您可以根据输入区域和对齐设置，在 LastRun.OutputImage 中启用表示工具覆盖的图像区域的图形。
显示输入图像	确定是否将输入图像记录为诊断记录的一部分，以及是否将图像复制到记录中或作为参考保存在记录中。
显示源区域	为 LastRun.InputImage 启用表示输入区域的图形。
显示图像配对点	为 LastRun.InputImage 和 LastRun.OutputImage 的输入区域和目标图像上方的对齐点启用图形。

默认情况下，该工具使用矩形区域，并为您提供一个图形来更改输入图像中区域的位置和大小。如有必要，可以选择对区域使用其他形状，如圆、椭圆、多边形等。如下图是有效区域形状(Vaild region shapes)：

配对选项卡

复制区域工具使您能够复制输入图像的一个输入区域，并将其粘贴到某个目标图像的内容中。默认情况下，输入图像和目标图像在每个图像的左上角对齐，即当前坐标空间中的图像坐标 (0,0)。这种对齐方式会将输入区域放置在目标图像中与输入图像相同的位置。

使用复制区域编辑控件的对齐选项卡来指定两个图像之间的不同对齐方式。例如，如果您为输入图像指定坐标 (25, 25)，并将目标图像上的对齐点保持在 (0, 0)，工具会将输入图像在点 (25, 25) 与目标图像中的点 (0, 0) 对齐。这会导致输入区域相对于其在输入图像中的位置在目标图像中偏移。

如果工具未提供目标图像，则此选项卡中的设置无效。

参数	描述
使用图像配对	启用输入图像与目标图像的特定对齐。默认情况下，该工具将图像与每个图像的坐标 (0, 0) 对齐。
输入图像配对	使用 X 和 Y 字段指定要用于对齐图像的输入图像中的点。
单击“适合输入图像”按钮将对齐点移动到输入图像的中心。
目标图像配对	使用 X 和 Y 字段指定要用于对齐图像的目标图像中的点。
单击“适合目标图像”按钮将对齐点移动到目标图像的中心。