HALCON手册简体中文版

1、第一章HALCON恭喜诸位。您采用了这套在产品研发，研究以及教育方面都有顶尖表现的影像分析软件。HALCON 可在 UNIX，NT/2000/xp 等等平台下作业，它独特的 Library 提供了千余个为影像 分析作业，数据可视化，除错等等功能所设计的运算符，用户可以利用它的功能以 C 及 C+等程序语言自行撰写图像处理程序。 此外，HALCON 亦支持 Windows NT/2000/XP 下的 COM 接口，所以您也可以透过 VisualBasic 使用它，使得系统的整合更为容易。HALCON 的设计使得影像区域，边缘，以及等值线的处理上更方便，优化的算法让这套 软件在一般的硬件上也有很好

2、的指令周期。HALCON 包含了名为 HDevelop 的程序设计界面，减少了设计软件所花的时间，还有一个好 用的联机帮助，您可以查到关于 HALCON 运算符间功能相近的替代者，可能的变化，以及 交互的参考。HALCON 从 6.0 版开始提供两个版本，除了标准版外，还有支持平行运算的 parallelHALCON，可使用多 CPU 的机器，提高指令周期。以下是 HALCON 特点的说明1.1HALCON 强化的opreator library提供有效率又有弹性的图像处理功能，简化了影像程序 的设计。HALCON operator library 有千余个运算符。所有的 HALCON 应用程

3、序(像是HDevelop 和HALCON C+程序)皆是利用这个 library 来工作。这些运算符功能广泛，包含了简单的读取影像，到复杂的像是 Kalman 滤波等。基本上这些运算符各有其单一功能，而非包含了各种运算，因此一个影像分析功能是由好几个运算符组成的，所以其弹性远大于由少数而复杂的运算符组成的分析程序。特化而复杂的运算符往往只适用于某些工作甚至于影像，应用范围狭窄。相对于这种窘境，HALCON 运算符却能任意组合来完成工作。众多的运算符中，有些是以不同的算法来达到相同的功能，例如只需要粗略定位时，可用fast_match 来作最快的运算，需要精确定位时，用 best_match，以

4、较多的时间来求得最准 确结果。 HALCON 可处理彩色及多频道影像 可用于计算的影像数据，包含二值化影像，单色，彩色，或是多频影像，在使用上并无差别。(多频道影像是以多镜头系统取得的影像数据)。HALCON 提供了快速有效率的 region 处理计算除了使计算更容易外，region 尺寸无限制，甚至于可以重迭，而 region 数据经过最佳的编码 处理，在内存中所占的资源极少。HALCON 可做 ROI 的计算每个影像中的物体都可由用户自行定义其 region，接着再由运算符进行计算时就可以只针 对定义区域作处理，因此可以集中运算资源和速度，达到最好的效率。HALCON 提供了快速的 pat

5、tern 匹配计算pattern 匹配在许多应用上是很有用的，但是却很花时间，HALCON 有许多不同的 pattern 演 算法，可以让您自行决定何时使用。HALCON 提供了形状导向(shape-based)的匹配计算，使得物体有重迭或是旋转杂置的状况 下仍可计算。除了 pattern 匹配外，形状导向的运算符可以在物体有缩放，照明改变，旋转 或重迭等等情况下仍旧能辨认出物体。从 6.1 版开始，还有一个辅助工具 HMatchIt，透过简 易的设定即可用来测试匹配执行的效率，藉由参数的调整让您找出最佳的设定值，达到最快 的计算速度。HALCON 提供了方便有效的 tuple 功能tuple

6、s 是一种很有用的功能，使您处理影像，区域，参数等等数据集合时更为便利。HALCON 的 tuples 可以将相关数据整合成一个对象，用户可以针对单一或多个 tuples 作处理，您就 不必为一个 tuple 中有多少元素要处理而烦恼，只要将指定的 tuple 丢给运算符，HALCON 就会处理 tuple 中所有要计算的元素。HALCON 在影像和数据管理上效率卓著HALCON 有个快速有效率的内存管理核心，这个机制提供了数据的读写，还有溢位的检 查。为了提高效率，共享的影像数据不会在内存中重复。HALCON 支持 C，C+以及 COM 的程序设计您可以在自己撰写的 C，C+和 COM 程序

