VisionPro工具的说明

一、通用工具（General）

1. CogAcqFifoTool

功能：从相机采集图像

主要用来连接相机，获取实时图像，是视觉检测中比较常用的图像输入工具。

2. CogBlobTool

功能：斑点检测

通过设置灰度、面积等条件，找出图像中的目标区域，比如检测零件数量、面积、缺陷等。

3. CogCaliperTool

功能：卡尺测量

主要用于寻找边缘，可以找单边，也可以找两个边缘，然后计算距离、宽度等尺寸。

4. CogCNLSearchTool

功能：搜索灰度特征

根据训练得到的特征，在图像中搜索相似的目标。

5. CogDataAnalysisTool

功能：数据分析

对视觉检测得到的数据进行统计和分析。

6. CogImageFileTool

功能：图像文件读写

可以把图像保存到文件，也可以从文件中读取图像。调试程序时经常用它来代替相机采图。

7. CogPatInspectTool

功能：图像特征比对

将输入图像与训练好的模板进行比较，把不同的位置突出显示出来，适合做外观缺陷检测。

8. CogPMAlignTool

功能：模板匹配

通过训练模板，在图像中寻找目标的位置、角度等信息。

9. CogResultsAnalysisTool

功能：结果分析

对工具运行产生的结果进行分析和判断。

10. CogSearchMaxTool

功能：搜索图像中的最佳匹配位置

用于搜索符合条件的目标，得到匹配结果。

11. CogToolBlock

功能：组合多个工具

可以把多个 VisionPro 工具放到一起，组成一个完整的小功能，并且可以设置输入和输出接口。

12. CogToolGroup

功能：工具分组

把多个工具放在一个组里面，方便管理和组织视觉程序。

二、标定与定位（Calibration & Fixturing）

1. CogCalibCheckerboardTool

功能：棋盘格标定

通过棋盘格进行相机标定，可以修正镜头畸变，并建立像素坐标和实际物理尺寸之间的关系。

2. CogCalibNPointToNPointTool

功能：多点标定

通过多个对应点建立坐标之间的转换关系。

3. CogFixtureNPointToNPointTool

功能：坐标转换

将程序坐标和图像中的实际位置建立对应关系，方便后面的工具跟随产品移动。

4. CogFixtureTool

功能：建立固定坐标系

根据定位结果建立一个坐标系，让后面的检测区域可以跟着产品一起移动。

三、颜色工具（Color）

1. CogColorExtractorTool

功能：颜色提取

从彩色图像中提取指定颜色信息，并生成对应的灰度图像。

2. CogColorMatchTool

功能：颜色匹配

用于判断某个区域的颜色是否符合要求，比如检测红色、蓝色、绿色等。

3. CogColorSegmenterTool

功能：颜色分割

根据颜色信息，把图像中的不同颜色区域分离出来。

4. CogCompositeColorMatchTool

功能：复合颜色匹配

用于对多个颜色特征进行综合匹配，判断目标颜色是否符合要求。

四、几何图形创建（Geometry – Creation）

这一类工具主要不是“找东西”，而是根据已知条件创建几何图形。

1. CogCreateCircleTool

功能：创建圆

根据指定条件创建一个圆。

2. CogCreateEllipseTool

功能：创建椭圆

创建一个指定位置和大小的椭圆。

3. CogCreateLineBisectPointsTool

功能：创建两点的平分线

根据两个点创建对应的平分线。

4. CogCreateLineParallelTool

功能：创建平行线

根据已有直线，在指定位置创建一条平行线。

5. CogCreateLinePerpendicularTool

功能：创建垂线

根据已有直线，在指定位置创建垂直线。

6. CogCreateLineTool

功能：创建直线

根据点、角度等条件创建一条直线。

7. CogCreateSegmentAvgSegsTool

功能：创建平均线段

根据多个线段计算并创建平均线段。

8. CogCreateSegmentTool

功能：创建线段

根据指定条件创建线段。

五、几何图形查找与拟合（Geometry – Finding & Fitting）

这一类工具主要用来从图像或者已有数据中找到、拟合圆、线、椭圆等几何图形。

1. CogFindCircleTool

功能：找圆

在图像中寻找圆形边缘，得到圆的位置、半径等信息。

2. CogFindLineTool

功能：找线

在图像中寻找直线边缘。

3. CogFitCircleTool

功能：拟合圆

根据多个点拟合出一个圆，提高测量结果的稳定性。

4. CogFitEllipseTool

功能：拟合椭圆

根据多个点拟合出一个椭圆。

5. CogFitLineTool

功能：拟合直线

根据多个点拟合出一条直线。

六、几何图形求交（Geometry – Intersection）

这一类工具主要解决一个问题：两个几何图形有没有交点，交点在哪里。

1. CogIntersectCircleCircleTool

功能：求两个圆的交点

计算两个圆之间是否存在交点。

2. CogIntersectLineCircleTool

功能：求直线与圆的交点

计算直线和圆的交点。

3. CogIntersectLineEllipseTool

