拓冰网站定制 
简介这是一套面向VisionPro入门与进阶的配套资料包适合机器视觉初学者、工业自动化工程师以及需要将VisionPro与C#集成开发的读者。资源围绕工具使用、VSP脚本编程和C#混合编程三条主线按视频课程拆分出多课实例包含颜色匹配、圆形直径测量、卡尺工具原理、PMAlign定位、Blob分析、OCR字符读取、OCV验证、C#环境搭建与工业相机实时采集等主题。压缩包共92个文件以vpp工程、cs脚本、PDF中文说明、txt说明文档、bmp示例图像和demo程序为主整体约24.97MB目录按课时组织便于对照学习与调试复现。资料内附带中文算法说明、可运行的vpp示例和C#工程读者可直观看到检测工具的参数配置与流程搭建并将脚本方法迁移到实际项目中。目前已有2140人学习下载适合希望系统掌握视觉工具原理、脚本自动化及二次开发能力的实践者。 第一次打开VisionPro的时候整个人是懵的。界面上摆着一大堆工具什么CogPMAlignTool、CogBlobTool、CogFindLineTool和以前用OpenCV写视觉的思路完全不一样。很多从Halcon或者OpenCV转过来的工程师一开始都会有一个普遍误区把VisionPro当成一个图像处理工具箱打开QuickBuild后拖两个工具进去跑不出结果就开始怀疑自己或者怀疑软件有问题。实际上VisionPro最难的不是哪个工具怎么用而是搞清楚它的数据流组织方式以及工具和工具之间到底是怎么通过变量连起来的。这篇文章我打算从零开始把VisionPro的学习路线讲清楚怎么认识这个平台、怎么在QuickBuild里把核心工具跑起来、怎么用脚本处理更复杂的业务逻辑最后再落到C#上位机混合编程这条最终出路上。只要你跟着走一遍就会发现这套东西的套路其实非常固定。1. VisionPro是什么以及把它装进开发环境的正确姿势1.1 它不是一个软件而是一套视觉开发体系很多人第一次接触VisionPro是从QuickBuild开始的因此以为QuickBuild就是VisionPro。这个印象需要纠正一下。QuickBuild只是VisionPro自带的可视化开发环境新版里也常被叫作VisionPro Designer它的价值在于让你不用写一行代码就能搭出一个完整的视觉检测流程。但真正给C#上位机用的是安装目录下那一堆Cognex.VisionPro开头的DLL以及命名空间里的各种工具类。所以VisionPro实际上是开发库 快速验证环境的组合这和Halcon早期强调给我一个函数库我再给你个HDevelop的思路其实是同一套打法。理解了这层关系你后面学起来会顺畅很多。在QuickBuild里用鼠标拖出来的每一个工具在C#里都能找得到同名的类。你在QuickBuild里看到工具的输出引脚、输入引脚在C#里就对应类的Inputs和Outputs属性。所以QuickBuild真正的作用是让你在不需要写代码的情况下先把算法流程验证清楚然后再把同一套逻辑搬到C#工程里。这个思路贯穿整个学习过程先不要急着写代码先学会在图形界面里把工具用好。1.2 安装和License里的隐藏规则安装这一步看似简单却有不少人在这里浪费过时间。首先组件选择时不要图省事全默认。我的建议是至少勾上QuickBuild、VisionPro核心库、VisionPro Tools以及.NET SDK支持。如果你有相机还要根据相机厂商安装对应的采集SDK否则后续取图像的时候会发现找不到设备或者图像一直黑屏。Cognex自带的图像采集驱动比如针对GigE接口的驱动也要一并确认好网卡IP设置、巨型帧包大小这些都是相机连不上的常见原因。另一个容易踩的是授权问题。VisionPro分开发授权和运行时授权开发授权通常绑定加密狗或电脑用于本地开发调试现场部署的设备则需要安装对应的Runtime授权否则程序跑到一半就会弹错误。很多时候开发环境一切正常一部署到现场就出问题八成的原因是许可证类型不对或者没有把Runtime组件打进去。建议在项目初期就把Licensing形式确认好不然最后交付阶段会非常被动。安装完成后怎么确认环境正常最快的方法是打开QuickBuild新建一个Job随便取一张图片添加一个测量工具运行一次不报错就说明核心库和License都正常。如果这一步就报错多半是License环境变量没有生效重新运行License授权工具或用管理员身份打开QuickBuild即可。1.3 从QuickBuild到C#先建立工具-图像-结果的三元心智模型在深入工具使用之前先建立一个心智模型会非常有帮助。VisionPro里所有的视觉工具都可以抽象成三个部分接收一张图像、执行一种算法、输出一批结果。CogPMAlignTool接收图像输出匹配位置和角度CogBlobTool接收图像输出斑点的面积、质心等信息。图像是原料工具是加工工序结果是产品。后续你在ToolBlock里做连线本质上就是在安排工序和搬运产品。有了这个模型后面看任何工具都会很快遇到没见过的工具也不会慌先找它的输入是什么再看它的输出有哪些就能快速上手。这个模型同样适用于C#编程因为C#里的每个工具类就是输入属性 运行方法 输出集合的组合。2. QuickBuild里先跑通三个高频工具定位、斑点、找边2.1 CogPMAlignTool几乎每个项目都绕不开的定位工具CogPMAlignTool是VisionPro里使用率最高的工具做的是模板匹配定位。它解决的痛点很明确产品在视野里的位置每次都不一样后面的检测区域怎么跟随先做模板匹配得到当前图像中的位置和角度再把这个位置传给后续工具让检测区域也跟着移动。用它的基本流程添加CogPMAlignTool之后在训练区域里框出要当做模板的特征建议选边缘清晰、形状独特的区域点Training训练一次。运行前把Search Region调整成整幅图或者产品可能出现的范围再设定匹配数量、匹配置信度阈值等参数。跑出结果后最重要的输出是Score、TranslationX/Y和Rotation。如果Score低于设定阈值说明产品可能放歪了、遮挡了或者来料本身有变化。实际项目里我的经验是Score一般要求大于0.7才算稳定低于0.7就要考虑是不是需要重新训练或者换更稳定的特征。很多新手只会看Score忽略了一个关键参数Search Region的大小。它直接影响运行时间搜索范围越大越慢所以不要简单地把整个图像拉满应该尽量缩到产品实际可能出现的位置并留少量余量这样速度提升非常明显。在连续生产线上单个工具快个几十毫秒整个节拍就能快不少。2.2 CogBlobTool用像素统计解决有没有、在不在问题CogBlobTool叫斑点分析它做的事情很像用阈值把图像切开再统计每一块连通区域的面积、重心、外接矩形等。零件漏装、位置偏移过大、异物混入这类问题用Blob工具往往比深度学习模型更简单可靠因为它本质上是在做像素统计稳定性和可解释性都比黑盒模型好。用Blob工具时最核心的是设置好阈值方式。VisionPro提供了固定阈值、动态阈值等多种模式。对光照相对稳定的场景固定阈值最省事先取一张正常产品的图像检查灰度直方图后选择一个能把目标和背景分离开的值即可。对光照变化较大的场景优先选择动态阈值让工具根据局部灰度自动计算。运行结束后重点看每个Blob的Area、CenterX/CenterY再结合后续的上下限判断进行OK/NG。还有一个经验Blob工具对杂点非常敏感。如果图像上有细小的噪点被阈值切出来了可以先对输入图像做一次中值滤波或形态学开运算再去跑Blob结果会干净很多。这个预处理步骤很多新手会漏漏了之后结果忽好忽坏反过头来怀疑工具不稳定其实问题出在图像质量上。VisionPro里针对这个问题有专门的CogImageConvertTool之类的图像预处理工具使用时可以串联在Blob工具之前。2.3 CogFindLineTool精密测量从找边开始CogFindLineTool是找直线工具在需要测量宽度、间距、倾斜角时非常常用。它会在图像里一条指定的搜索区域内沿着某个方向查找边缘点再拟合成一条直线。注意它的输入不能直接给全图找线通常要先设定一个搜索区域比如一个矩形长条让工具在里面找边缘点。使用中最容易犯的错误是把搜索区域设得太大导致把旁边的真实边缘也拟合进来输出结果就会跳变。正确做法是搜索区域尽量覆盖目标边缘所在的范围宽度大约是边缘本身在图像中粗细的1.5到2倍。运行结果里最重要的输出是直线的起点、终点、角度以及边缘点的拟合质量。项目里经常会用两条找线工具测一个宽度再把两条线的距离输出出来做尺寸判断。2.4 标定工具像素坐标与物理坐标的桥梁如果检测结果需要以毫米为单位输出或者要引导机械臂抓取那就跳不过标定。VisionPro里我最常用的是CogCalibNPointToNPointTool也就是俗称的九点标定。原理很直接找九个已知物理坐标的点和它们在图像中的像素坐标工具自动计算出两者之间的映射关系。后续任何工具输出的像素坐标经过这个工具一转换就变成物理坐标。如果镜头畸变大或者要求更高精度先做一次畸变标定。工具箱里可以用CogCalibCheckerBoardTool拍棋盘格把畸变模型拟合出来再校正图像。实际项目中好的习惯是先畸变校正再做九点标定这两个工具串联在ToolBlock的最前面后续所有检测都基于校正后的图像进行。否则在视野边缘像素和毫米的换算误差会非常明显位置一偏就是几个毫米现场根本没法用。3. ToolBlock的编排逻辑让工具之间把数据传起来3.1 只有理解了DataFlow你才算真正入门在QuickBuild里ToolBlock就像一条小型流水线。工具是一个个工位数据是工位之间的物料。你的任务就是安排哪些工具先运行、哪些后运行以及每个工具的数据从哪里来。实际编排的时候你会在工具上看到输入/输出引脚。例如CogPMAlignTool的输出引脚有Result和一个可用于后续的Pose。CogBlobTool的输入引脚里则有InputImage、Region。当你把PMAlign输出引脚和Blob的某些输入引脚连起来以后就形成了数据传递。VisionPro在运行时会自动按照依赖关系决定工具的执行顺序前提是你把连线接对。这时候要特别注意一个常见误解不是把两个工具摆在一起就算完成了流程。很多新手在ToolBlock里添加了PMAlign和Blob发现运行Blob时并没有使用PMAlign的结果因为两个工具之间根本没有连线。这个概念一旦通了后面用脚本和C#编程就轻松得多因为C#里对应的CogToolBlock类同样有Inputs、Outputs、Tools集合和QuickBuild里看到的结构是一一对应的。3.2 一个先定位后测量的编排实例这里给出一个很经典的流程先定位再测量。假设要检测某个圆形区域是否偏位产品位置每张图都会变。第一步把相机图像输入到CogPMAlignTool中训练特征为产品基准角。第二步把PMAlign输出的转换结果和一个预设的基准图片区域传给CogBlobTool或CogToolBlock内部另一个工具使检测区域跟随产品位置移动。第三步用Blob工具分析区域内的圆斑面积。第四步把面积值输出到ToolBlock的Outputs供外部程序读取。在QuickBuild里这套流程的连线大概是这样图像源工具或者输入引脚连到PMAlign的输入图像PMAlign的输出连到用于计算旋转和平移的中间结果局部坐标跟随区域连到Blob的区域输入Blob输出面积连到ToolBlock的Outputs。最后再给ToolBlock添加一个输出引脚把OK/NG布尔值暴露出去上层程序只要读这个值就能判断产品是否合格。这一步不需要写代码但如果理不清连线后续写脚本一定会卡壳。3.3 调试连线时怎么看数据流在实际调试连线时QuickBuild提供了一个非常好用的功能在ToolBlock里右键工具选择编辑工具运行并查看当前工具的输入输出值。这样你就能看到PMAlign到底输出什么、Blob区域对应的是否正确。我的习惯是先暂停运行逐步单步执行工具看每一步的中间结果确认数据流没问题之后再全速跑。这一步排查效率极高比在代码里打断点看变量快得多。尤其是当你发现某个工具输出结果不对时一定要往上游找因为往往不是当前工具的问题而是它依赖的输入没接对。4. CogScriptTool脚本把控制逻辑写进视觉流程里4.1 什么情况需要脚本出马CogScriptTool是ToolBlock里的一个特殊工具它允许你在视觉流程里插入一段C#代码用来做工具组合做不了的事情。它适合的场景有几类一是多个工具结果需要做综合判断比如既要面积合格又要角度偏差在容忍范围内二是需要做较复杂的数学计算比如根据两个测量值计算某个比例三是需要和外部系统交互比如把结果格式化成字符串通过串口或TCP发送出去。不要一上来就写脚本先在ToolBlock里把常规工具排好只有当流程里有判断或转换逻辑时再加CogScriptTool。脚本工具用得好能省很多事用不好也会拖慢运行速度所以尽量保持脚本简洁不要在脚本里做图像处理图像处理交给专业工具脚本只做逻辑控制。4.2 脚本的常见写法与代码示例进入CogScriptTool的脚本编辑界面后你会看到一个默认的Script()方法。示例代码如下public void Script() { // 从ToolBlock中取出ByName的Blob工具 CogBlobTool blob (CogBlobTool)mToolBlock.Tools[CogBlob1]; blob.Run(); double maxArea 0; for (int i 0; i blob.Results.GetBlobs().Count; i) { double area blob.Results.GetBlobByIndex(i).Area; if (area maxArea) { maxArea area; } } if (maxArea 5000 maxArea 8000) { mToolBlock.Outputs[Result].Value OK; } else { mToolBlock.Outputs[Result].Value NG; } }这段代码做的事是先拿到Blob工具运行后找到面积最大的斑点然后根据面积是否在5000到8000之间输出OK或NG。核心是利用mToolBlock对象访问工具和输出。注意在脚本中修改Outputs后ToolBlock的输出引脚值会同步更新上层程序就能直接读取。脚本里常用的还有mToolBlock.Inputs[InputImage].Value来获取输入图像以及mToolBlock.RunTool(CogPMAlign1)来主动运行某个工具。要提醒的是脚本工具默认会先运行它依赖的工具所以如果你已经连线排好了顺序不一定需要手动调用RunTool尽量让脚本只做判断和输出会更清晰。4.3 脚本调试技巧不要在主流程里弹窗在CogScriptTool里调试时很多新手习惯用MessageBox.Show来弹窗但卡住的情况很常见因为视觉流程往往运行在后台线程弹窗会阻塞执行。更稳定的做法是尽量把调试信息输出到文本日志或者用System.Diagnostics.Debug.WriteLine写到调试输出窗口。如果只是临时想知道某个变量的值可以写入一个临时文件跑完后查看。另外脚本里访问工具对象时如果是在循环里反复取建议先把对象取出来放到局部变量避免频繁在Tools集合里按名称查找。这个看似微小的优化在连续采集和检测的产线上影响还挺明显的。脚本里还要注意变量本文还有配套的精品资源点击获取 VisionPro从入门到落地：QuickBuild工具编排与C#混合编程详解
简介这是一套面向VisionPro入门与进阶的配套资料包适合机器视觉初学者、工业自动化工程师以及需要将VisionPro与C#集成开发的读者。资源围绕工具使用、VSP脚本编程和C#混合编程三条主线按视频课程拆分出多课实例包含颜色匹配、圆形直径测量、卡尺工具原理、PMAlign定位、Blob分析、OCR字符读取、OCV验证、C#环境搭建与工业相机实时采集等主题。压缩包共92个文件以vpp工程、cs脚本、PDF中文说明、txt说明文档、bmp示例图像和demo程序为主整体约24.97MB目录按课时组织便于对照学习与调试复现。资料内附带中文算法说明、可运行的vpp示例和C#工程读者可直观看到检测工具的参数配置与流程搭建并将脚本方法迁移到实际项目中。目前已有2140人学习下载适合希望系统掌握视觉工具原理、脚本自动化及二次开发能力的实践者。 第一次打开VisionPro的时候整个人是懵的。界面上摆着一大堆工具什么CogPMAlignTool、CogBlobTool、CogFindLineTool和以前用OpenCV写视觉的思路完全不一样。很多从Halcon或者OpenCV转过来的工程师一开始都会有一个普遍误区把VisionPro当成一个图像处理工具箱打开QuickBuild后拖两个工具进去跑不出结果就开始怀疑自己或者怀疑软件有问题。实际上VisionPro最难的不是哪个工具怎么用而是搞清楚它的数据流组织方式以及工具和工具之间到底是怎么通过变量连起来的。这篇文章我打算从零开始把VisionPro的学习路线讲清楚怎么认识这个平台、怎么在QuickBuild里把核心工具跑起来、怎么用脚本处理更复杂的业务逻辑最后再落到C#上位机混合编程这条最终出路上。只要你跟着走一遍就会发现这套东西的套路其实非常固定。1. VisionPro是什么以及把它装进开发环境的正确姿势1.1 它不是一个软件而是一套视觉开发体系很多人第一次接触VisionPro是从QuickBuild开始的因此以为QuickBuild就是VisionPro。这个印象需要纠正一下。QuickBuild只是VisionPro自带的可视化开发环境新版里也常被叫作VisionPro Designer它的价值在于让你不用写一行代码就能搭出一个完整的视觉检测流程。但真正给C#上位机用的是安装目录下那一堆Cognex.VisionPro开头的DLL以及命名空间里的各种工具类。所以VisionPro实际上是开发库 快速验证环境的组合这和Halcon早期强调给我一个函数库我再给你个HDevelop的思路其实是同一套打法。理解了这层关系你后面学起来会顺畅很多。在QuickBuild里用鼠标拖出来的每一个工具在C#里都能找得到同名的类。你在QuickBuild里看到工具的输出引脚、输入引脚在C#里就对应类的Inputs和Outputs属性。所以QuickBuild真正的作用是让你在不需要写代码的情况下先把算法流程验证清楚然后再把同一套逻辑搬到C#工程里。这个思路贯穿整个学习过程先不要急着写代码先学会在图形界面里把工具用好。1.2 安装和License里的隐藏规则安装这一步看似简单却有不少人在这里浪费过时间。首先组件选择时不要图省事全默认。我的建议是至少勾上QuickBuild、VisionPro核心库、VisionPro Tools以及.NET SDK支持。如果你有相机还要根据相机厂商安装对应的采集SDK否则后续取图像的时候会发现找不到设备或者图像一直黑屏。Cognex自带的图像采集驱动比如针对GigE接口的驱动也要一并确认好网卡IP设置、巨型帧包大小这些都是相机连不上的常见原因。另一个容易踩的是授权问题。VisionPro分开发授权和运行时授权开发授权通常绑定加密狗或电脑用于本地开发调试现场部署的设备则需要安装对应的Runtime授权否则程序跑到一半就会弹错误。很多时候开发环境一切正常一部署到现场就出问题八成的原因是许可证类型不对或者没有把Runtime组件打进去。建议在项目初期就把Licensing形式确认好不然最后交付阶段会非常被动。安装完成后怎么确认环境正常最快的方法是打开QuickBuild新建一个Job随便取一张图片添加一个测量工具运行一次不报错就说明核心库和License都正常。如果这一步就报错多半是License环境变量没有生效重新运行License授权工具或用管理员身份打开QuickBuild即可。1.3 从QuickBuild到C#先建立工具-图像-结果的三元心智模型在深入工具使用之前先建立一个心智模型会非常有帮助。VisionPro里所有的视觉工具都可以抽象成三个部分接收一张图像、执行一种算法、输出一批结果。CogPMAlignTool接收图像输出匹配位置和角度CogBlobTool接收图像输出斑点的面积、质心等信息。图像是原料工具是加工工序结果是产品。后续你在ToolBlock里做连线本质上就是在安排工序和搬运产品。有了这个模型后面看任何工具都会很快遇到没见过的工具也不会慌先找它的输入是什么再看它的输出有哪些就能快速上手。这个模型同样适用于C#编程因为C#里的每个工具类就是输入属性 运行方法 输出集合的组合。2. QuickBuild里先跑通三个高频工具定位、斑点、找边2.1 CogPMAlignTool几乎每个项目都绕不开的定位工具CogPMAlignTool是VisionPro里使用率最高的工具做的是模板匹配定位。它解决的痛点很明确产品在视野里的位置每次都不一样后面的检测区域怎么跟随先做模板匹配得到当前图像中的位置和角度再把这个位置传给后续工具让检测区域也跟着移动。用它的基本流程添加CogPMAlignTool之后在训练区域里框出要当做模板的特征建议选边缘清晰、形状独特的区域点Training训练一次。运行前把Search Region调整成整幅图或者产品可能出现的范围再设定匹配数量、匹配置信度阈值等参数。跑出结果后最重要的输出是Score、TranslationX/Y和Rotation。如果Score低于设定阈值说明产品可能放歪了、遮挡了或者来料本身有变化。实际项目里我的经验是Score一般要求大于0.7才算稳定低于0.7就要考虑是不是需要重新训练或者换更稳定的特征。很多新手只会看Score忽略了一个关键参数Search Region的大小。它直接影响运行时间搜索范围越大越慢所以不要简单地把整个图像拉满应该尽量缩到产品实际可能出现的位置并留少量余量这样速度提升非常明显。在连续生产线上单个工具快个几十毫秒整个节拍就能快不少。2.2 CogBlobTool用像素统计解决有没有、在不在问题CogBlobTool叫斑点分析它做的事情很像用阈值把图像切开再统计每一块连通区域的面积、重心、外接矩形等。零件漏装、位置偏移过大、异物混入这类问题用Blob工具往往比深度学习模型更简单可靠因为它本质上是在做像素统计稳定性和可解释性都比黑盒模型好。用Blob工具时最核心的是设置好阈值方式。VisionPro提供了固定阈值、动态阈值等多种模式。对光照相对稳定的场景固定阈值最省事先取一张正常产品的图像检查灰度直方图后选择一个能把目标和背景分离开的值即可。对光照变化较大的场景优先选择动态阈值让工具根据局部灰度自动计算。运行结束后重点看每个Blob的Area、CenterX/CenterY再结合后续的上下限判断进行OK/NG。还有一个经验Blob工具对杂点非常敏感。如果图像上有细小的噪点被阈值切出来了可以先对输入图像做一次中值滤波或形态学开运算再去跑Blob结果会干净很多。这个预处理步骤很多新手会漏漏了之后结果忽好忽坏反过头来怀疑工具不稳定其实问题出在图像质量上。VisionPro里针对这个问题有专门的CogImageConvertTool之类的图像预处理工具使用时可以串联在Blob工具之前。2.3 CogFindLineTool精密测量从找边开始CogFindLineTool是找直线工具在需要测量宽度、间距、倾斜角时非常常用。它会在图像里一条指定的搜索区域内沿着某个方向查找边缘点再拟合成一条直线。注意它的输入不能直接给全图找线通常要先设定一个搜索区域比如一个矩形长条让工具在里面找边缘点。使用中最容易犯的错误是把搜索区域设得太大导致把旁边的真实边缘也拟合进来输出结果就会跳变。正确做法是搜索区域尽量覆盖目标边缘所在的范围宽度大约是边缘本身在图像中粗细的1.5到2倍。运行结果里最重要的输出是直线的起点、终点、角度以及边缘点的拟合质量。项目里经常会用两条找线工具测一个宽度再把两条线的距离输出出来做尺寸判断。2.4 标定工具像素坐标与物理坐标的桥梁如果检测结果需要以毫米为单位输出或者要引导机械臂抓取那就跳不过标定。VisionPro里我最常用的是CogCalibNPointToNPointTool也就是俗称的九点标定。原理很直接找九个已知物理坐标的点和它们在图像中的像素坐标工具自动计算出两者之间的映射关系。后续任何工具输出的像素坐标经过这个工具一转换就变成物理坐标。如果镜头畸变大或者要求更高精度先做一次畸变标定。工具箱里可以用CogCalibCheckerBoardTool拍棋盘格把畸变模型拟合出来再校正图像。实际项目中好的习惯是先畸变校正再做九点标定这两个工具串联在ToolBlock的最前面后续所有检测都基于校正后的图像进行。否则在视野边缘像素和毫米的换算误差会非常明显位置一偏就是几个毫米现场根本没法用。3. ToolBlock的编排逻辑让工具之间把数据传起来3.1 只有理解了DataFlow你才算真正入门在QuickBuild里ToolBlock就像一条小型流水线。工具是一个个工位数据是工位之间的物料。你的任务就是安排哪些工具先运行、哪些后运行以及每个工具的数据从哪里来。实际编排的时候你会在工具上看到输入/输出引脚。例如CogPMAlignTool的输出引脚有Result和一个可用于后续的Pose。CogBlobTool的输入引脚里则有InputImage、Region。当你把PMAlign输出引脚和Blob的某些输入引脚连起来以后就形成了数据传递。VisionPro在运行时会自动按照依赖关系决定工具的执行顺序前提是你把连线接对。这时候要特别注意一个常见误解不是把两个工具摆在一起就算完成了流程。很多新手在ToolBlock里添加了PMAlign和Blob发现运行Blob时并没有使用PMAlign的结果因为两个工具之间根本没有连线。这个概念一旦通了后面用脚本和C#编程就轻松得多因为C#里对应的CogToolBlock类同样有Inputs、Outputs、Tools集合和QuickBuild里看到的结构是一一对应的。3.2 一个先定位后测量的编排实例这里给出一个很经典的流程先定位再测量。假设要检测某个圆形区域是否偏位产品位置每张图都会变。第一步把相机图像输入到CogPMAlignTool中训练特征为产品基准角。第二步把PMAlign输出的转换结果和一个预设的基准图片区域传给CogBlobTool或CogToolBlock内部另一个工具使检测区域跟随产品位置移动。第三步用Blob工具分析区域内的圆斑面积。第四步把面积值输出到ToolBlock的Outputs供外部程序读取。在QuickBuild里这套流程的连线大概是这样图像源工具或者输入引脚连到PMAlign的输入图像PMAlign的输出连到用于计算旋转和平移的中间结果局部坐标跟随区域连到Blob的区域输入Blob输出面积连到ToolBlock的Outputs。最后再给ToolBlock添加一个输出引脚把OK/NG布尔值暴露出去上层程序只要读这个值就能判断产品是否合格。这一步不需要写代码但如果理不清连线后续写脚本一定会卡壳。3.3 调试连线时怎么看数据流在实际调试连线时QuickBuild提供了一个非常好用的功能在ToolBlock里右键工具选择编辑工具运行并查看当前工具的输入输出值。这样你就能看到PMAlign到底输出什么、Blob区域对应的是否正确。我的习惯是先暂停运行逐步单步执行工具看每一步的中间结果确认数据流没问题之后再全速跑。这一步排查效率极高比在代码里打断点看变量快得多。尤其是当你发现某个工具输出结果不对时一定要往上游找因为往往不是当前工具的问题而是它依赖的输入没接对。4. CogScriptTool脚本把控制逻辑写进视觉流程里4.1 什么情况需要脚本出马CogScriptTool是ToolBlock里的一个特殊工具它允许你在视觉流程里插入一段C#代码用来做工具组合做不了的事情。它适合的场景有几类一是多个工具结果需要做综合判断比如既要面积合格又要角度偏差在容忍范围内二是需要做较复杂的数学计算比如根据两个测量值计算某个比例三是需要和外部系统交互比如把结果格式化成字符串通过串口或TCP发送出去。不要一上来就写脚本先在ToolBlock里把常规工具排好只有当流程里有判断或转换逻辑时再加CogScriptTool。脚本工具用得好能省很多事用不好也会拖慢运行速度所以尽量保持脚本简洁不要在脚本里做图像处理图像处理交给专业工具脚本只做逻辑控制。4.2 脚本的常见写法与代码示例进入CogScriptTool的脚本编辑界面后你会看到一个默认的Script()方法。示例代码如下public void Script() { // 从ToolBlock中取出ByName的Blob工具 CogBlobTool blob (CogBlobTool)mToolBlock.Tools[CogBlob1]; blob.Run(); double maxArea 0; for (int i 0; i blob.Results.GetBlobs().Count; i) { double area blob.Results.GetBlobByIndex(i).Area; if (area maxArea) { maxArea area; } } if (maxArea 5000 maxArea 8000) { mToolBlock.Outputs[Result].Value OK; } else { mToolBlock.Outputs[Result].Value NG; } }这段代码做的事是先拿到Blob工具运行后找到面积最大的斑点然后根据面积是否在5000到8000之间输出OK或NG。核心是利用mToolBlock对象访问工具和输出。注意在脚本中修改Outputs后ToolBlock的输出引脚值会同步更新上层程序就能直接读取。脚本里常用的还有mToolBlock.Inputs[InputImage].Value来获取输入图像以及mToolBlock.RunTool(CogPMAlign1)来主动运行某个工具。要提醒的是脚本工具默认会先运行它依赖的工具所以如果你已经连线排好了顺序不一定需要手动调用RunTool尽量让脚本只做判断和输出会更清晰。4.3 脚本调试技巧不要在主流程里弹窗在CogScriptTool里调试时很多新手习惯用MessageBox.Show来弹窗但卡住的情况很常见因为视觉流程往往运行在后台线程弹窗会阻塞执行。更稳定的做法是尽量把调试信息输出到文本日志或者用System.Diagnostics.Debug.WriteLine写到调试输出窗口。如果只是临时想知道某个变量的值可以写入一个临时文件跑完后查看。另外脚本里访问工具对象时如果是在循环里反复取建议先把对象取出来放到局部变量避免频繁在Tools集合里按名称查找。这个看似微小的优化在连续采集和检测的产线上影响还挺明显的。脚本里还要注意变量本文还有配套的精品资源点击获取