7、中使用 HALCON 运算符，完成一个独立的程序。HALCON 的 HDevelop 工具帮助您发展影像分析程序 撰写影像分析程序通常是旷日费时，为了帮助设计人员找出合适的运算符及参数，HALCON 发展出一套工具程序 HDevelop。它如帮助您呢? 首先 HDevelop 有一个图形接口，要使用 的运算符和要分析的影像一目了然，运算符可以自行组合，计算成果实时显示在影像中，可63以帮助使用者了解不同运算符和参数对计算的影响。同时它也会提出一些运算符或参数的建 议，在线辅助除了解释运算符如何工作外，还有范例的说明。当您觉得计算成果满意了，可以把设计好的成果存成 HDevelop 的专用档案，

8、下次可再叫用，或者是将其输出成 C，C+或 COM 的程序代码，可供其他程序套用，就像自行撰写的程序一样。HALCON 可连接 40 余种影像撷取设备目前支持的设备列表在 open_framegrabber，给予格式或撷取模式等参数，再来用运算符 grab_image 即可取得影 像。HALCON 可以让您自行新增取像设备如果您用的取像设备 HALCON 尚未支持，您可以利用专用接口连接。HALCON 有个开放的 接口，配合一些程序代码，就可以和 HALCON 连接，相关的说明请参考 Frame Grabber Integration Programmer's Manual。1.2 可

9、执行 HALCON 的操作系统下表说明了可执行 HALCON 的操作系统Operating SystemProcessorCompilerWindows NT 4.0 /2000 /XPcompatible to Intel PentiumMS Visual Studio 3Linux 2.2/2.4compatible to Intel Pentiumgcc 2.95Solaris 7SPARCCC 5.2IRIX 6.5MIPSCCTru64 UNIX 5.1Alphacxx可执行 HALCON 的操作系统一览表请注意，在 Linux 下需要 libc6(glibc-2.1.x)， 这是在

10、大部分的 Linux 系统像是 RedHat 或 SuSe下需要的，请参考相关文件。HALCON 也可以在 Philips TriMedia DSP 上执行，主计算机需安装 NT/2000/XP，这部分 请参考 HALCON/C 之 User's Manual。1.3 Parallel HALCON 简介简单的说，标准版的 HALCON 是在单处理器的计算机上执行单线程计算，在 NT/2000/XP， Linux，Solaris，HALCON 是 thread-safe，也就是可以做多绪执行，不过所有的运算符执行 时都是独一的，所以线程间必须要互相等待。相对来说，Parallel HA

11、LCON 支持平行运算，是 thread-safe 以及 reentrant，也就是不同的 线程可以同时呼叫同一个运算符，可使用的操作系统包含 NT/2000/XP，Linux，Solaris。除了平行运算外，Parallel HALCON 在多处理器的系统上，会自动将运算符作平行化，旧的HALCON 也有此功能，像是 HDevelop 这个接口，所以您开发的 C+，C，不必再做更动。平行化的机制是将要处理的数据，例如影像，由不同的处理器上执行不同的线程(所谓的 data parallelism)，例如一张影像的滤波运算，在一个四处理器的计算机上执行时，计算工作会 被分成四份，由四个线程负责，

12、每个线程都是做相同的滤波计算。由于待处理的影像在 系统中不必复制，因此 HALCON 的这种设计构想可以达到最好的效率。至于平行化或数据分配的的程度可以实时掌控，以免造成反效果，例如一张很小的影像，又 要将数据分散处理反而会浪费时间，此外，不是所有的运算符做平行化都能提高效率。此外，parallel HALCON 是用于内存共享的系统中，像是典型的多 CPU 主板，这样不同 的线程才能共享一个 HALCON 数据库，同时也不必再复制影像而造成占用内存。这样 一来有些系统是不适合执行 HALCON 的，像是 cluster 式的工作站或是一些不提供共享记忆 体的系统。Parallel HALCO

13、N 也不提供 COM 接口，包含平行化机制和 reentrant，这是因为撰写 COM的主要工具，Microsoft 的Visual Basic ，尚未有效支持多绪执行之故。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

14、9;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 运算符的参考

