初识VisionPro应用开发

文章目录

  • 一、引言
  • 二、VisionPro应用开发指南
    • 1. 上手指南
      • 1.1. VisionPro开发概述
      • 1.2. 高级开发功能
    • 2. 选择应用开发路径(方式)
      • 2.1. 路径1:用QuickBuild和应用程序向导生成的操作接口进行交互式开发
      • 2.2. 路径2:用QuickBuild和自定义的应用程序向导操作接口进行交互式开发
      • 2.3. 路径3:交互式开发加自定义操作接口
      • 2.4. 路径4:使用原生VisionPro .NET编程接口的自定义应用程序
    • ⭐3. 创建一个视觉应用程序:QuickBuild
      • 3.1. 你要做什么
      • 3.2. 开始使用QuickBuild
      • 3.3. 建立图像源
        • 3.3.1. 打开图像数据库
        • 3.3.2. 运行作业
      • 3.4. 配置PMAlignTool
        • 3.4.1. 添加PatMax Align工具到作业
        • 3.4.2. 创建模式
        • 3.4.3. 试用经过训练的模式
        • 3.4.4. 调运行参数
        • 3.4.5. 运行整个作业
      • 3.5. 分析结果
        • 3.5.1. 将新终端暴露给PMAlign工具
        • 3.5.2. 向作业添加结果分析工具
        • 3.5.3. 配置结果分析工具
        • 3.5.4. 将新终端连接到结果分析工具
        • 3.5.5. 试用一下分析工具
        • 3.5.6. 变更作业
      • 3.6. 跟踪结果
        • 3.6.1. 配置程序以保存拒绝的结果
        • 3.6.2. 配置已发送项列表
        • 3.6.3. 运行程序并测试结果
    • 4. 使用应用程序向导来创建一个视觉应用
      • 4.1. 从QuickBuild应用程序创建可执行程序
      • 4.2. 在结果分析器中创建输入
      • 4.3. 打开应用程序向导
      • 4.4. 创建UI
      • 4.4. 生成并运行应用程序

一、引言

项目用到图像识别,下个VisionPro先熟悉一下。


二、VisionPro应用开发指南

1. 上手指南

VisionPro可以快速构建功能强大且可随时部署的视觉应用程序。VisionPro还提供了功能齐全的工具包,可以使用微软的VS进行编程。

1.1. VisionPro开发概述

VisionPro提供了一个交互式的开发环境,你可以用它来组装工具、配置采集图像和离散的I/O,以及部署带有全功能操作界面的健壮且高性能的应用程序。

开发环境的关键组件如下:

  • QuickBuild(快速构建工具),它是一个交互式的应用程序构建器,该构建器允许你定义一个job(作业),该作业包含图像源、分析采集图像所需的图像处理和视觉工具,以及决定每个检查结果的结果分析逻辑。

    一个QuickBuild应用程序可以由多个生产环境的作业组成,在这些环境中可以多个摄像机同步或异步地拍摄要检查的对象图像。你可以以手动、按条件触发或自动操作的方式运行这些作业。

  • Communications Explorer(通讯管理器),提供了对康耐视离散I/O硬件的点击式浏览器访问。你可以将作业的特定数据项和结果集与单个输出行连接。你也可以配置系统级输出,例如作业就绪信号和系统心跳。

  • Application Wizard(应用程序向导),使用该组件,你可以快速生成一个完整的应用程序,包括操作界面,它封装了使用快速构建工具和通讯管理器创建的作业、采集和离散I/O配置。向导生成的应用程序包含一个可执行的Windows程序,完全注释的VB.NET或C#源代码以及作业和离散I/O配置数据。

下图概述了VisionPro开发:
初识VisionPro应用开发_第1张图片

所以VisionPro开发,先用快速构建工具将组件&图像串联起来,然后用应用程序向导打包。

1.2. 高级开发功能

除了使用应用程序向导来打包VisionPro应用程序进行部署外,还可以围绕配置的作业编写自定义程序,或者你可以使用C#或VB .NET直接使用底层VisionPro组件创建整个应用程序:

  • VisionPro Tools(VisionPro工具):VisionPro内的离散功能区域,例如摄像头的图像获取,封装在VisionPro工具中。每个VisionPro工具都使用低级别的VisionPro对象的不同组合来提供其特定功能,但同时每个VisionPro工具都提供了统一的工具接口(interface)。这种统一的接口使构建用于管理VisionPro工具集的高级环境成为可能。
  • VisionPro objects(VisionPro对象):这些构建块对象实现了VisionPro的基本功能:从相机、图像采集卡、文件或其他设备获取图像;在程序窗口显示图像;以及执行图像处理和图像分析。
  • User-Written Tools(用户编写的工具):你可以轻松编写自己的工具来实现定制功能,并将它和康耐视提供的工具一起包含在应用程序中。VisionPro公开了实现统一工具接口的所有信息。
  • Tool Edit Controls(工具编辑控件):所有VisionPro工具都配有相关的工具编辑控件。工具编辑控件提供了图形界面,允许用户查看和更改工具(以及底层对象)的所有属性。