功能：求直线与椭圆的交点

计算直线和椭圆之间的交点。

4. CogIntersectLineLineTool

功能：求两条直线的交点

计算两条直线相交的位置。

5. CogIntersectSegmentCircleTool

功能：求线段与圆的交点

判断线段和圆是否相交。

6. CogIntersectSegmentEllipseTool

功能：求线段与椭圆的交点

判断线段和椭圆是否相交。

7. CogIntersectSegmentLineTool

功能：求线段与直线的交点

计算线段和直线是否相交。

8. CogIntersectSegmentSegmentTool

功能：求两条线段的交点

判断两条线段是否相交，并计算交点。

七、几何测量（Geometry – Measurement）

这一类工具在实际项目中非常常见，主要用来测量距离、角度等尺寸。

1. CogAngleLineLineTool

功能：测量两条直线的夹角

2. CogAnglePointPointTool

功能：测量两点组成的线段角度

3. CogDistanceCircleCircleTool

功能：测量两个圆之间的距离

4. CogDistanceLineCircleTool

功能：测量直线到圆的距离

5. CogDistanceLineEllipseTool

功能：测量直线到椭圆的距离

6. CogDistancePointCircleTool

功能：测量点到圆的距离

7. CogDistancePointEllipseTool

功能：测量点到椭圆的距离

8. CogDistancePointLineTool

功能：测量点到直线的距离

9. CogDistancePointPointTool

功能：测量两点之间的距离

10. CogDistancePointSegmentTool

功能：测量点到线段的距离

11. CogDistanceSegmentCircleTool

功能：测量线段到圆的距离

12. CogDistanceSegmentEllipseTool

功能：测量线段到椭圆的距离

13. CogDistanceSegmentLineTool

功能：测量线段到直线的距离

14. CogDistanceSegmentSegmentTool

功能：测量两条线段之间的距离

八、ID识别与验证（ID & Verification）

这一类工具主要用于二维码、条码、字符等识别和验证。

1. Cog2DSymbolTool

功能：二维代码识别

用于读取 Data Matrix、QR Code 等二维代码。

2. Cog2DSymbolVerifyTool

功能：二维代码质量验证

主要用于验证二维代码是否符合要求。

3. CogBarcodeTool

功能：条码定位与解码

用于寻找和读取一维条码。

4. CogOCVMaxTool

功能：字符验证

判断图像中的字符是否与预期字符一致。

5. CogOCVTool

功能：字符/图案验证

用于判断字符串、Logo等目标是否存在，以及是否符合要求。

6. CogPDF417Tool

功能：PDF417条码识别

用于读取 PDF417 类型的二维条码。

九、图像处理（Image Processing）

这一类工具主要负责对图像进行处理，比如增强、转换、相减、统计等。

1. CogAffineTransformTool

功能：仿射变换

对图像进行平移、旋转、缩放等变换。

2. CogCopyRegionTool

功能：复制图像区域

从原图中复制指定区域。

3. CogHistogramTool

功能：直方图统计

统计图像中不同灰度值的像素数量，可以用来分析图像亮度和对比度。

4. CogImageAverageTool

功能：图像平均

对同一场景的多张图像进行平均，可以降低部分随机噪声。

5. CogImageConvertTool

功能：图像格式转换

将图像从一种格式转换成另一种格式。

6. CogImageSharpnessTool

功能：图像清晰度检测

用于判断图像是否清晰，可以辅助判断相机对焦是否合适。

7. CogIPOneImageTool

功能：单图像处理

对一张图像进行各种基本图像处理，比如灰度、滤波、增强等。

8. CogIPTwoImageAddTool

功能：图像相加

将两张图像进行像素相加，得到一张新的图像。

9. CogIPTwoImageMinMaxTool

功能：图像最小值/最大值处理

对两张图像对应位置的像素进行比较，选择较小值或者较大值。

10. CogIPTwoImageSubtractTool

功能：图像相减

将两张图像进行像素相减，可以用来突出两张图像之间的差异。

11. CogLinescanDistortionCorrectionTool

功能：线扫图像畸变校正

主要用于线扫相机图像的畸变校正。

12. CogPixelMapTool

功能：像素映射

按照设定的映射关系，对输入图像的像素进行重新映射。

13. CogPolarUnwrapTool

功能：极坐标展开

将圆形、环形区域展开成平面图像，方便检测圆柱面、圆环等目标。

总结：

实际工作中最常用的基本就是这几类：

采图 → 图像处理 → 定位 → 找边/找圆 → 测量 → 匹配 → Blob → 字符/二维码 → 结果判断

例如检测一个键帽，可以先用 CogAcqFifoTool 获取图像，再使用 CogFixtureTool 定位产品，然后用 CogCaliperTool 测量尺寸，用 CogPMAlignTool 做定位或模板匹配，最后通过 ToolBlock 把整个检测流程组合起来。

所以学习 VisionPro 最重要的不是死记工具名称，而是看到一个检测需求后，能够知道：这个问题应该用哪个工具解决？