15、手册。Application Guide这是几份各自独立的文件，即所谓的 Application Note，是以工业视觉应用的观点来写的， 主要是说明一些计算方式的关键以及使用时的注意事项以及要诀等等。例如以型状导向匹配 来寻找物体等等。在 MVTec 的网站上所有的参考手册都有 PDF 檔及 HTML 文件可以下载，网址为第二章 安装，授权以及设定在未说明安装及设定方法前，先来看看不同版本及授权的相关说明HALCON 有三种版本1.demo 版，含 HDEvelop 以及完整的图像处理功能，但是有一些限制，例如不能连接取像 设备，也少了程序设计界面，这个版本可让您测试 HALCON 运算符的

16、所有功能而无时间限 制。2.完整版，让您可以用 HALCON 的功能发展程序。除了 HDevelop 外，还包含了所有取像功 能，C，C+，COM 之接口，还有 Extension package Interface，让您可以整合自定义的运算 子或是新的取像设备。3.如果您用 HALCON 的功能写好程序，您可以得到一个 runtime version ，包含了程序中 需要的功能，这个版本就不包含 HDevelop。使用完整版或 runtime 版，需要不同的授权码，而 demo 版可以不用户许可证码。授权使用方 式说明如下1. Nodelocked license 用于固定地址的计算机或机器

17、2. 完整版上也可以使用所谓的 floating license，在局域网络中特定地址的机器可以使用，一 个 license server 会检查执行的 HALCON 程序数量。至于作为 license server 的机器并非要真如一般的 server 般庞大，或是一定要是某种 server 系统，像是 Windows NT server，它可以是一台 Linux 或是 Solaris 工作站，然后在其他的电 脑安装 Windows NT/2000/XP 等以执行 HALCON，只要在 HALCON 执行时能和这个 server 连接就可以了。如果是为了估价的目的，您可以用一个免费的 tem

18、porary license。2.1 安装以下说明如何由 CD 安装 HALCON，由网络安装的方法在网址 有说明。名为 release_note.html 的档案有 HALCON 的最新消息。除了 UNIX 的系统外，档案路径和环境变量是以 Windows 式的写法表示，例如%HALCONROOT%examplesextension_packagehalconuser请参考 2.4 节的说明若是在 UNIX 系统下，写法就变成$HALCONROOT/examples/extension_package/halconuser注意如果要安装大改版的新版 HALCON，例如 6.0 或 6.1 版

19、等等，就必须先将旧版卸载，这 在 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 的程序，当然

20、，您必须要有 Administrator 的权限。 首先，程序会先检查系统资源是否足够安装，再来会检查是否已安装了 HALCON，如果已安 装了相同的版本，程序会检查已安装的部分，再让您安装新增加的东西。若是已安装了不同 版本的 HALCON，会问您要不要保留，至于如何在不同版本间切换，在 2.1.5 节有说明。 安装程序同时也会检查是否有安装 ActiveVisionTools，还有它的版本是否和目前要安装的 HALCON 兼容。(请参考 2.1.5 节)这些检查都结束后，安装精灵会要您选择安装版本如下(Compact，Custom，Typical)Full HALCON version(R

21、untime)runtime version(Demo)demo 版的 hdevelop_demo.exe一些额外的东西可以日后再安装，一样将 CD 置入执行，再选择您要的部分即可。 再来，如果您要用 dongle，安装程序会问您是否安装驱动程序，2.3.5 节有驱动程序的说明，以及如何自行安装而不透过 HALCON 的安装程序。接着，程序会问您这台计算机是不是要当 成 floating license server，这样会安装名为 license manager daemon，来管理您的 floating license。floating license 的用户只要在一台计算机上安装这个程序

22、即可当作 license server。 请参考 2.3.4 节。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 的附 加部分要装在何处

23、。由于在 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)，但是更新方法 中并无解除旧版的

24、驱动程序以及新版的安装，所以 HALCON 会出现"license not found"或类 似的错误讯息，因此您要用 2.3.5.1 节的方法自行将旧的驱动程序移除。2.1.4 HALCON 系统里的各种档案以及目录 以下说明了安装目录%HALCONROOT%下的各种子目录以及档案内容，不过随着安装选项 的不同，有些目录不会出现。FLEXlm 包含检查 license 的程序bin HALCON 的主程序，像是 HDevelop，或是 DLL 檔，frame grabber 的 libraries 等等。docpdfPDF 说明文件examples其中的子目录包含各类范例