2. 选择应用开发路径(方式)

VisionPro支持四种独立的开发方式,供你创建部署的VisionPro机器视觉应用程序:

  • 快速构建工具 + 向导生成的操作接口
    初识VisionPro应用开发_第2张图片

  • 快速构建工具 + 修改的操作接口
    初识VisionPro应用开发_第3张图片

  • 快速构建工具 + 自定义操作接口
    初识VisionPro应用开发_第4张图片

  • 自定义应用程序
    初识VisionPro应用开发_第5张图片

2.1. 路径1:用QuickBuild和应用程序向导生成的操作接口进行交互式开发

开发可部署VisionPro应用程序的最简单的方法是使用QuickBuild来交互式配置图像采集、图像处理和分析以及I/O,然后使用应用程序向导生成嵌入QuickBuild应用程序并可提供可配置操作接口的可部署VB.NET或C#程序。
初识VisionPro应用开发_第6张图片

优势:

  • 无需编程。
  • 快捷。
  • 能持续用QuickBuild来修改视觉图像、作业和I/O。

局限性:

  • 操作接口受应用程序向导的限制。

2.2. 路径2:用QuickBuild和自定义的应用程序向导操作接口进行交互式开发

因为应用程序向导生成了VB.NET或C#应用程序,且包含源码,所以你可以轻松地使用VS查看和修改生成的应用程序。这使得你可以轻松地定制应用程序外观,并添加其他系统组件的控件和显示值。
初识VisionPro应用开发_第7张图片
优势:

  • 轻松定制生成的应用程序
  • 仍可使用QuickBuild来修改底层的视觉应用程序

局限性:

  • 需要一定编程
  • 必须在向导生成的框架内工作
  • 无法重新运行向导来更新修改或向导生成的代码而不丢失你的修改

2.3. 路径3:交互式开发加自定义操作接口

VisionPro .NET编程接口包含了一些函数,这些函数可用于加载和操作保存的QuickBuild应用程序(实际上,向导生成的应用程序使用了这些函数)。你可以轻松编写自己的VS应用程序来加载和控制保存的QuickBuild应用程序,来代替使用向导生成的代码。
初识VisionPro应用开发_第8张图片
优势:

  • 完全自定义操作界面的外观和行为
  • 仍能使用QuickBuild来修改底层视觉应用程序

局限性:

  • 需要编程

2.4. 路径4:使用原生VisionPro .NET编程接口的自定义应用程序

VisionPro .NET编程接口使你可以直接控制图像采集、处理以及分析。
初识VisionPro应用开发_第9张图片
优势:

  • 整个程序都非常灵活

局限性:

  • 需要大量编程

⭐3. 创建一个视觉应用程序:QuickBuild

QuickBuild应用程序是VisionPro软件包的一部分,提供了一个交互式环境,可以快速创建一个视觉应用程序。本节介绍视觉工具的第一步,构建一个可执行的视觉应用程序。

3.1. 你要做什么

用VisionPro构建一个视觉应用有三步:

  1. 使用QuickBuild来开发和完善你的视觉应用程序。
    初识VisionPro应用开发_第10张图片
  2. 应用程序向导创建用户界面,并生成可执行应用程序。
  3. 测试并部署可执行程序。

3.2. 开始使用QuickBuild

VisionPro安装工具会在你Windows桌面上安装一个QuickBuild图标。
在这里插入图片描述
双击图标即可启动QuickBuildQuickBuild的初始窗口如下:
初识VisionPro应用开发_第11张图片

3.3. 建立图像源

开发视觉应用程序的第一步通常都是建立一个图像源,它可以是连接到康耐视帧捕获器的相机(一般是一些拍照、摄像的设备)。对于许多应用,可以从图像数据库开始(数据库中包含在生产环境中采集到的图像),然后修改应用程序以适应来自连接相机的图像,这非常方便。

前期不必直接连摄像机,可以从一些预先准备好的的图片开始,测试视觉程序。熟悉之后,可以把图片源改为相机。

3.3.1. 打开图像数据库

