VisionPro CogTool 工具解析75 个视觉工具一次搞懂前言VisionPro 是康耐视Cognex推出的工业机器视觉开发平台广泛应用于定位、测量、检测、识别等场景。其核心是一套名为CogTool的工具库——每个工具封装了一种独立的视觉算法开发者通过组合不同工具来完成复杂的视觉任务。理解 CogTool 的分类与各自用途是掌握 VisionPro 的第一步。本文将 75 个工具按9 大类别整理每个工具附上官方图标和功能说明方便查阅和对照学习。一、基础工具无分类这 12 个工具是 VisionPro 中最基础、最常用的工具涵盖图像采集、模板匹配、结果分析和工具组合等核心能力。图标工具名称功能说明CogAcqFifoTool从相机获取图像是整个视觉流程的入口CogBlobTool斑点找寻工具用于检测连通区域孔洞、颗粒等CogCaliberTool卡尺工具用于找单边或边缘对是测量的基础CogCNLSearchTool在图像中找寻像素值的训练模板归一化相关性CogDataAnalysisTool数据分析工具对输入数据做统计处理CogImageFileTool将图像保存至文件或从文件中加载图像CogPatInspectTool比较输入图像与训练模板的特征生成高差异图缺陷检测常用CogPMAlignTool模板匹配工具支持旋转和缩放用于定位CogResultsAnalysisTool结果分析工具对多个工具的输出做综合判断CogSearchMaxTool模板搜寻工具高性能的灰度匹配CogToolBlock将多个工具组合成一个功能块接口简单且可重用CogToolGroup将多个工具组合成一个逻辑集合便于管理使用要点实际项目中CogAcqFifoTool负责取像CogPMAlignTool负责定位CogBlobTool/CogCaliberTool负责检测和测量最后用CogToolBlock打包——这是最经典的 VisionPro 工作流。二、标定与定位Calibration Fixturing标定工具用于建立像素坐标与实际物理坐标的映射关系定位工具则将算法坐标空间对齐到图像内容空间是实现高精度测量的前提。图标工具名称功能说明CogCalibCheckerboardTool棋盘格校正工具使返回的值更具实际物理意义CogCalibNPointToNPointToolN点标定工具通过已知点对建立坐标映射CogFixtureNPointToNPointTool将程序坐标空间定位至图像内容空间N点方式CogFixtureTool定位工具基于特征点建立工件坐标系使用要点涉及尺寸测量的项目必须先做标定。棋盘格标定适合整幅图像的非线性校正N点标定适合现场快速建立线性映射。CogFixtureTool则用于在定位后将后续工具吸附到工件上保证工件移动时检测区域跟随。三、颜色工具Color颜色工具处理彩色图像可用于颜色提取、颜色匹配和颜色分割适用于有色工件的检测场景。图标工具名称功能说明CogColorExtractorTool从彩色图像中抽取像素来创建灰度图像颜色空间转换CogColorMatchTool检查某一块区域的色彩是否符合预期CogColorSegmenterTool从彩色图像中按颜色分离像素颜色分割CogCompositeColorMatch从彩色图像中检查颜色容量支持多区域颜色综合判断使用要点颜色检测对光照非常敏感实际使用时建议配合稳定的光源和白平衡。CogColorSegmenterTool常用于按颜色分离不同部件CogColorMatchTool则用于判断产品颜色是否合格。四、几何创建Geometry - Creation几何创建工具根据已知条件生成新的几何元素点、线、圆、椭圆、线段常用于构建辅助参考。图标工具名称功能说明CogCreateCircleTool创建圆CogCreateEllipseTool创建椭圆CogCreateLineBisectPointsTool创建两点的平分线CogCreateLineParallelTool在某一点创建某条线的平行线CogCreateLinePerpendicularTool在某一点创建某条线的垂线CogCreateLineTool根据指定点和角度创建一条直线CogCreateSegmentAvgSegsTool创建两条线段的平均线CogCreateSegmentTool创建线段使用要点这类工具本身不做图像检测而是基于已有几何结果做构造。例如找到两条边后用CogCreateLineBisectPointsTool求中心线再基于中心线做对称测量。五、几何查找与拟合Geometry - Finding Fitting查找工具直接从图像中提取几何特征拟合工具则根据一组点数据拟合出最佳几何形状。图标工具名称功能说明CogFindCircleTool找圆工具从图像中直接检测圆CogFindLineTool找线工具从图像中直接检测直线CogFitCircleTool拟合圆根据点集拟合最佳圆CogFitEllipseTool拟合椭圆根据点集拟合最佳椭圆CogFitLineTool拟合直线根据点集拟合最佳直线使用要点Find系列工具自带边缘提取适合直接在图像上操作Fit系列工具需要先有一组点通常来自卡尺工具的输出适合需要精确拟合的场景。实际项目中卡尺采点 FitLine/FitCircle是高精度测量的标准组合。六、几何相交Geometry - Intersection相交工具计算两个几何元素之间的交点是构建复杂测量关系的基础。图标工具名称功能说明CogIntersectCircleCircleTool检测两圆是否相交求交点CogIntersectLineCircleTool检测线与圆是否相交求交点CogIntersectLineEllipseTool检测线与椭圆是否相交求交点CogIntersectLineLineTool检测线与线是否相交求交点CogIntersectSegmentCircleTool检测线段与圆是否相交求交点CogIntersectSegmentEllipseTool检测线段与椭圆是否相交求交点CogIntersectSegmentLineTool检测线段与直线是否相交求交点CogIntersectSegmentSegmentTool检测线段与线段是否相交求交点使用要点求两条线的交点CogIntersectLineLineTool是最常用的操作例如求工件的角点位置。线段Segment与直线Line的区别在于线段有端点限制交点必须落在线段范围内才有效。七、几何测量Geometry - Measurement测量工具计算几何元素之间的距离和角度是 VisionPro 中完成尺寸检测的核心工具。图标工具名称功能说明CogAngleLineLineTool计算两条直线的夹角CogAnglePointPointTool计算由两点组成的线段的角度CogDistanceCircleCircleTool计算两圆的最短距离CogDistanceLineCircleTool计算线到圆的最短距离CogDistanceLineEllipseTool计算线到椭圆的最短距离CogDistancePointCircleTool计算点到圆的最短距离CogDistancePointEllipseTool计算点到椭圆的最短距离CogDistancePointLineTool计算点到直线的最短距离CogDistancePointPointTool计算点到点的距离CogDistancePointSegmentTool计算点到线段的最短距离CogDistanceSegmentCircleTool计算线段到圆的最短距离CogDistanceSegmentEllipseTool计算线段到椭圆的最短距离CogDistanceSegmentLineTool计算线段到线的最短距离CogDistanceSegmentSegmentTool计算线段到线段的最短距离使用要点这 14 个工具覆盖了点、线、圆、椭圆、线段之间所有组合的距离和角度计算。最常用的是CogDistancePointPointTool两点距离、CogDistancePointLineTool点到线距离和CogAngleLineLineTool线线夹角。测量前务必先做标定否则结果是像素单位而非物理单位。八、识别与验证ID Verification这类工具用于条码、二维码、字符的读取和验证是工业追溯和OCR场景的核心。图标工具名称功能说明Cog2DSymbolTool二维解码工具读取 DataMatrix、QR Code 等Cog2DSymbolVerifyTool二维解码验证工具判断码的质量等级CogBarcodeTool一维条码定位并解码工具CogOCVMaxTool确定字符串是否包含预期的字符光学字符验证CogOCVTool确定字符串、logo等是否存在于图像中CogPDF417Tool用于解码 PDF417 符号堆叠式二维码使用要点工业场景中 DataMatrix 码最为常见用Cog2DSymbolTool读取。条码读取对打码质量和光照要求较高建议配合专用光源。OCV光学字符验证用于检测印刷字符是否正确区别于 OCR识别字符内容。九、图像处理Image Processing图像处理工具提供图像的预处理和变换能力通常放在检测流程的前端用于提升图像质量或提取感兴趣区域。图标工具名称功能说明CogAffineTransformTool通过仿射变换产生新的图像旋转、平移、缩放CogCopyRegionTool复制输入图像的一部分到输出图像ROI 裁剪CogHistogramTool对图像中的像素值进行统计测量灰度直方图CogImageAverageTool积累同一场景的多张图像并产生平均图像降噪CogImageConvertTool将图像从一种格式转换为另一种格式如彩色转灰度CogImageSharpnessTool用来判断图像的锐利度对焦检测CogIPOneImageTool执行基本图像处理操作单幅图像的滤波、形态学等CogIPTwoImageAddTool由两个输入图像相加产生一个输出图像CogIPTwoImageMinMaxTool结合两个图像的像素最小值或最大值CogIPTwoImageSubtractTool两幅图像相减得到输出图像差分检测CogLinescanDistortionCorrectionTool从线扫相机获得图像并校正畸变CogPixelMapTool定义输入图像与输出图像之间的像素映射CogPolarUnwrapTool将环形图像展开为矩形极坐标展开常用于圆形工件检测CogSobelEdgeTool用于分离或增强边界信息Sobel 边缘提取使用要点图像处理工具是检测前的准备工作。常用组合CogImageConvertTool转灰度 →CogIPOneImageTool做平滑/增强 →CogCopyRegionTool裁剪 ROI → 后续检测工具。CogPolarUnwrapTool是圆形/环形工件检测的利器将圆环展开成矩形后再做直线检测大大简化算法。总结VisionPro 的 75 个 CogTool 看似繁多但按功能分类后逻辑非常清晰基础工具负责取像、定位、检测的主干流程标定与定位解决坐标映射问题颜色 / 识别处理专项检测需求几何工具创建、查找、相交、测量构成完整的尺寸测量体系图像处理提供前端预处理能力。本文整理自 VisionPro 官方工具库图标取自软件界面截图仅供学习参考。