25、，例如application_guide，配合 C，C+，delphi 之程序设计，fg_integration(影像撷取 接口)，extension_package，hdevelop 之使用，MFC，VB 等等之范例。 注意，最好不要直接使用这些范例，因为在大部分的作业平台下，只有安装者可以修改或储 存这些范例，也不是所有用户都可以在范例的目录下新增储存东西。所以最好是自行复制 一份到自己的工作目录下。images 各种工作所用的影像include 给 C/C+程序使用的 headerlib HALCON 的 libraries，包含和各种取像设备相连接的驱动程序。(在 Windows 下扩

26、展名 为.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，然后进到 bini586-nt4

27、目录下(您的旧版 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 版(或

28、6.0.1)为基础的，所以要是装了 HALCON6.1 版，将会使得 ActivVisionTools 无法使用，所以 HALCON 6.1 的安装程序会 检查是否在计算机上已有安装 ActivVisionTools，如果侦测到安装了 ActivVisionTools2.0 版， 它会提供一个新的，和 HALCON 6.1 版相容的 OCX ActivVTools.ocx。一般来说这是您该做 的选择，您也可以事后手动修正如下，开一个 DOS shell，到您安装 ActivVisionTools 目录下 的 bini586-nt4 目录下，对旧的 ocx 做 unregist，键入regsvr

29、32 /u ActivVTools.ocx然后将其删除，或是改名，换成新的 ocx，这在 CD 中的 misci586-nt4avt20.下可以找到， 然后键入regsvr32 ActivVTools.ocx即完成更新注意，和 ActivVisionTools2.0 不同的，1.0 到 1.3 版不能和 HALCON6.1 版一起使用(因为没 有兼容的 ocx)，如果 HALCON6.1 版的安装程序发现计算机上安装了 ActivVisionTools，像是1.3 版，它会警告您继续安装会使得现存的 ActivVisionTools 无法使用，若您还想使用，您就 得保留旧有的 HALCON6.

30、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>UninstallHALCON 来卸载。3.从 5.2 版起，安装程序会检查机器上是否已有安装旧版，然后您可以利用安装程序来解除 旧版的

31、安装。这是比较好的方法，这样可以避免路径的变量发生问题。以上是标准的卸载法，如果遇到问题，请参考 6.5.2 节。 注意，卸载会真的删除安装的档案，不过不会删除用户设定的数据，也就是 registry中，像是和 HDevelop 有关的一些自定数据不会被删除，保留在 HKEY_CURRENT_USER>Software>MVTev>Halcon 下。这里可以自行手动删除，不会出 问题。卸载也不会移除 dongle 的驱动程序，要移除的话请参考 2.3.5 节的说明。关于 6.0.2 版的特别说明从这个版本开始需要一个新的 dongle 驱动程序，由于卸载不会移除旧有的驱动程序

32、，所 以无法安装 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 的 operat

33、or 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 的使

34、用者请参考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 来取得辨识数据是最简单的方法。在主选单

35、Help>About，会出现如 下的一个窗口，最底下的数据就是关于您这部计算机的数据，像是网络卡卡号，CPU ID，dongle 号码等。如果发生问题，既有的设备数据找不到，例如有网络卡而侦测不到，请参考 6.5.3 来排除问题。2.3.1.2用 lmhostid 来取得资料lmhostid 是随着 FLEXlm 的软件，在 Windows 操作系统下，由 DOS 下执行，在 UNIX 系统 中，则要切换目录，到$HALCONROOT/FLEXlm 下，再到对应您的硬设备的目录下(例如 i586-Linux2.2)执行之。要辨认一台计算机的网络卡号，键入 lmhostid -etherW

36、indows 系统下的输出画面例子如下> lmhostid -etherlmhostid - 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>

37、; lmhostid -cpu64lmhostid - Copyright (C) 1989-2000 Globetrotter Software, Inc. The FLEXlm host ID of this machine is "0003-C1DE-01C3-E79F"如果 lmhostid 回传""，则可能是因为在 BIOS 中 CPU ID 的选项关了，可在重新启动时将其开启。要检查 dongle ID(限于 Windows NT/2000/XP)，则键入lmhostid -flexid会得到如下例之输出> lmhostid -flex

38、idlmhostid - 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 之功能，特别的像是&

39、quot;Background Estimation"，"1D Bar Code Reader"之类的，只用于特定的程序。使用 runtime 版时可以只包含您需要的模块。 您的程序中用到了那些模块，有两种方式来检查。在 HDevelop 下执行的程序，可由选单下，File>Moduals，然后会出现一个如下图的窗口， 其中就有使用到的模块名称，然后按"Save"，即可将这些纪录存成.mod 文件，放在目前的工 作目录下。由C，C+，COM 所写成的应用程序，则需在程序结尾加入运算符 get_moduals。 然后将确定需要的模块名称送到

40、代理商。图例您使用到的模块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 FC17

41、B37961F326F957A8 VENDOR_STRING=65535 HOSTID=0080c77161e2 ck=23FEATURE MVTec_HDevelop mvtecd 6.1 permanent 0 CC279389F3566E1D6363 VENDOR_STRING=65535 HOSTID=0080c77161e2 ck=32图例nodelocked license，限用于某台计算机您可以看到，档案中"FEATURE"接着 HALCON 的版本名称，而 license 是向下兼容的，举 例来说，6.1 版的 license 亦可以用于 6.0 版。同时，

42、向上亦可用于小改版的升级，例如 6.1 版的 license 可用于 6.1.x 版。# MVTec (ID: FLEXID=7-b285ff7f) #FEATURE MVTec_Halcon mvtecd 6.1 permanent 0 3C574319AF86C4A5DE4A VENDOR_STRING=65535 HOSTID=FLEXID=7-b285ff7f ck=35FEATURE MVTec_HDevelop mvtecd 6.1 permanent 0 7C772379E2D066930D10 VENDOR_STRING=65535 HOSTID=FLEXID=7-b285ff

43、7f ck=245图例nodelocked development license ，限用于特定 dongle# MVTec (ID: FLEXID=7-b285ff7f) #FEATURE MVTec_Halcon mvtecd 6.1 permanent 0 3C574319AF86C4A5DE4A VENDOR_STRING=65535 HOSTID=FLEXID=7-b285ff7f ck=35图例nodelocked runtime license，限用于特定 dongle2.3.4floating license 之使用 在之前的介绍中已有概略的介绍，首先，要有一台计算机当成 li

44、cense 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 (I

45、D: 0080c77161e2) #SERVER halconserver 0080c77161e2 27000DAEMON mvtecd C:Progra1MVTecHalconFLEXlmi586-nt4mvtecd FEATURE MVTec_Halcon mvtecd 6.1 permanent 2 4C72DB2EC0F315624FAE VENDOR_STRING=16383 ck=97图例floating runtime license 的内容(限用于某台计算机)某些情况下您可会想改变计算机的 hostname，例如您用的是 dongle-bound license，基于某些 需

46、要想把 dongle 换到网络中另一台计算机上，或是您用限用于某网络卡的 license，而您想把 网络卡移到另一台计算机上。您也可能会需要更改使用的 port，例如默认的 port 已被网络中某软件占用，但是要注意的， 大部分的计算机中，portnumber 小于的，只有特定权限的使用者能更改。 当您在网络中任一台计算机执行 HALCON 时，license file 中的"SERVER"后接着的数据，诸如 host name 和 port number 等等，是用于让程序寻找联系 license server，而在作为 license server 的计算机上，port

47、 name 是作为启动 license manager daemon 的依据，所以在计算机中， 所有复制的档案内容必须相同。在您做为 license server 的计算机上，可能会需要修改 daemon 的目录 mvtecd，这目录通常如 下%HALCONROOT%FLEXlm%ARCHITECTURE%mvtecd(关于环境变量 ARCHITECTURE 请看 2.4 节)由于 license file 中没有环境变量数据，所以这个目录要自己新增。由于目录字符串中含有空白 字符时会造成 HALCON 的问题，所以当您将 HALCON 装在像是 c:program FilesMVTecHal

48、con 下时，路径字符串应改为 c:progra1MVTecHalcon。 最后一点，license manager daemon 必须在开机时启动。2.3.4.1 在 Windows NT/2000/XP 下安装 license manager daemon在 Windows 下，可以由安装程序来安装，然后他就会在重新启动以后自动启动，当然您也 可以自行手动安装，这要在 DOS 下键入(这是一整串指令)"%HALCONROOT%FLEXlmi586-nt4installs" -n "HALCON Licenses"-c "%HALCONROO

49、T%licenselicense.dat"-l "%HALCONROOT%licenselicense.log"-e "%HALCONROOT%FLEXlmi586-nt4lmgrd.exe"%HALCONROOT%即是安装的目录，在 Windows 下，安装好后必须重开机。如果安装成功， 一个称为 HALCON 的 service 会出现在控制面板下的系统管理工具的"服务"中出现。要移除 liscense manager daemon，键入如下之指令"%HALCONROOT%FLEXlmi58-nt4instal

50、ls" -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.log2&g

51、t;&1 &注意，lmgrd 要由 root 启动，否则不能正常的作业。2.3.4.3 重新启动 license manager daemon如果您换了一个 floating license，就要将 daemon 重新启动。方法之一是重新启动计算机，如 果您有管理者的权限，也可以用手动方式新启动。在 Windiows 下，您只要在系统管理工具 下的"服务"中，将"HALCON License"这个服务重新启动即可。在 UNIX 下，您可以终止 lmgrd 这个 process，然后再重新启动，启动的指令就是 2.3.4.2 节 中，加入启

52、动档的那一行。2.3.5 使用 dongledongle 只有在 windows 下才能使用，从 6.0.2 版起，还提供了连接 USB 的 dongle。连接印 表机埠的 dongle，其 ID 是以"FLEXID=6-"或"FLEXID=7-"开始，而 USB dongle 的 ID 是以 "FLEXID=9-"起。2.3.5.1 连接并行端口的 dongle就像 2.1.1 节所叙述的，您可以让 HALCON 安装驱动程序，要检查安装是否成功，可由装置 管理员来检视是否有一个叫 sentinel 的设备。HALCON 也有一个辅

53、助程序让您可以自行安装，设定，或是移除驱动程序。进到 DOS 下， 切换到%HALCONROOT%FLEXlmi568-nt4flexid6-7win_nt 目录下，执行 setupx86.exe。 要安装驱动程序，在主选单下选Functions>install，然后重新启动计算机。然后用上述的检查 方法应该可以看到该项设备。要注意的是，您必须要有 Administrator 的权限才能安装驱动程 式。如果您没有权限，程序会也安装，并告诉您安装完成，而实际上无法作用。要是计算机上有多个 parallel port，则还要再调整驱动程序。HALCON 的卸载程序并不会移除这个驱动程序(因为

54、其他程序有可能用到)，但是却会把 这个安装程序移除，所以如果您要移除这个 dongle 驱动程序，就要在您将 HALCON 解除安 装之前完成。这个安装程序是在 CD 的 FLEXlmi586-nt4flexid6-7win_nt，有需要时可再叫 用。关于 6.0.2 版的特别消息如同在 2.1.3 以及 2.2.1 节所叙述的注意事项，为避免出问题，建议以如下之程序进行安装。手动方式解除旧的驱动程序。用到的程序是 setupx86.exe，位于%HALCONROOT%FLEXlmi586-nt4dongle 下。 再来就有两个方式可以安装 HALCON 6.0.2。用 2.2.1 节的方法来

55、移除旧版的 HALCON，然后将 6.0.2 版和新的驱动程序一起安装。 用 2.1.3 节的更新方法，也就是手动更新，用到的程序 setupx86.exe 位在%HALCONROOT%FLEXlmi568-nt4flexid6-7win_nt 下。如果您在移除旧版的驱动程序前先移除了旧版的 HALCON，这个 setupx86.exe 也会被删除， 但是它是位在 CD 中 FLEXlmi586-nt4dongle 下，若您没有 CD，建议您重新安装旧版的 HALCON。2.3.5.2 USB dongle如同 2.1.1 节，所需要的驱动程序可在 HALCON 安装时一起安装，安装是否成功，可由装置 管理员中查看是否有新增以下两项装置Hardlock 以及 HASP。 随者操作系统的不同，您也可以用一个 HALCON 随附的辅助程序来修改，设定，移除驱动 程序。切换到 DOS 下，切换到目录%HALCONROOT%FLEXlmi586-nt4flexid9，有个程序 hinstall.exe ，有下列指令可供显示，安装，移除等等。hinstall显示如何使用 hinstallhinstall -info显使驱动程序的