本例中,你将使用一个默认安装在 \Program Files\Cognex\VisionPro\Images\coins.idb中的硬币图像数据库(正确安装VisionPro后,安装目录下自带的)。

  1. 双击QuickBuild窗口中的 Image Source(图像源) 节点。
    初识VisionPro应用开发_第12张图片
    QuickBuild会打开一个QuickBuild作业编辑器对话框,你可以在里面添加和配置所需的视觉工具,以及一个 Image Source(图像源) 对话框:
    初识VisionPro应用开发_第13张图片
  2. 默认情况下,Image Source被配置为从图像数据库获取图像。
  3. 点击选择文件来选择一个图像数据库文件。
    本例中,选中 \Program Files\Cognex\VisionPro\Images目录下的 coins.idb
  4. 点击对话框左上角的实时显示按钮:
    初识VisionPro应用开发_第14张图片
    确认后会打开实时显示窗口,以循环浏览图像数据库文件中所有的硬币图像。
    初识VisionPro应用开发_第15张图片
  5. 关闭实时显示窗口和图像源对话框。

3.3.2. 运行作业

此时,作业仅包含配置图像源,但你可以运行作业以查看图像在QuickBuild作业编辑器中的显示方式。

  1. 点击工具栏中的运行按钮。

    ❗注意
    可能会出现下图所示无法运行的情况,这是因为你的VisionPro未激活(这边给个临时激活的教程链接,临时激活教程链接)。
    在这里插入图片描述

    正常运行后,效果如下:
    初识VisionPro应用开发_第16张图片

  2. 图像数据库文件中获取的图像会显示在显示区中。

  3. 当运行工具时,工具旁边的小绿点表示它成功运行。

  4. 当所有工具都成功运行时,作业编辑器左下角会出现一个绿点。

  5. 一直单击运行按钮,直到图像区域看到一个黑色圆圈。
    初识VisionPro应用开发_第17张图片
    下一步中,将添加一个PMAlign工具并配置它以查找每个图像中的硬币。

3.4. 配置PMAlignTool

本例使用 CogPMAlign(看起来像是Cognex Pattern Match Align的缩写) 工具在图像中查找圆形(硬币)。PMAlign工具使用康耐视PatMax软件来定位图像中的图案(本文不谈理论细节,只介绍工具使用,详细的理论知识请参阅PatMax软件理论相关资料)。

Pattern Match,[计]模式匹配。
当然Pattern也有图案的意思,所以在下文中理解成图像匹配也没有问题,即在模板图像中寻找匹配的目标物体。

3.4.1. 添加PatMax Align工具到作业

第一步就是添加一个CogPMAlign工具到QuickBuild项目中。

  1. 单击工具箱按钮。
    初识VisionPro应用开发_第18张图片

  2. 工具箱出现时,选中 CogPMAlignTool 并将其拖入作业编辑器中。

  3. 一个新的CogPMAlign工具就出现在了图像源的下方。
    初识VisionPro应用开发_第19张图片

  4. 图像源OutputImage(输出图像) 上单击,并将其拖入 CogPMAlign 工具的 (InputImage)输入图像,以链接由图像源生成的图像至需要 CogPMAlign 工具分析的输入图像上。
    初识VisionPro应用开发_第20张图片

3.4.2. 创建模式

PMAlign工具会在其要分析的每个图像中搜索/寻找经过训练的模式(trained pattern,即目标图案)。在配置PMAlign工具时,必须首先创建训练的模式,然后指定参数,例如要查找的模式数量(图像中存在的目标物体数量),每个潜在模式可能显示的预期维度范围(图像中可能存在的目标物体)以及其他搜索参数。该应用程序会使用一个硬币大小的圆点作为图案。如果你使用一枚硬币的真实图像,该工具也会尝试匹配这些特征。本例使用PatQuick算法,这是一个PMAlign工具选项,它用以提高工具的搜索速度,但会牺牲一定的准确性。在该应用场景中,搜索硬币并不需要很高的精度。

双击CogPMAlignTool1打开工具。

  1. 算法下拉菜单中选中PatQuick。使工具使用更快的PatQuick算法,该算法适用于本例。
    初识VisionPro应用开发_第21张图片

  2. 单击 抓取训练图像 ,使得工具以当前输入图像作为训练图像。

  3. 单击 训练区域&原点 选项卡来配置训练参数。

  4. 选项卡改变后,从显示菜单中选中 Current.TrainImage(当前训练图像) 以显示抓取的训练图像。

  5. 区域形状 下拉菜单中选择 CogRectangle 。这会告诉工具,你将选择一个简单的矩形区域进行训练。
    初识VisionPro应用开发_第22张图片

  6. 点击并拖动小的训练区域矩形以包围大的圆点,告诉工具使用图像的哪一部分作为模式。

  7. 点击中心原点按钮,将原点图标移动到矩形的中心。当工具在图像中找到特征时,它使用原点图标的相对位置来报告其位置。大多数情况下,寻找物体的中心就是你想要报道的位置。

  8. 点击训练参数选项卡以完成对模式的训练。
    初识VisionPro应用开发_第23张图片

  9. 勾选 忽略极性 选项。极性 会告诉工具,它应该考虑或忽略图案在亮背景上是暗的还是在暗背景上是亮的。由于该图案在浅色背景下是深色的,根据光线不同,硬币在背景下可能是深色或浅色。该情况下,忽略极性是正确的做法。

  10. 点击 训练 按钮。 经过训练的模式(图案)会出现在模式面板中, “已训练” 一词会显示在工具底部。
    初识VisionPro应用开发_第24张图片

