HALCON手册简体中文版

0 第一章HALCON 恭喜诸位 您采用了这套在产品研发 研究以及教育方面都有顶尖表现的影像 分析软件 HALCON 可在 UNIX NT 2000 xp 等等平台下作业 它独特的 Library 提供了千余个为影像 分析作业 数据可视化 除错等等功能所设计的运算符 用户可以利用它的功能以 C 及 C 等程序语言自行撰写图像处理程序 此外 HALCON 亦支持 Windows NT 2000 XP 下的 COM 接口 所以您也可以透过 Visual Basic 使用它 使得系统的整合更为容易 HALCON 的设计使得影像区域 边缘 以及等值线的处理上更方便 优化的算法让这套 软 件在一般的硬件上也有很好的指令周期 HALCON 包含了名为 HDevelop 的程序设计界面 减少了设计软件所花的时间 还有一个好 用的联机帮助 您可以查到关于 HALCON 运算符间功能相近的替代者 可能的变化 以及 交互的参考 HALCON 从 6 0 版开始提供两个版本 除了标准版外 还有支持平行运算的 parallel HALCON 可使用多 CPU 的机器 提高指令周期 以下是 HALCON 特点的说明 1 1 HALCON 强化的opreator library提供有效率又有弹性的图像处理功能 简化了影像程序 的设计 HALCON operator library 有千余个运算符 所有的 HALCON 应用程序 像是HDevelop 和 HALCON C 程序 皆是利用这个 library 来工作 这些运算符功能广泛 包含了简单的读取 影像 到复杂的像是 Kalman 滤波等 基本上这些运算符各有其单一功能 而非包含了各种 运算 因此一个影像分析功能是由好几个运算符组成的 所以其弹性远大于由少数而复杂的 运算符组成的分析程序 特化而复杂的运算符往往只适用于某些工作甚至于影像 应用范围 狭窄 相对于这种窘境 HALCON 运算符却能任意组合来完成工作 众多的运算符中 有 些是以不同的算法来达到相同的功能 例如只需要粗略定位时 可用fast match 来作最快的 运算 需要精确定位时 用 best match 以较多的时间来求得最准 确结果 HALCON 可处理彩色及多频道影像 可用于计算的影像数据 包含二值化影像 单色 彩色 或是多频影像 在使用上并无差别 多频道影像是以多镜头系统取得的影像数据 HALCON 提供了快速有效率的 region 处理计算 除了使计算更容易外 region 尺寸无限制 甚至于可以重迭 而 region 数据经过最佳的编码 1 处理 在内存中所占的资源极少 HALCON 可做 ROI 的计算 每个影像中的物体都可由用户自行定义其 region 接着再由运算符进行计算时就可以只针 对定义区域作处理 因此可以集中运算资源和速度 达到最好的效率 HALCON 提供了快速的 pattern 匹配计算 pattern 匹配在许多应用上是很有用的 但是却很花时间 HALCON 有许多不同的 pattern 演 算法 可以让您自行决定何时使用 HALCON 提供了形状导向 shape based 的匹配计算 使得物体有重迭或是旋转杂置的状况 下仍可计算 除了 pattern 匹配外 形状导向的运算符可以在物体有缩放 照明改变 旋转 或重迭等等情况下仍旧能辨认出物体 从 6 1 版开始 还有一个辅助工具 HMatchIt 透过简 易的设定即可用来测试匹配执行的效率 藉由参数的调整让您找出最佳的设定值 达到最快 的计算速度 HALCON 提供了方便有效的 tuple 功能 tuples 是一种很有用的功能 使您处理影像 区域 参数等等数据集合时更为便利 HALCON 的 tuples 可以将相关数据整合成一个对象 用户可以针对单一或多个 tuples 作处理 您就 不必为一个 tuple 中有多少元素要处理而烦恼 只要将指定的 tuple 丢给运算符 HALCON 就会处理 tuple 中所有要计算的元素 HALCON 在影像和数据管理上效率卓著 HALCON 有个快速有效率的内存管理核心 这个机制提供了数据的读写 还有溢位的检 查 为了提高效率 共享的影像数据不会在内存中重复 HALCON 支持 C C 以及 COM 的程序设计 您可以在自己撰写的 C C 和 COM 程序中使用 HALCON 运算符 完成一个独立的程序 HALCON 的 HDevelop 工具帮助您发展影像分析程序 撰写影像分析程序通常是旷日费时 为了帮助设计人员找出合适的运算符及参数 HALCON 发展出一套工具程序 HDevelop 它如帮助您呢 首先 HDevelop 有一个图形接口 要使用 的运算符和要分析的影像一目了然 运算符可以自行组合 计算成果实时显示在影像中 可 2 以帮助使用者了解不同运算符和参数对计算的影响 同时它也会提出一些运算符或参数的建 议 在线辅助除了解释运算符如何工作外 还有范例的说明 当您觉得计算成果满意了 可 以把设计好的成果存成 HDevelop 的专用档案 下次可再叫用 或者是将其输出成 C C 或 COM 的程序代码 可供其他程序套用 就像自行撰写的程序一样 HALCON 可连接 40 余种影像撷取设备 目前支持的设备列表在 open framegrabber 给予格式或撷取模式等参数 再来用运算符 grab image 即可取得影 像 HALCON 可以让您自行新增取像设备 如果您用的取像设备 HALCON 尚未支持 您可以利用专用接口连接 HALCON 有个开放的 接口 配合一些程序代码 就可以和 HALCON 连接 相关的说明请参考 Frame Grabber Integration Programmer s Manual 1 2 可执行 HALCON 的操作系统 下表说明了可执行 HALCON 的操作系统 Operating SystemProcessorCompiler Windows NT 4 0 2000 XPcompatible to Intel PentiumMS Visual Studio 3 Linux 2 2 2 4compatible to Intel Pentiumgcc 2 95 Solaris 7SPARCCC 5 2 IRIX 6 5MIPSCC Tru64 UNIX 5 1Alphacxx 可执行 HALCON 的操作系统一览表 请注意 在 Linux 下需要 libc6 glibc 2 1 x 这是在大部分的 Linux 系统像是 RedHat 或 SuSe 下需要的 请参考相关文件 HALCON 也可以在 Philips TriMedia DSP 上执行 主计算机需安装 NT 2000 XP 这部分 请参考 HALCON C 之 User s Manual 3 1 3 Parallel HALCON 简介 简单的说 标准版的 HALCON 是在单处理器的计算机上执行单线程计算 在 NT 2000 XP Linux Solaris HALCON 是 thread safe 也就是可以做多绪执行 不过所有的运算符执行 时都是独一的 所以线程间必须要互相等待 相对来说 Parallel HALCON 支持平行运算 是 thread safe 以及 reentrant 也就是不同的 线程可以同时呼叫同一个运算符 可使用的操作系统包含 NT 2000 XP Linux Solaris 除了平行运算外 Parallel HALCON 在多处理器的系统上 会自动将运算符作平行化 旧的 HALCON 也有此功能 像是 HDevelop 这个接口 所以您开发的 C C 不必再做更动 平行化的机制是将要处理的数据 例如影像 由不同的处理器上执行不同的线程 所谓的 data parallelism 例如一张影像的滤波运算 在一个四处理器的计算机上执行时 计算工作 会 被分成四份 由四个线程负责 每个线程都是做相同的滤波计算 由于待处理的影像在 系统中不必复制 因此 HALCON 的这种设计构想可以达到最好的效率 至于平行化或数据分配的的程度可以实时掌控 以免造成反效果 例如一张很小的影像 又 要将数据分散处理反而会浪费时间 此外 不是所有的运算符做平行化都能提高效率 此外 parallel HALCON 是用于内存共享的系统中 像是典型的多 CPU 主板 这样不同 的 线程才能共享一个 HALCON 数据库 同时也不必再复制影像而造成占用内存 这样 一来 有些系统是不适合执行 HALCON 的 像是 cluster 式的工作站或是一些不提供共享记忆 体 的系统 Parallel HALCON 也不提供 COM 接口 包含平行化机制和 reentrant 这是因为撰写 COM 的主要工具 Microsoft 的Visual Basic 尚未有效支持多绪执行之故 4 1 4 其他数据 下列的手册提供了各种参考数据 HDevelop User s Manual 介绍与 HALCON 核心功能链接的图形用户接口 HDevelop HALCON C User s Manual 如何在您写的 C 程序中使用 HALCON library HALCON C User s Manual 如何在您写的 C 程序中使用 HALCON library HALCON COM User s Manual 如何在您写的 COM 程序中使用 HALCON library 例如使用 Visual Basic Extension Package Programmer s Manual 如何自己设计一个运算符 并将其整合到 HALCON 中 Frame Grabber Integration Programmer s Manual 如何将一个新的取像设备加入 HALCON 的系统中 更 新到8 0后这个手册就没有了 改为image acquire HALCON HDevelop HALCON C HALCON C HALCON COM 所有 HALCON 运算符的参考手册 Application Guide 这是几份各自独立的文件 即所谓的 Application Note 是以工业视觉应用的观点来写的 主要是说明一些计算方式的关键以及使用时的注意事项以及要诀等等 例如以型状导向匹配 来寻找物体等等 在 MVTec 的网站上所有的参考手册都有 PDF 檔及 HTML 文件可以下载 网址为 5 第二章 安装 授权以及设定 在未说明安装及设定方法前 先来看看不同版本及授权的相关说明 HALCON 有三种版本 1 demo 版 含 HDEvelop 以及完整的图像处理功能 但是有一些限制 例如不能连接取像 设备 也少了程序设计界面 这个版本可让您测试 HALCON 运算符的所有功能而无时间限 制 2 完整版 让您可以用 HALCON 的功能发展程序 除了 HDevelop 外 还包含了所有取像功 能 C C COM 之接口 还有 Extension package Interface 让您可以整合自定义的运 算 子或是新的取像设备 3 如果您用 HALCON 的功能写好程序 您可以得到一个 runtime version 包含了程序中 需要的功能 这个版本就不包含 HDevelop 使用完整版或 runtime 版 需要不同的授权码 而 demo 版可以不用户许可证码 授权使用 方 式说明如下 1 Nodelocked license 用于固定地址的计算机或机 器 2 完整版上也可以使用所谓的 floating license 在局域网络中特定地址的机器可以使用 一 个 license server 会检查执行的 HALCON 程序数量 至于作为 license server 的机器并非要真如一般的 server 般庞大 或是一定要是某种 server 系统 像是 Windows NT server 它可以是一台 Linux 或是 Solaris 工作站 然后在其他的电 脑安装 Windows NT 2000 XP 等以执行 HALCON 只要在 HALCON 执行时能和这个 server 连接就可以了 如果是为了估价的目的 您可以用一个免费的 temporary license 2 1 安装 以下说明如何由 CD 安装 HALCON 由网络安装的方法在网址 有说明 名为 release note html 的档案有 HALCON 的最新消息 除了 UNIX 的系统外 档案路径和环境变量是以 Windows 式的写法表示 例如 6 HALCONROOT examples extension package halconuser 请参考 2 4 节的说明 若是在 UNIX 系统下 写法就变成 HALCONROOT examples extension package halconuser 注意 如果要安装大改版的新版 HALCON 例如 6 0 或 6 1 版等等 就必须先将旧版卸载 这 在 Windows 下尤其重要 因为必须要清除旧版在 registry 的纪录 移除方法请看 2 2 节 有 个例外是 ActiveVisionTools 1 0 到 1 3 版想安装 HALCON6 1 版 这时就要保留旧版的 HALCON 6 0 x 如果只是小改版的更新 像是 6 0 1 升级成 6 0 2 版 有个特别的更新方法 在 2 1 3 节有说 明 2 1 1在 Windows NT 2000 XP 下的安装 将 CD 置入机器 就会启动一个安装程序 若没有自动执行 可在一个叫 nt x86 的目录下 执行一个名为 Setup exe 的程序 当然 您必须要有 Administrator 的权限 首先 程序会 先检查系统资源是否足够安装 再来会检查是否已安装了 HALCON 如果已安 装了相同的 版本 程序会检查已安装的部分 再让您安装新增加的东西 若是已安装了不同 版本的 HALCON 会问您要不要保留 至于如何在不同版本间切换 在 2 1 5 节有说明 安装程序 同时也会检查是否有安装 ActiveVisionTools 还有它的版本是否和目前要安装的 HALCON 兼容 请参考 2 1 5 节 这些检查都结束后 安装精灵会要您选择安装版本如下 Compact Custom Typical Full HALCON version Runtime runtime version Demo demo 版的 hdevelop demo exe 一些额外的东西可以日后再安装 一样将 CD 置入执行 再选择您要的部分即可 再来 如 果您要用 dongle 安装程序会问您是否安装驱动程序 2 3 5 节有驱动程序的说明 以及如何自行安装而不透过 HALCON 的安装程序 接着 程序会问您这台计算机是不是要 当 成 floating license server 这样会安装名为 license manager daemon 来管理您的 floating license floating license 的用户只要在一台计算机上安装这个程序即可当作 license server 请参考 2 3 4 节 7 2 1 2 在 UNIX 下的安装 您要先 mount CD 例如 cdrom 通常您要有 root 的权限才能作这个动作 而在大部分 的系统下 CD 会被 mount 成 etc fstab 不能在此执行程序 所以要改成mount dev cdrom cdrom 要安装时 启动 CD 主目录下的 shell script install unix 会问您 HALCON 要装在哪 接着 环境变量 HALCONROOT 也要设成安装的目录 参考 2 4 2 节 再来会问您 HALCON 的附 加部分要装在何处 由于在 CD 上是只读的 如果您是以一般使用者来安装 在权限改变时会出现警告讯息 而 某些系统上会出现文件名长度超过 32 字符的讯息 接着 会检查您的系统是否足够安装 安装完成后有几个环境变量要设定 HALCON 才能工 作 请参考 2 4 2 节 2 1 3 更新 HALCON 小改版的更新有一个特别的方法 例如从 6 0 或 6 0 1 更新到 6 0 2 更新方法请参 考 MVTec s 的下载区 关于 HALCON 6 0 2 版的特别说明 从 6 0 2 版开始 HALCON 要用新的 dongle 驱动程序 来自 GLOBEtrotter 但是更新方法 中并无解除旧版的驱动程序以及新版的安装 所以 HALCON 会出现 license not found 或类 似的错误讯息 因此您要用 2 3 5 1 节的方法自行将旧的驱动程序移除 2 1 4 HALCON 系统里的各种档案以及目录 以下说明了安装目录 HALCONROOT 下的 各种子目录以及档案内容 不过随着安装选项 的不同 有些目录不会出现 FLEXlm 包含检查 license 的程序 bin HALCON 的主程序 像是 HDevelop 或是 DLL 檔 frame grabber 的 libraries 等等 doc pdfPDF 说明文件 examples其中的子目录包含各类范例 例如 application guide 配合 C C delphi 之程序设计 fg integration 影像撷取 接口 extension package hdevelop 之使用 MFC VB 等等之范例 注意 最好不要 直接使用这些范例 因为在大部分的作业平台下 只有安装者可以修改或储 存这些范例 也不是所有用户都可以在范例的目录下新增储存东西 所以最好是自行复制 一份到自己的 工作目录下 8 images 各种工作所用的影像 include 给 C C 程序使用的 header lib HALCON 的 libraries 包含和各种取像设备相连接的驱动程序 在 Windows 下扩展名 为 lib UNIX 下则为 so license授权数据文件要放在这 里 2 1 5 不同 HALCON 版本间的切换 您可以同时安装不同版本的 HALCON 在同一台计算机上 在Windows NT 2000 XP 安装时 要修改相关的环境变量 像是 PATH HALCONROOT HALCONIMAGES 以 及自设的像是 HALCONEXTENSIONS 这部分请参考 2 4 1 节 如果您使用 HALCON 的 COM 接口 就要对专用的 DLL 檔 halconx dll 做 re register 例如 开一个 DOS shell 然后进到 bin i586 nt4 目录下 您的旧版 HALCON 先做 unregister 就 是在命令提示符号下键入 regsvr32 u halconx dll 然后到您的新版 HALCON 相对应的目录下 将halconx dll 做 register regsvr32 halconx dll 在 UNIX 下 要转换不同的 HALCON 版本 则要修改相关环境变量 像是 HALCONROOT HALCONIMAGES PATH LD LIBRARY PATH 等等 2 1 6 给 ActivVisionTools 用户的信息 ActiveVisionTools1 0 到 2 0 版是以 HALCON6 0 版 或 6 0 1 为基础的 所以要是装了 HALCON6 1 版 将会使得 ActivVisionTools 无法使用 所以 HALCON 6 1 的安装程序会 检查是否在计算机上已有安装 ActivVisionTools 如果侦测到安装了 ActivVisionTools2 0 版 它会提供一个新的 和 HALCON 6 1 版相容的 OCX ActivVTools ocx 一般来说这是您该 做 的选择 您也可以事后手动修正如下 开一个 DOS shell 到您安装 ActivVisionTools 目 录下 的 bin i586 nt4 目录下 对旧的 ocx 做 unregist 键入 regsvr32 u ActivVTools ocx 9 然后将其删除 或是改名 换成新的 ocx 这在 CD 中的 misc i586 nt4 avt20 下可以找到 然后键入 regsvr32 ActivVTools ocx 即完成更新 注意 和 ActivVisionTools2 0 不同的 1 0 到 1 3 版不能和 HALCON6 1 版一起使用 因为没 有兼容的 ocx 如果 HALCON6 1 版的安装程序发现计算机上安装了 ActivVisionTools 像 是 1 3 版 它会警告您继续安装会使得现存的 ActivVisionTools 无法使用 若您还想使用 您就 得保留旧有的 HALCON6 0 x 同时用 2 1 5 节的方法来转换版本 如果只是要评估试用新版 建议您安装试用版 这样就不必再 registerCOM 接口的 library halconx dll 2 2 卸载 2 2 1 Windows NT 2000 XP 在 Windows 下有几种卸载的方式 不过某些旧版的 HALCON 不一定适用 1 在控制台下 选择新增 移除程序 2 若您用的是 HALCON 5 1 以后的版本 从开始 程序集 MVTec HALCON Uninstall HALCON 来卸载 3 从 5 2 版起 安装程序会检查机器上是否已有安装旧版 然后您可以利用安装程序来解除 旧版的安装 这是比较好的方法 这样可以避免路径的变量发生问题 以上是标准的卸载法 如果遇到问题 请参考 6 5 2 节 注意 卸载会真的删除安装的档 案 不过不会删除用户设定的数据 也就是 registry 中 像是和 HDevelop 有关的一些自定数据不会被删除 保留在 HKEY CURRENT USER Software MVTev Halcon 下 这里可以自行手动删除 不会出 问题 卸载也不会移除 dongle 的驱动程序 要移除的话请参考 2 3 5 节的说明 10 关于 6 0 2 版的特别说明 从这个版本开始需要一个新的 dongle 驱动程序 由于卸载不会移除旧有的驱动程序 所 以无 法安装 6 0 2 版所需的新的驱动程序 所以在用程序进行卸载旧版的 HALCON 前 要先以 手动移除其驱动程序 请参考 2 3 5 1 节 2 2 2 在 UNIX 下卸载 只要将 HALCON 所在的安装目录移除即可 rm rf HALCONROOT 再来 移除子目录 hevelop 这是位在环境变量 HOME 所定义的目录之下 参考 2 4 2 节 HDevelop 是以这个目录来储存窗口位置 选项数据等 卸载不会删除任何用户自定数据 因此环境变量也不会改变 要删除或修改时就要自 行手动处理 如果您呼叫了 Parallel HALCON 6 0 beta 的 operator check par hw potential 来做初始化动 作 取得的资料会存在一 halcon par info 文件中 置于环境变量 HOME 所指定的目录下 2 3 授权 HALCON 透过FLEXlm license manager 来确认用户的授权数据 以下说明取得授权码 及其安装方式 要取得授权前 先要取得欲安装 HALCON 计算机之辨识数据 送至代理商 新亚洲仪器公司 若使用的是 runtime license 则请告知欲安装的模块 请参考 2 3 2 在您收到 license file 之后 请参考 2 3 2 节的方法来安装 floating license 的使用者请参考 2 3 4 节来安装 2 3 4 取得辨识资料 取得辨识数据是由您计算机上安装的网络卡 若您的操作系统为NT 2000 XP 处理器为 Pentium III 则能取得所谓的 CPU ID 在 Windows NT 2000 XP 下 也可以用一个 dongle 只要有 dongle 就可以在其他计算机上执行 这样就不必限定在某台计算机上使用 而且适 用于 nodelocked 或是 floating license 之使用者 详细说明请参考 2 3 5 节 2 3 1 1 用 HDevelop 取得辨识资料 用 demo 版的 HDevelop 来取得辨识数据是最简单的方法 在主选单 Help About 会出现如 下的一个窗口 最底下的数据就是关于您这部计算机的数据 像是网络卡卡号 CPU ID dongle 号码等 11 如果发生问题 既有的设备数据找不到 例如有网络卡而侦测不到 请参考 6 5 3 来排除问 题 2 3 1 2用 lmhostid 来取得资料 lmhostid 是随着 FLEXlm 的软件 在 Windows 操作系统下 由 DOS 下执行 在 UNIX 系统 中 则要切换目录 到 HALCONROOT FLEXlm 下 再到对应您的硬设备的目录下 例如 i586 Linux2 2 执行之 要辨认一台计算机的网络卡号 键入 lmhostid ether Windows 系统下的输出画面例子如下 lmhostid ether lmhostid Copyright C 1989 2000 Globetrotter Software Inc The FLEXlm host ID of this machine is 00e02958e36a 请将ID 就是上面例中的 00e02958e36a 以及计算机的 hostname 一起送给代理商 如果 lmhostid 回传 ffffffff 请依照 6 5 3 1 节的方法来处理 要辨认 CPU ID 键入 lmhostid cpu64 lmhostid cpu64 lmhostid Copyright C 1989 2000 Globetrotter Software Inc The FLEXlm host ID of this machine is 0003 C1DE 01C3 E79F 如果 lmhostid 回传 则可能是因为在 BIOS 中 CPU ID 的选项关了 可在重新启动时将其 开启 12 要检查 dongle ID 限于 Windows NT 2000 XP 则键入lmhostid flexid 会得到如下例之输出 lmhostid flexid lmhostid Copyright C 1989 2000 Globetrotter Software Inc The FLEXlm host ID of this machine is FLEXID 7 36c79bd7 注意 此时序号会写入 dongle 中 2 3 2 Runtime license 和 HALCON 的模块 HALCON 之运算符可分类成不同的模块 像是 Basic operators 或是 Image Region XLD management 用于所有 HALCON 之功能 特别的像是 Background Estimation 1D Bar Code Reader 之类的 只用于特定的程序 使用 runtime 版时可以只包含您需要的模块 您的程序中用到了那些模块 有两种方式来检查 在 HDevelop 下执行的程序 可由选单下 File Moduals 然后会出现一个如下图的窗口 其中就有使用到的模块名称 然后按 Save 即可将这些纪录存成 mod 文件 放在目前的 工 作目录下 由C C COM 所写成的应用程序 则需在程序结尾加入运算符 get moduals 然后将确定需要的模块名称送到代理商 图例您使用到的模块 13 2 3 3 安装 license file 要使用 HALCON 就要安装 license file 这个档案必须放在 HALCONROOT license 下 档名需为 license dat 如果是用 floatong license 您必须将这个档案复制到所有已安装 HALCON 的计算机上 包括作为 license verver 的计算机 以下例子是一个 nodelocked license file 的内容 MVTec ID 0080c77161e2 FEATURE MVTec Halcon mvtecd 6 1 permanent 0 FC17B37961F326F957A8 VENDOR STRING 65535 HOSTID 0080c77161e2 ck 23 FEATURE MVTec HDevelop mvtecd 6 1 permanent 0 CCF3566E1D6363 VENDOR STRING 65535 HOSTID 0080c77161e2 ck 32 图例nodelocked license 限用于某台计算机 您可以看到 档案中 FEATURE 接着 HALCON 的版本名称 而 license 是向下兼容的 举 例来说 6 1 版的 license 亦可以用于 6 0 版 同时 向上亦可用于小改版的升级 例如 6 1 版的 license 可用于 6 1 x 版 MVTec ID FLEXID 7 b285ff7f FEATURE MVTec Halcon mvtecd 6 1 permanent 0 3CAF86C4A5DE4A VENDOR STRING 65535 HOSTID FLEXID 7 b285ff7f ck 35 FEATURE MVTec HDevelop mvtecd 6 1 permanent 0 7CE2DD10 VENDOR STRING 65535 HOSTID FLEXID 7 b285ff7f ck 245 图例nodelocked development license 限用于特定 dongle MVTec ID FLEXID 7 b285ff7f FEATURE MVTec Halcon mvtecd 6 1 permanent 0 3CAF86C4A5DE4A VENDOR STRING 65535 HOSTID FLEXID 7 b285ff7f ck 35 图例nodelocked runtime license 限用于特定 dongle 14 2 3 4floating license 之使用 在之前的介绍中已有概略的介绍 首先 要有一台计算机 当成 license verver 安装一个名为 license manager daemon 的程序来检查网络中执行 HALCON 之计算机之数目 再来 license file 要 copy 到所有安装 HALCON 之计算机 而且也要 copy 到作为 license verver 的 计算机上 参 考 2 3 4 3 接着来看看一个典型的 floating license SERVER 告诉 FLEXlm 当作 license server 计算机 的 名称 这个例子里 就是halconserver 还有网络卡号 以及 port number 27000 MVTec ID 0080c77161e2 SERVER halconserver 0080c77161e2 27000 DAEMON mvtecd C Progra 1 MVTec Halcon FLEXlm i586 nt4 mvtecd FEATURE MVTec Halcon mvtecd 6 1 permanent 2 4C72DB2EC0FFAE VENDOR STRING 16383 ck 97 图例floating runtime license 的内容 限用于某台计算机 某些情况下您可会想改变计算机的 hostname 例如您用的是 dongle bound license 基于某 些 需要想把 dongle 换到网络中另一台计算机上 或是您用限用于某网络卡的 license 而 您想把 网络卡移到另一台计算机上 您也可能会需要更改使用的 port 例如默认的 port 已被网络中某软件占用 但是要注意的 大部分的计算机中 portnumber 小于 的 只有特定权限的使用者能更改 当您 在网络中任一台计算机执行 HALCON 时 license file 中的 SERVER 后接着的数据 诸如 host name 和 port number 等等 是用于让程序寻找联系 license server 而在作为 license server 的计算机上 port name 是作为启动 license manager daemon 的依据 所以在计算机 中 所有复制的档案内容必须相同 在您做为 license server 的计算机上 可能会需要修改 daemon 的目录 mvtecd 这目录通常 如 下 HALCONROOT FLEXlm ARCHITECTURE mvtecd 关于环境变量 ARCHITECTURE 请看 2 4 节 由于 license file 中没有环境变量数据 所以这个目录要自己新增 由于目录字符串中含有空 白 字符时会造成 HALCON 的问题 所以当您将 HALCON 装在像是 c program Files MVTec Halcon 下时 路径字符串应改为 c progra 1 MVTec Halcon 最后一点 license manager daemon 必须在开机时启动 2 3 4 1 在 Windows NT 2000 XP 下安装 license manager daemon 在 Windows 下 可以由安装程序来安装 然后他就会在重新启动以后自动启动 当然您也 可以自行手动安装 这要在 DOS 下键入 这是一整串指令 15 HALCONROOT FLEXlm i586 nt4 installs n HALCON Licenses c HALCONROOT license license dat l HALCONROOT license license log e HALCONROOT FLEXlm i586 nt4 lmgrd exe HALCONROOT 即是安装的目录 在 Windows 下 安装好后必须重开机 如果安装成功 一个称为 HALCON 的 service 会出现在控制面板下的系统管理工具的 服务 中出现 要移除 liscense manager daemon 键入如下之指令 HALCONROOT FLEXlm i58 nt4 installs r n HALCON Licenses 2 3 4 2 在 UNIX 下安装 license manager daemon 在 UNIX 下 这个程序 lmgrd 必须放在适当的启动档中 像是 etc init d boot local 或 sbin init d boot local 诸如此类 这部分请参考您使用的操作系统手册 在这个档案中加入下面一整行 要有 lmgrd 的目录 etc lmgrd c HALCONROOT license license dat HALCONROOT license license log 2 input control on 这样的设定结果就和先前用 set spy 的例子是一样的 在 UNIX 下 两个变量之间要用 冒号 分隔 6 5 疑难解答 这里说明在安装 卸载 使用 HDevelop 以及 Parallel HALCON 时遇到的错误讯息以及 排 除方法 6 5 1 安装时的问题 Registration of halconx dll failed 在某些系统上 可能会遇到 HALCON COM 的 library halconx dll 发生无法完成 self register 的警告 可能的原因之一是 Microsoft 本身的 atl dll 在 register 时出问题 这个 library 位于 SystemRoot system32 下 例如 C WINNT sysem32 要将这个 library 完成注册 请 依下列程序执行 开启一个 DOS 窗口 将目录切换到 CD 上的 misc i586 nt4 然后执行注册程序 56 E cd misc i586 nt4 reg halconx atl dll reg halconx 安装以及卸载license manager daemon 万一使用 floating license 所需要的 FlEXlm license daemon 没有装好 就要以手动方式另行 安装 开启一个 DOS 窗口 输入下列指令 注意 这是一整串指令 HALCONROOT FLEXlm i586 nt4 installs n HALCON License c HALCONROOT license license dat l HALCONROOT license license log e HALCONROOT FLEXlm i586 nt4 lmgrd exe 安装成功以后 在控制面板 系统管理工具 服务中 就会看到一个名为 HALCON License 的 service 要解除这个 daemon 指令如下列 HALCONROOT FLEXlm i586 nt4 installs r n HALCON License 6 5 2 卸载时遇到的问题 Unregistration of halconx dll 如果您在先前用手动方式 register HALCON COM 接口的halconx dll 而现在要将 HALCON 卸载时 必须以手动方式先将 halconx dll 做 unregister 开启一个 DOS 窗口 将目录切换到 CD 上的 misc i586 nt4 然后执行注册程序 E cd misc i586 nt4 reg halconx u 移除 license manager daemon 如同 2 2 1 节所叙的 要移除使用 float license 的 HALCON 5 0 或 5 1 版时 有时会遇到 FlEXlm license daemon 没有移除完全 要将其移除 请在进行 uninstall 前 以如下的手动 方式进行 开启一个 DOS 窗口 输入 HALCONROOT FLEXlm i586 nt4 installs r n HALCON License 由于在 DOS 命令提示模式下输入的路径名称中不能含有空格 所以如果您将 HALCON 装在 像是下列的目录 57 c Pregram Files MVTec Halcon 在输入时就必须改成 这是一整行 c Progra 1 MVTec Halcon FLEXlm i586 nt4 installs r n HALCON License 否则就以下列的输入方式 这是一整行 c Program Files MVTec Halcon FLEXlm i586 nt4 installs r n HALCON License 当然也可以先切换到程序所在的目录 cd HALCONROOT FLEXlm i586 nt4 再执行程序来解除登录 installs r n HALCON License 关于 Internal Error 若是在卸载的过程中遇到下列的讯息 Inter Error unable to load or call external DLL Please contact your distributor for more information 最有可能的原因是安装新版时 未先将旧版的东西完全移除 另一个可能的原因是 安装时的目录有所更动 或是环境变量 HALCONROOT 经过手动修改 遇到这类的情况请依下列步骤来排除问题 1 检查环境变量 HALCONROOT 的内容 看看是不是和您安装 HALCON 的目录相符 检查的方法是由 我的计算机 控制面板 系统 进阶 环境变量来查看 或是在 DOS 命 令提示符 号下 键入echo HALCONROOT 也可以查看变量内容 如果变量内容是空的或是 其中的路径内容并非您安装 HALCON 的目录 必须再从控制面板 中以手动方式去修改 2 检查下列两个档案在不在 在 HALCONROOT 下 Unins isu 在 HALCONROOT FLEXlm i586 nt4 下 HalconUninst dll Uninst isu 这个档案在安装时就会自动产生 如果没有这个档案 就无法进行自动的解除安 58 装 HalconUninst dll 是专为 HALCON 卸载而设计的 如果不见了 可以从 HALCON 的 CD 上复制一份 档案位于 FLEXlm i586 nt4 下 3 检查 Windows 登录档中关于 Uninstaller 的设定 启动登录文件的编辑程序 regedit 找到下列登录项目 HKEY LOCAL MACHINE SOFTWARE Microsoft Windows CurrentVersion Uninstall Halcon 这里的即是您想要移除的 Halcon 版本名称 或是不在计算机中的 另外 还 有一个机码名称为 UninstallString 其字符串内容应该有如下列 或类似 c WINNT IsUninst exe f c Program Files MVTec Halcon Uninst isu c c Program Files MVTec Halcon FLEXlm i586 nt4 HalconUninst dll 当然要确定 c Program Files MVTec Halcon 是实际的安装路径 同时和环境变量 HALCONROOT 是一致的 要注意的是当路径中含有空格 像是 Program Files 之类的 此时就要将整个路径用引号 括起来 如果您发现路径之中含有空格而没有用引号 请自行 加上 4 最后 关闭 regedit 重新再试一次 uninstall 遇到 uninstallation failed 若是遇到卸载无法自动进行 则以下列手动方式进行 1 使用 floating license 版本的 先以下列指令将 license manager service 关闭 HALCONROOT FLEXlm i586 nt4 installs r n HALCON License 2 用 regedit 将下列机码删除 HKEY LOCAL MACHINE SOFTWARE Microsoft Windows CurrentVersion Uninstall Halcon 以及 HKEY LOCAL MACHINE SOFTWARE MVTec 3 用文件管理器 删除下列目录 SystemRoot Profiles All Users start Menu Programs Halcon 通常 SystemRoot 是 c winnt 59 4 最后 删除 Halcon 的安装目录 HALCO