你可能注意到了消息 模式包含的信息可能不足以测量 角度 可靠地 。因为你使用的图案是圆形的,因此PatMax软件无法确定它是否旋转。

3.4.3. 试用经过训练的模式

现在了解该模式工作的方式。

  1. 在图像下拉列表中选择 LastRun.InputImage 。最近一次运行图像的结果会在图像框中显示。由于你还没有运行该工具,因此该图像可能是空白的。
  2. 点击 运行 按钮。
    初识VisionPro应用开发_第25张图片
  3. 由于你使用的是当前图像作为训练模式(图案),所以工具应该会不出错并且很轻易地找到该模式。
  4. 点击 结果 选项卡查看工具生成的结果。
    初识VisionPro应用开发_第26张图片
  5. 结果窗格列出在图像中找到的所有特征。你可以检测每个特征的分数、位置和其他结果。
    当你选中结果窗格里的一行,相应形状在显示窗格中以蓝色突出显示。
    你可以使用该模式来查找图像中的任何圆形。但因为你想要找到的硬币可能有不同大小,所以你需要继续配置工具,使匹配模式更加灵活。
  6. 点击 运行参数 选项卡以调整工具的运行参数,使得工具可以处理不同大小的对象。
    初识VisionPro应用开发_第27张图片

3.4.4. 调运行参数

创建和训练模式是告诉PMAlign工具要寻找什么东西。而运行参数是告诉工具如何去发现它。

  1. 设置 Approx.number to find(查找概数) 至10。这个数字是工具的向导,而不是阈值。工具可能会找到超过该数量的实例。

    查找概数,字面意思也能体会出,就是图像中大概有几个目标模式。

  2. 点击 Scale(缩放) 箭头,将下限设为0.7,上限设为1.1。
    该设置允许你选择要查找的目标的相对大小。在本例中,使用的是期望的最大硬币来训练出来的模式。这套硬币中最小的是美国的一角硬币;它的直径大约是最大硬币的70%。
    比例因子也用于考虑尺寸和距离相机的微小差异。

初识VisionPro应用开发_第28张图片

现在用于找硬币的一切都已设置好:

  • 选择了用作模式的图像。
  • 训练了模式。
  • 设置了用于找到目标项的运行参数。

3.4.5. 运行整个作业

现在可以运行整个作业了。关闭 CogPMAlign 工具窗口,或者把它拖到一边,这样就可以看到 QuickBuild作业编辑器了。

  1. 点击 Run Job Once(单次运行作业) 按钮。
  2. QuickBuild会运行整个作业:
    • 从图像数据库或相机中获取下一个图像。
    • 运行 CogPMAlignTool 发现图像中的下一个目标项。
    • 将结果显示在显示窗格中。
  3. 可以点击 连续运行作业 ,使得QuickBuild获取图像并运行该工具,直到再次点击按钮。
    初识VisionPro应用开发_第29张图片
    在开发视觉应用程序时,你需要尝试处理可能的各种图像类型,并调节工具参数、相机对齐和照明等。如果需要为此应用程序执行该操作,双击QuickBuild作业编辑器中的 CogPMAlignTool1 项。

3.5. 分析结果

此时,应用程序已经完成了之前的任务:在图像中找到硬币。
现在,让它变得更有趣一点。
大多数视觉应用程序都需要检查图像,看它是否满足某些标准。在该程序中,你将检查图像中是否包含一定数量的硬币。

每个 VisionPro 工具都有一个结果状态(result status),该状态显示在工具编辑控件的左下角。在 QuickBuild作业编辑器 中,你可以在工具名称右侧的小图标中看到每个工具的状态。整个作业的结果状态取决于它用到的所有工具的结果状态。
初识VisionPro应用开发_第30张图片
理想情况下,PMAlign工具在找到所需的硬币数量时将判断通过,若数量未达标则认为失败。但PMAlign工具的实际用途远不止硬币计数。所以在使用前,最好先确定工具要生成哪些有用的信息。

为此,你需要暴露PMAlign工具生成的一些额外结果,并且使用一个新的工具,即叫作 结果分析器(Results Analysis tool) 工具来计算分析整个作业的检查状态。

这步就像代码中调用函数,取得函数的返回值那样。
判断函数的返回值是否符合要求。若符合要求,则通过;否则,失败。

3.5.1. 将新终端暴露给PMAlign工具

这边的终端可以理解为新的工具节点,将PMAlign的处理结果连接到新节点上,供它处理分析。
如果将工具看成一个函数,你也可以认为终端就是一个新的函数,将上一个工具的处理结果(函数返回值),当成下一个终端(函数)的输入参数传入。

默认情况下,PMAlign工具会暴露找到的第一个项的分数和姿势信息(pose information,姿势信息指的是找到的图案的大小和位置信息)。本例中你要暴露的数据是期望找到的硬币数量和实际发现的硬币数量。为此,你需要向PMAlign工具添加终端。

  1. 右键单击 QuickBuild作业编辑器窗口 中的 CogPMAlign 工具。

  2. 在弹出菜单中选中 Add Terminals(添加终端)
    初识VisionPro应用开发_第31张图片

  3. 此时成员浏览 对话框会被打开。
    初识VisionPro应用开发_第32张图片
    成员浏览器会暴露该工具的底层结构(类似代码的结构体或者类对象),这可能看起来有点复杂。于是为了降低复杂性,浏览器提供了三个层次结构; 典型(Typical)已展开(Expanded)所有(All) ,你可以从下拉菜单中进行选择。默认情况下, 典型 只显示最常用的元素。 已展开 会显示较长的列表, 所有 显示整个结构。

    自动展开 下拉框提供了自动展开常用属性集合的选项。当选择 公共成员 时,默认公共成员在显示时自动展开。若选择 ,则不会自动展开任何属性集合。本例中,使用 来尽可能的简洁显示。

    下表展示了浏览器显示的最常用的属性集合。这些属性集合在 .NET中作为类实现(就是这些属性分放在几个类中),大多数情况下它们对应于工具编辑控件中的选项卡。

    表1. VisionPro工具的部分

    属性集合(Class) 描述
    Results 该属性集合存储了工具生成的结果
    RunParams 此属性集合包含了控制工具如何运行的参数

    接下来的一组步骤将带你完成暴露两个数据:期望找到的硬币数量和工具实际找到的硬币数。

  4. 点击以展开 Results 项。

  5. 选择 Count 项。

  6. 点击 Add Output(添加输出) 按钮。这会使 Results 属性成为 PMAlign 工具的输出终端。此时对话框不会关闭,所以你可以继续添加更多的终端。
    初识VisionPro应用开发_第33张图片

  7. 点击 RunParams 项以展开。滚轮滚到下面找到 ApproximateNumberToFind 项并点击。

  8. 点击 添加输出 按钮使 ApproximateNumberToFind 属性成为一个输出终端。你会发现此时的 添加输入 按钮是可点击的。这意味着你能使用该终端作为输入终端。

  9. 点击 关闭 按钮。
    初识VisionPro应用开发_第34张图片

  10. 新终端出现在了 QuickBuild作业编辑器 中。
    初识VisionPro应用开发_第35张图片
    接下来的任务是配置 结果分析工具 ,以接收刚刚添加的两个新输出终端的值。

3.5.2. 向作业添加结果分析工具

  1. 若VisionPro工具箱还没打开,点击菜单栏的 显示VisionPro工具 项按钮来打开工具箱。
  2. 选择工具箱中的 CogResultsAnalysis Tool(康耐视结果分析工具)
  3. 将它拖入 QuickBuild作业编辑器 中。
    初识VisionPro应用开发_第36张图片

3.5.3. 配置结果分析工具

  1. 双击 CogResultsAnalysisTool1 项,以打开 结果分析工具。

  2. 工具的编辑控件对话框打开后,点击 添加输入 按钮两次。
    两个分别叫做 InputAInputB 的新的项出现在列表中。
    初识VisionPro应用开发_第37张图片

  3. 点击列表中新项的名称,进行重命名。将它们的名字改的更符合实际的意义:NumberFoundMinimum
    初识VisionPro应用开发_第38张图片
    现在你需要一个表达式来比较这两个值。

  4. 点击 添加表达式 按钮。

  5. 一个新的表达式行出现在了列表中。
    将要构建的表达式是这样的:“拒绝任何NumberFound小于Minimum的结果”。
    初识VisionPro应用开发_第39张图片

  6. 要创建该表达式,先选择关系。单击表达式中的运算符单元格并选择 小于
    初识VisionPro应用开发_第40张图片
    选好后,参数 列会变红,并且 列会显示 ERROR。这是正常的,因为你还没有完善整个表达式。

  7. 参数0 列的单元格选成 NumberFound参数1 的单元格选为 Minimum 。这样,表达式就完成了。
    初识VisionPro应用开发_第41张图片

  8. 最后一步是设置拒绝(reject)的条件。当创建的表达式为True时,表示拒绝图像。在 Output(输出) 行中 设 参数1ExprC
    这就是说,当 Expr 为True时, 结果分析工具 会返回一个拒绝状态值;换句话说,此时发现的硬币数量小于最小值。
    初识VisionPro应用开发_第42张图片

3.5.4. 将新终端连接到结果分析工具

现在你需要为PMAlign工具创建的终端连接到 结果分析工具的输入。

  1. 点击 CogResultsAnalysisTool1 左侧的 + 图标,使你在工具中定义的两个输入暴露出来。
  2. 点击 PMAlign工具Results.Count 输出,将它拖到结果分析工具的 NumberFound 输入上。同样地,将 Results.ApproximateNumberToFind 拖到 Minimum 上。
    初识VisionPro应用开发_第43张图片

3.5.5. 试用一下分析工具

现在,可以看一下刚刚配置的这一切是如何工作的。将 QuickBuild作业编辑器窗口CogResultsAnalysisTool1 窗口分别拖开来,以便你可以同时看到这两个窗口。工具窗口总是在作业编辑器窗口的前面。

  1. 点击 单次运行作业 按钮来运行视觉程序。
  2. 当PMAlign工具运行时,找到的硬币数量和预期的硬币数量会被传输到结果分析工具上。
  3. 由于表达式 ExprC 为True,找到的硬币数量小于最小硬币数量,所以分析工具的状态为拒绝。
  4. 拒绝 状态会传给整个作业。 拒绝等级 的结果意味着作业中的所有工具都正确运行,但没有满足接受的标准。这种情况下,意味着PMAlign工具找到的硬币太少了。
    初识VisionPro应用开发_第44张图片

3.5.6. 变更作业

尝试改变PMAlign中的 Approx. no. to find(查找概数) 这项设置,看看它会如何影响作业运行。

  1. 双击作业编辑器中的 CogPMAlignTool1 项,以打开工具。
  2. 点击 PMAlign编辑控件中的 运行参数 选项卡。
  3. 查找概数 设为 3。
  4. 再次点击 QuickBuild作业编辑器 中的 单次运行 按钮。
  5. 现在看一下 结果分析工具 中的新的 Minimum 值。
    初识VisionPro应用开发_第45张图片
  6. 这次因为表达式的值为 False(找到的硬币数量比最小值大了),所以 结果分析工具 判定为通过。
  7. 通过 的结果也会传播带作业的其余部分。

下一节将展示如何跟踪应用程序的结果。保留历史结果有助于查看程序的运行情况,并且它还能使你的视觉应用程序更容易变成可部署的软件。

3.6. 跟踪结果

使用视觉软件时,经常会去看之前的运行结果。 QuickBuild 使用 Posted Item(已发送项/已发布项) 列表来保存每个作业已完成运行的结果。另一个列表 Failure Results Queue(失败结果队列) 用来保存失败的请求结果。
初识VisionPro应用开发_第46张图片

迄今为止,你一直在使用 QuickBuild作业编辑器 ,它允许你处理作业相关的事。本节中,你将使用包含整个应用程序的 QuickBuild主窗口(类似程序中的main函数)。本例中,应用程序只有一个作业,但在稍复杂的情况下,同一个程序中可能有多个作业。

3.6.1. 配置程序以保存拒绝的结果

默认情况下,QuickBuild被设置为记住最近32次作业执行和最近32作业失败(这个不一定,可能跟版本有关,教程中说是32,我的是8)。对于本程序,要求失败结果队列还包括那些作业正常运行但结果是拒绝的执行(即硬币数量不够)。

  1. 点击QuickBuild窗口工具栏中的 配置QuickBuild应用程序属性 按钮。
    如你所见, 已发送项 列表大小已经被设为32了。
  2. 勾选 失败队列 块中的 拒绝 选项。这表示失败队列将包含作业失败的和作业返回拒绝级别状态的结果。
  3. 点击 确定
    初识VisionPro应用开发_第47张图片
    下一步来指定你想要保存在已发送项列表中的结果。

3.6.2. 配置已发送项列表

  1. 点击 QuickBuild 窗口中的 配置已发送项 按钮。

  2. 若你的程序有超过一个作业,你将选择作业名称。

  3. 确保选中 包括LastRunRecord图像和图形 选项,以将图像和结果图形一起保存在结果中。

  4. 点击 Add Item/Add New Link(添加项) 按钮向 已发布列表 中添加项。此时, 配置已发送项 浏览窗口会被打开。
    初识VisionPro应用开发_第48张图片
    配置已发送项浏览器 会暴露以下复杂结构。为了降低复杂性,和结果分析器中的操作一样,对它进行分级:典型、展开和所有。你可以从下拉框中选择层次结构。

  5. 点击 + 图标,展开 Tools(工具) 项。
    你将看到作业中列出的三个工具: 图像源工具、 PMAlign工具和结果分析工具。

  6. 点击 CogResultsAnalysisTool1 项边上的 + 图标,以展开它。
    初识VisionPro应用开发_第49张图片

  7. 继续展开下面的项以找到结果分析器中 NumberFound 项的值:
    CogResultsAnalysisTool/RunParams/Item[“NumberFound”]/CogResultsAnalysisExpression/Value/Int32

  8. 点击 添加到已发送项 以将 NumberFound 值添加到已发送项列表。浏览窗口会保持打开状态,因此你可以添加更多其他项。
    初识VisionPro应用开发_第50张图片

  9. 展开项以找到结果分析器中 Minimum 项的值:
    Item[“Minimum”] / CogResultsAnalysisExpression / Value / Int32

  10. 点击 添加至已发送项 来将 Minimum 值添加到已发送项列表。

  11. 点击 关闭 关掉配置已发送项浏览器窗口。你可以选中列表中的项并点击它们的名称来对项进行重命名。
    在这里插入图片描述

3.6.3. 运行程序并测试结果

现在已经设置好已发送列表和失败结果队列了,你可以查看它们是如何工作的了。

  1. 在QuickBuild窗口中,点击 连续运行QuickBuild应用程序 按钮。
    这会开始程序运行。你将可以观察到作业名右侧的图标发生变化,会从绿点(成功状态)改变为绿点带红线(拒绝状态)。

  2. 几秒以后,点击 显示悬浮结果 按钮。

  3. QuickBuild结果 窗口被打开。数据字段会在作业运行时更新,但图像不会。
    初识VisionPro应用开发_第51张图片

  4. 再次点击 连续运行QuickBuild应用程序 按钮以停止程序。

  5. 滚动到数据字段的末尾,查看添加到已发布列表中的结果以及其值。

  6. 显示区域会显示图像结果。

  7. 然而,通常情况,你只对失败的图像感兴趣。你之前已启用将拒绝级别的结果添加到失败结果队列中的选项。单击失败结果队列,查看被拒绝的图像。
    初识VisionPro应用开发_第52张图片

  8. 可以用 QuickBuild结果 窗口顶部的按钮来检查其他已保存的结果。
    初识VisionPro应用开发_第53张图片

至此,你已具备了使用VisionPro和QuickBuild开发和完善视觉应用程序所需的基本技能。在开发阶段,你可能会测试不同图像集,改进模式,调整结果等等。

当你对QuickBuild程序进行更改时,需要保存它。
初识VisionPro应用开发_第54张图片
QuickBuild将应用程序保存为扩展名为.VPP的QuickBuild项目文件。

一旦准备好部署应用程序,就可以使用保存好的QuickBuild应用程序和 VisionPro应用程序向导 来创建可执行的Windows应用程序。

4. 使用应用程序向导来创建一个视觉应用

4.1. 从QuickBuild应用程序创建可执行程序

QuickBuild提供了一个非常灵活的环境来开发视觉应用程序,但是对于该程序的用户来说,它并不是一个方便的环境。VisionPro应用程序向导 会使用你在QuickBuild中创建的视觉程序,并创建带有更容易使用的定制界面的Windows应用程序。

使用 应用程序向导 可以对应用程序进行修改。你可以用它来对程序的底层进行修改,或者你可以暴露视觉工具的一些设置项。

4.2. 在结果分析器中创建输入

本例中,你将向 结果分析工具 添加一个新的输入终端,以便用户可以在运行程序时设置拒绝条件。

  1. 双击QuickBuild窗口中的 CogJob1 作业,以打开 作业编辑器 窗口。

  2. 双击 CogResultsAnalysisTool1 项以打开 结果分析工具

  3. 点击 添加输入 按钮,以创建一个你将在 应用程序向导 中使用的新输入终端。
    初识VisionPro应用开发_第55张图片

  4. 将新输入命名为 InputMinimum

  5. 参数1 改成 InputMinimum

  6. QuickBuild 窗口中保存程序。点击 QuickBuild应用程序另存为 项,将保存的程序命名为 coinsApp.vpp
    初识VisionPro应用开发_第56张图片
    现在可以准备使用 应用程序向导 了。

4.3. 打开应用程序向导

保存了使用QuickBuild构建的程序后,退出QuickBuild并打开VisionPro应用程序向导。应用程序向导的图标:
初识VisionPro应用开发_第57张图片
VisionPro应用程序向导会指导你完成每一步,通常需要你填写一个字段,然后单击 下一步 按钮。下面是打开后的界面。
在这里插入图片描述

  1. 点击 下一步 进入下一个界面。
    在该应用程序向导会话完成时,你可以选择保存一个配置文件(.vpw文件)。配置文件包含最初的.vpp文件,以及在运行向导时对其做的所有更改。下面界面向你提供了重新加载配置文件并将其作为向导会话起点的选项。这允许你在作业上重新运行应用程序向导,而不必重复以前的所有更改。
    初识VisionPro应用开发_第58张图片
  2. 若你有想要使用的现有配置,单击 打开现有的配置 ;否则,点击 下一步
    初识VisionPro应用开发_第59张图片
  3. 选择QuickBuild项目 界面中,输入你所保存的QuickBuild程序的路径,或者使用 浏览(…) 按钮来选中它。若在上一步中输入了一个配置文件,那这个路径将为您填充相关的QuickBuild项目文件(.vpp)的路径。点击 下一步
  4. 应用程序向导可能会花大约一分钟的时间来加载保存过的 QuickBuild程序。当保存的应用程序中的作业名称出现在大纲中的 配置选项卡 下时,说明加载完毕了。
  5. 点击 下一步 两次,以到达 应用程序名称 界面。
    初识VisionPro应用开发_第60张图片
    在该对话框中,你可以命名应用程序,或者接受默认名称。应用程序名称将成为由向导生成的.exe文件的名称。
    点击 下一步
    初识VisionPro应用开发_第61张图片
  6. 若你希望对应用程序进行密码保护,就选中 启用密码支持 框。然后,你可以提供密码,或接受默认的 “Administrator”和“Supervisor”。
  7. 点击 下一步 按钮,直到到达 CogJob1 界面。现在来讲,将其他值设为默认值即可。

接下来,准备设计应用程序的UI了。

4.4. 创建UI

应用程序向导使用基于选项卡的界面生成应用程序。你可以根据需要添加任意数量的选项卡,每个选项卡都可以保存你希望用户查看或更改的数据。这是使用 应用程序向导 最困难的部分,但它非常类似于公开工具的终端或向已发布项列表添加项。

首先,你将提供一种方式来显示放置在已发布项列表中的两个项:找到的硬币数量和要从PMAlign工具中找的硬币的大致数量。

  1. 应用程序向导为你的作业设置一个选项卡。你也可以为选项卡修改名字。

  2. 点击 添加项 按钮,并选中下拉框中的 从已发布项添加输出
    初识VisionPro应用开发_第62张图片

  3. 新项以 已发布项 0 的形式出现在列表中。一会儿将更改它的名称。

  4. 路径 下拉菜单中,选中 结果分析工具NumberFound 项。
    初识VisionPro应用开发_第63张图片

  5. 在标题字段修改,将此项命名为 NumberFound
    初识VisionPro应用开发_第64张图片

  6. 点击 添加项 按钮,再次选中 从已发布项添加输出

  7. 这次选中 Minimum 。并将选项卡的标题命名为 ApproxNumberToFind
    初识VisionPro应用开发_第65张图片

  8. 点击 添加项 按钮,这次选中 添加输入字段

  9. 新项命名为 属性0 。 点击 路径 右侧的 属性浏览(…) 按钮。
    初识VisionPro应用开发_第66张图片

  10. 打开 选择输入属性 浏览窗口。浏览窗口会暴露复杂的底层结构。同样,为了降低复杂性,浏览器提供了三个结构层次:典型、扩展(已展开)和所有。默认情况下,典型只显示最常用的属性;扩展(已展开)显示较长列表;所有显示整个结构。选中下拉菜单中的 已展开 以公开本例所需的属性。打开 InputMinimum 项路径下面的项:
    Tools / Item[“CogResultsAnalysisTool1”] / CogResultsAnalysisTool / RunParams / Item[“InputMinimum”] / CogResultsAnalysisInputExpression / Value
    初识VisionPro应用开发_第67张图片

  11. 点击 确定

  12. 结果分析中的输入项没有关联的类型,因此会弹出一个对话框要求你选择它的类型。选中 Int32 并且点击 OK
    初识VisionPro应用开发_第68张图片

  13. 将新属性命名为 NumberToFind 。你将注意到,与其他字段不同的是,该字段可用于输入。
    初识VisionPro应用开发_第69张图片

  14. 点击 下一步 ,直到到达 输出目录 界面。

现在,你已经完成了应用程序向导中最困难的部分了。

4.4. 生成并运行应用程序

应用程序向导 的剩余步骤是让你选择生成的应用程序在硬盘上的位置,以及是否希望向导为您生成代码。

  1. 输出目录 界面上,您可以选择应用程序向导生成应用程序的目录。还可以输入名称,当然也能使用默认名称。
  2. 点击 下一步
    初识VisionPro应用开发_第70张图片
  3. 应用程序向导可以为程序生成代码,以便你修改应用程序。通常不需要这么做,除非你想从根本上改变应用程序的外观或行为。现在,选择 无源代码 即可。
    初识VisionPro应用开发_第71张图片
  4. 点击 下一步 ,直到到达 生成您的应用程序 界面。

你可能感兴趣的:(机器视觉,视觉检测,VisionPro,机器视觉)