HALCON手册中文版资料

第一章HALCON

恭喜诸位。您采用了这套在产品研发，研究以及教育方面均有顶尖体现H勺影像

分析软件。

HALCON可在UNIX,NT/2023/xp等等平台下作业，它独特的Library提供了千余个为影像

分析作业，数据可视化，除错等等功能所设计的运算符，顾客可以运用它H勺功能以C及C++

等程序语言自行撰写图像处理程序。

此外，HALCON亦支持WindowsNT/2023/XP下的COM接口，因此您也可以透过Visual

Basic使用它，使得系统的整合更为轻易。

HALCON的设计使得影像区域，边缘,以及等值线的J处理上更以便，优化H勺算法让这套软

件在一般的硬件上也有很好的I指令周期。

HALCON包括了名为HDevelop的I程序设计界面，减少了设计软件所花H勺时间，尚有一种好

用的联机协助，您可以杳到有关HALCON运算符间功能相近的替代者，也许H勺变化，以及

交互的参照。

HALCON从6.0版开始提供两个版本，除了原则版外，尚有支持平行运算的parallel

HALCON,可使用多CPU的机器，提高指令周期。

如二是HALCON特点时阐明

1.1

HALCON强化口勺opreatorlibrary提供有效率乂有弹性的图像处理功能，简化了影像程序

口勺设计。

HALCONoperatorlibrary有千余个运算符。所有H勺HALCON应用程序（像是HDevelop和

HALCONC++程序）皆是运用这个library来工作。这些运算符功能广泛，包括了简朴的读取

影像，到复杂的像是Kalman滤波等。基本上这些运算符各有其单一功能，而非包括了多种

运算，因此一种影像分析功能是由好几种运算符构成的，因此其弹性远不小于山少数而复杂

H勺运算符构成的分析程序。特化而复杂H勺运算符往往只合用于某些工作甚至于影像，应用范

围狭窄。相对于这种窘境，HALCON运算符却能任意组合来完毕工作。众多的运算符中，

有些是以不一样的I算法来到达相似的功能，例如只需要粗略定位时，可用fast_match来作最

快的运算，需要精确定位时，用best_match,以较多H勺时间来求得最准确成果。

HALCON可处理彩色及多频道影像可用于计算的影像数据，包括二值化影像，单色，彩色，

或是多频影像，在使用上并无差异。（多频道影像是以多镜头系统获得的影像数据）。

HALCON提供了迅速有效率的region处理计算

除了使计算更轻易外，region尺寸无限制，甚至于可以重迭，而region数据通过最佳时编码

处理，在内存中所占的资源很少。

HALCON可做ROI的计算

每个影像中的物体都可由顾客自行定义其region,接着再由运算符进行计算时就可以只针

对定义区域作处理，因此可以集中运算资源和速度，到达最佳的效率。

HALCON提供了迅速［向pattern兀配计算

pattern匹配在许多应用上是很有用的J,不过却很花时间，HALCON有许多不一样的pattern

演算法，可以让您自行决定何时使用。

HALCON提供了形状导向（shape-based）的匹配计算，使得物体有重迭或是旋转杂置的状况

下仍可计算。除了pattern匹配外，形状导向口勺运算符可以在物体有缩放，照明变化，旋转

或重迭等等状况下仍旧能识别出物体。从6.1版开始，尚有一种辅助工具HMatchlt,透过简

易的设定即可用来测试匹配执行的I效率，藉由参数的调整让您找出最佳的J设定值，到达最快

H勺计算速度。

HALCON提供了以便有效的Ituple功能

tuples是一种很有用的功能，使您处理影像，区域，参数等等数据集合时更为便利。HALCON

口勺luples可以将有关数据整合成一种对象，顾客可以针对单一或多种tuples作处理，您就

不必为一种tuple中有多少元素要处理而烦恼，只要将指定的duple丢给运算符，HALCON

就会处理tuple中所有要计算的元素。

HALCON在影像和数据管理上效率卓著

HALCON有个迅速有效率H勺内存管理关键，这个机制提供了数据H勺读写，尚有溢位H勺检

查。为了提高效率，共享的影像数据不会在内存中反复。

HALCON支持C,C++以及COMP勺程序设计

您可以在自己撰写的C,C++和COM程序中使用HALCON运算符，完毕一种独立的程序。

HALCON的HDevelop工具协助您发展影像分析程序

撰写影像分析程序一般是旷日费时，为了协助设计人员找出合适时运算符及参数，HALCON

发展出一套工具程序HDevelop。它如协助您呢？首先HDevelop有一种图形接口，要使用

口勺运算符和要分析的影像一目了然，运算符可以自行组合，计算成果实时显示在影像中，可

以作助使用者理解不一样运算符和参数对计算的影响。同步它也会提出某些运算符或参数的

建议，在线辅助除理解释运算符怎样工作外，尚有范例的阐明。当您觉得计算成果满意了，

可以把设计好的成果存成HDevelop的专用档案，下次可再叫用，或者是将其输出成C,C++

或COM口勺程序代码，可供其他程序套用，就像自行撰写的程序同样。

HALCON可连接40余种影像撷取设备

目前支持的I设备列表在/,要连液取像设备，只要用运算符openjramegrabber,予以格式

或撷取模式等参数，再来用运算符grabjmage即可获得影像。

HALCON可以让您自行新增取像设备

假加您用的取像设备HALCON尚未支持，您可以运用专用接口连接。HALCON有个开放H勺

接口，配合某些程序代码，就可以和HALCON连接，有关的阐明请参照FrameGrabber

IntegrationProgrammer'sManuaL

1.2可执行HALCON的操作系统

下表阐明了可执行HALCON的操作系统

OperatingSystemProcessorCompiler

WindowsNT4.0/2023/XPcompatibletoIntelPentiumMSVisualStudio3

Linux2.2/2.4compatibletoIntelPentiumgcc2.95

Solaris7SPARCCO5.2

IRIX6.5MIPSCC

Tru64UNIX5.1Alphacxx

可执行HALCON的操作系统一览表

请注意在Linux下需要Iibc6(glibc-2.1.x),这是在大部分H勺Linux系统像是RedHat或SuSe

下需要的，请参照有关文献。

HALCON也可以在PhilipsTrlMedlaDSP上执行，土计算机需安装NT/2023/XP,这部分

请参照HALCON/C之User'sManual。

1.3ParallelHALCON简介

简朴的说，原则版於JHALCON是在单处理器的计算机上执行单线程计算，在NT/2023/XP,

Linux,Solaris,HALCON是thread-safe,也就是可以做多绪执行，不过所有H勺运算符执行

时都是独一的J,因此线程间必须要互相等待。

相对来说，ParallelHALCON支持平行运算，是thread-safe以及reentrant,也就是不一样

H勺线程可以同步呼喊同•种运算符，可使用的操作系统包括NT/2023/XP,Linux,

Solarise

除了平行运算外，ParallelHALCON在多处理器的系统上，会自动将运算符作平行化，旧的

HALCON也有此功能，像是HDevelop这个接口，因此您开发的C++,C,不必再做更动。

平行化的机制是将要处理的数据，例如影像，由不一样的处理器上执行不一样的线程（所谓H勺

dataparallelism）,例如一张影像的滤波运算，在一种到处理器的计算机上执行时，计算工作

会被提成四份，由四个线程负货，每个线程都是做相似的滤波计算。由于待处理H勺影像在

系统中不必复制，因此HALCON的这种设计设想可以到达最佳的效率。

至于平行化或数据分派的的程度可以实时掌控，以免导致反效果，例如一张很小时影像，又

要将数据分散处理反而会挥霍时间，此外，不是所有H勺运算符做平行化都能提高效率。

此外，parallelHALCON是用于内存共享的系统中，像是经典口勺多CPU主板，这样不一样

口勺线程才能共享一种HALCON数据库，同步也不必再复制影像而导致占用内存。这样一

来有些系统是不适合执行HALCON的，像是cluster式的I工作站或是某些不提供共享记忆

体的系统。

ParallelHALCON也不提供COM接口，包括平行化机制和reentrant,这是由于撰写COM

日勺重要工具，Microsoft『、JVisjalBasic,尚未有效支持多绪执行之故。

1.4其他数据

下列口勺手册提供了多种参照数据

HDevelopUser'sManual

简介与HALCON关键功能链接的图形顾客接口HDevelopo

HALCON/C++User'sManual

怎样在您写的C++程序中使用HALCONlibrary<.

HALCON/CUser'sManual

怎样在您写的C程序中使用HALCONlibraryo

HALCON/COMUser'sManual

怎样在您写的ICOM程序中使用HALCONlibrary,例如使用VisualBasico

ExtensionPackageProgrammer'sManual

怎样自己设计一种运算符，并将其整合到HALCON中。

FrameGrabberIntegrationProgrammer'sManualo

怎样将一种新的取像设备加入HALCON的系统中。（更

新到8.0后这个手册就没有了,改为imageacquire）

HALCON/HDevelop,HALCON/C++,HALCON/C,HALCON/COM

所有HALCON运算符口勺参照手册。

ApplicationGuide

这是几份各自独立的文献，即所谓的ApplicationNote,是以工业视觉应用的观点来写的，

重要是阐明某些计算方式的关键以及使用时口勺注意事项以及要诀等等。例如以型状导向匹配

来寻找物体等等。

在MVTec的网站上所有H勺参照手册均有PDF槽及HTML文献可如下载，网址为

第二章安装，授权以及设定

在未阐明安装及设定措施前，先来看看不一样版本及授权的有关阐

明

HALCON有三种版本

1.demo版，含HDEvelop以及完整时图像处理功能，不过有某些限制，例如不能连接取像

设备，也少了程序设计界面，这个版本可让您测试HALCON运算符H勺所有功能而无时叵限

制。

2.完整版，让您可以用HALCONH勺功能发展程序。除了HDevelop外，还包括了所有取像功

能，C,C++,COM之接口，尚有ExtensionpackageInterface,让您可以整合自定义的运

算子或是新的取像设备。

3.假如您用HALCON的功能写好程序，您可以得到一种runtimeversion,包括了程序中

需要的功能，这个版本就不包括HDevelop。

使用完整版或runtime版，需要不一样H勺授权码，而demo扳可以不顾客许可证码。授权使

用方式阐明如下

1.Nodelockedlicense用于固定地址H勺计算机或机

器

2.完整版上也可以使用所谓H勺floatinglicense,在局域网络中特定地址日勺机器可以使用，

个licenseserver会检查执行的HALCON程序数量。

至于作为licenseserver的机器并非要真如一般日勺server般庞大，或是一定要是某种server

系统，像是WindowsNTserver,它可以是一台Linux或是Solaris工作站，然后在其他的电

脑安装WindowsNT/2023/XP等以执行HALCON只要在HALCON执行时能和这个server

连接就可以了。

假如是为了估价的目价J,您可以用一种免费H'、Jtemporarylicense。

2.1安装

如二阐明怎样由CD安装HALCON,由网络安装的措施在网址d有阐明。名为

release_note.html的）档案有HALCON於J最新消息。

除了UNIX的系统外，档案途径和环境变量是以Windows式的写法表达，例如

%HALCONROOT%\examples\extension_package\halconuser

请参照2.4节日勺阐明

若是在UNIX系统下，写法就变成

$HALCONROOT/examples/extensionjDackage/halconuser

注意

假如要安装大改版的新版HALCON,例如6.0或6.1版等等，就必须先将旧版卸载，这在

Windows下尤其重要，由于必须要清除旧版在registry欧J纪录。移除措施请看2.2节。有

个例外是ActiveVisionTools1.0到1.3版想安装HALCON6.1版，这时就要保留旧版H勺

HALCON6.0.x“

假如只是小改版的更新，像是601升级成6.0.2版，有个尤其H勺更新措施，在2.1.3节有说

明。

2.1.1在WindowsNT/2023/XP下的安装

将CD置入机器，就会启动一种安装程序，若没有自动执行，可在一种叫nt-x86的I目录下，

执行一种名为Setup.exe日勺程序，当然，您必须要有Administrator日勺权限。首先，程序会

先检查系统资源与否足够安装，再来会检查与否己安装了HALCON,假如已安装了相似的

版本，程序会检查已安装的部分，再让您安装新增长的东西。若是已安装了不一样版本的

HALCON,会问您要不要保留，至于怎样在不一样版本间切换，在2.1.5节有阐明。安装程

序同步也会检查与否有安装ActiveVisionTools,尚有它的版在与否和目前要安装的

HALCON兼容。

（请参照2.1.5节）

这些检查都结束后，安装精灵会要您选择安装版本如下

(Compact,Custom,Typical)FullHALCONversion

(Runtime)runtimeversion

(Demo)demo版的hdevelop_demo.exe

某些额外的东西可后来来再安装，同样将CD置入执行，再选择您要的部分即可。再来，假

如您要用dongle,安装程序会问您与否安装驱动程序，2.3.5节有驱动程序日勺阐明，

以及怎样自行安装而不透过HALCON口勺安装程序。接着，程序会问您这分计算机是不是要

当成floatinglicenseserver,这样会安装名为licensemanagerdaemon,来管理您的J

floatinglicense。floatinglicenseH勺顾客只要在•台计算机上安装这个程序即可当作license

server。请参照2.3.4节。

2.1.2在UNIX下日勺安装

您要先mountCD,例如/cdrom,一般您要有root的I权限才能作这个动作，而在大部分

H勺系统下，CD会被mount成/etc/fstab,不能在此执行程序，因此要改成mount

/deu/cdrom/cdrom

要安装时，启动CD主目录下的shellscripl“insldll-unix“，会问您HALCON要装在哪，接着

环境变量HALCONROOT也要设成安装时目录（参照2.4.2节），再来会问您HALCON日勺附

加部分要装在何处。

由于在CD上是只读的，假如您是以一般使用者来安装，在权限变化时会出现警告讯息，而

某些系统上会出现文献名长度超过32字符的讯息。接着，会检查您的系统与否足够安装，

安装完毕后有几种环境变量要设定，HALCON才能工作。（请参照2.4.2节）

2.1.3更新

HALCON小改版H勺更新有一种尤其H勺措施，例如从6.0或601更新到6.02更新措施请参

考MVTec's时下载区

有关HALCON6.0.2版的尤其阐明

从6.0.2版开始，HALCON要月新的dongle驱动程序（来自GLOBEtrotter）,不过更新措施

中并无解除旧版的驱动程序以及新版H勺安装，因此HALCON会出现"licensenotfound”或类

似的错误讯息，因此您要用2.351节的措施自行将旧时驱动程序移除。

2.1.4HALCON系统里的多种档案以及目录如下阐明了安装目录％HALCONROOT%下的

多种子目录以及档案内容，不过伴随安装选项口勺不一样，有些目录不会出现。

FLEXIm包括检查license的程序

blnHALCON日勺主程序，像是HDevelop,或是DLL槽，framegrabber的|libraries等等c

doc\pdfPDF阐明文献

examples其中H勺子目录包括各类范例，例如

application_guide,配合C,C++,delphi之程序设计,fgjntegration（影像撷取

接口），extension_package,hcevelop之使用，MFC,VB等等之范例。注意，最佳不要

直接使用这些范例，由于在大部分的作业平台下，只有安装者可以修改或储存这些范例，

也不是所有顾客都可以在范例的目录下新增储存东西。因此最佳是自行复制一份到自己H勺

工作目录下。

images多种工作所用的I影像

include给C/C++程序使用H勺header

libHALCON『、Jlibraries,包括和多种取像设备相连接W、J驱动程序。（在Windows下扩展名

为.lib,UNIX下则为.so）

license授权数据文献要放在这

里

2.1.5不一样HALCON版本间的切

换

您可以同步安装不一样版本的HALCON在同一台计算机上。在WindowsNT/2023/XP,

安装时要修改有关的环境变量，像

是%PATH%,%HALCONROOT%,%HALCONIMAGES%，以及自设的像

^%HALCONEXTENSIONS%,这部分请参照2.4.1节。

假如您使用HALCONH勺COM接口，就要对专用H勺DLL槽halconx.dll做re-register,例如，

开一种DOSshell,然后进到bin\i586-nt4目录下（您口勺旧版HALCON）,先做unregister,就

是在命令提醒符号下键入

regsvr32/uhalconx.dll

然后到您的I新版HALCON相对应的R录下，将halconx.dll做register

regsvr32halconx.dll

在UNIX下，要转换不一样於JHALCON版本，则要修改有关环境变量，像是

$HALCONROOT,

$HALCONIMAGES,$PATH,SLD_UBRARY_PATH等等。

2.1.6给ActivVisionTools顾客的信息

ActiveVisionToolsLO到2.0版是以HALCON6.0版（或）为基础的，因此要是装了HALCON

6.1版，将会使得ActivVisionTools无法使用，因此HALCON6.1的安装程序会

检查与否在计算机上已经有安装ActivVisionTools,假如侦测到安装了ActivVisionTools2.0

版，它会提供一种新的，和HALCON6.1版相容的OCXActivVTools.ocXo一般来说这是

您该做日勺选择，您也可以事后手动修正如下，开一种DOSshell,到您安装ActivVisionTools

目录下的Ibi下586-M4目录下,对旧的ocx做unregist,键入

regsvr32/uActivVTools.ocx

然后将其删除，或是更名，换成新If'jocx,这在CD中『、jmisc\i586-nt4\avt20.下可以找到，

然后键入

regsvr32ActivVTools.ocx

即完毕更新

注意，和ActivVisionTools2.0不一样口勺，1.0到1.3版不能和HALCON6.1版一起使用（由于

没有兼容欢Iocx）,假如HALCON6.1版的安装程序发现计算机上安装了ActivVisionTools,

像是

1.3版，它会警告您继续安装会使得现存於JActivVisionTools无法使用，若您还想使用，您就

得保留旧有的HALCON6.0.X同步用2.1.5节的措施来转换版本假如只是要评估试用新版

提议您安装试用版，这样就不必再registerCOM接口口勺libraryhalconx.dlL

2.2卸载

2.2.1WindowsNT/2023/XP

在Windows卜有几种卸载的方式（不过某些旧版H勺HALCON不一定合用）

1.在控制台下，选择新增/移除程序。

2.若您用的是HALCON5.1后来的版本，从开始,程序集>MVTecHALCON>Uninstall

HALCON来卸载。

3.从5.2版起，安装程序会检查机器上与否已经有安装旧版，然后您可以运用安装程序来解

除旧版H勺安装。

这是比很好的措施，这样可以防止途径H勺变量发生问题。

以上是原则的卸载法，假如碰到问题，请参照6.5.2节。注意，卸载会真的删除女装的档

案，不过不会删除顾客设定的数据，也就是registry

中，像是和HDevelop有关时某些自定数据不会被删除，保留在

HKEY_CURRENT_USER>Software>MVTev>HalconTo这里可以自行手动删除，不会出

问题。

卸载也不会移除dongle的驱动程序，要移除的话请参照2.3.5节的阐明。

有关6.0.2版时尤其阐明

从这个版本开始需要一种新时dongle驱动程序，由于卸载不会移除旧有的驱动程序，所以无

法安装6.0.2版所需的新H勺驱动程序，因此在用程序进行卸载旧版H勺HALCON前，要先以

手动移除其驱动程序，请参照节。

2.2.2在UNIX下卸载

只要将HALCON所在的安装目录移除即可

rm-rf$HALCONROOT

再来，移除子目录.hevelop,这是位在环境变量HOME所定义的目录之下（参照242节），

HDevelop是以这个目录来储存窗口位置，选项数据等。卸载不会删除任何顾客自定数据，

因此环境变量也不会变化，要删除或修改时就要自行手动处理。

假如您呼喊了ParallelHALCON6.0betaH勺operatorcheck_par_hw_potential来做初始化动

作，获得H勺资料会存在一.halcon_par_info文献中，置于环境变量HOME所指定H勺目录

下八

2.3授权

HALCON透过FLEXImlicensemanager来确认顾客的授权数据，如下阐明获得授权码

及其安装方式。

要获得授权前，先要获得欲安装HALCON计算机之辨识数据，送至代理商（新亚洲仪器企

业），若使用H勺是runtimelicense,则请告知欲安装的模块。（请参照2.3.2）

在您收到licensefile之后，请参照2.3.2节H勺措施来安装。floatinglicense的使用者请参照

2.3.4节来安装。

2.3.4获得辨识资料

获得辨识数据是由您计算机上安装的网络卡，若您日勺操作系统为NT/2023/XP,处理器为

PentiumIII,则能获得所谓的CPUID。ftWindowsNT/2023/XP下，也可以用一种dongle,

只要有dongle,就可以在其他计算机上执行，这样就不必限定在某台计算机上使用，并且合

用于nodelocked或是floatinglicense之使用者。详细阐明请参照2.3.5节。

用HDevelop获得辨识资料

用demo版的HDevelop来获得辨识数据是最简朴的措施。在主选单Help>About,会出现如

下FJ一种窗II,最底下的数据就是有关您这部计算机的数据，像是网络卡卡号，CPUID,

dongle号码等。

networkcardIDdongleID

CPUID

假如发生问题，既有的设备数据找不到，例如有网络卡而侦测不到，请参照6.5.3来排除问

题。

用Imhostid来获得资料

Imhostid是伴随FLEXImrJ软件，在Windows操作系统下,由DOS下执行,在UNIX系统

中，则要切换目录，5iJ$HALCONROOT/FLEXIm下，再到对应您口勺硬设备口勺目录下(例如

i586-Linux2.2)执行之。

要识别一台计算机的网络卡号，键入Imhostid-

ether

Windows系统下口勺输出画面例子如下

>Imhostid-ether

Imhostid-Copyright(C)1989-2023GlobetrotterSoftware,Inc.

TheFLEXImhostIDofthismachineis"00e02958e36a"

请将ID,就是上面例中的“00e02958e36a”以及计算机的hostname一起送给代理

商。

假如Imhostid回传"ffffffff”，请根据6.531节H勺措施来处理。

要识别CPUID,键入Imhostid-cpu64

>Imhostid-cpu64

Imhostid-Copyright(C)1989-2023GlobetrotterSoftware,Inc.

TheFLEXlmhostIDofthismachineisn0003-ClDE-0IC3-E79F"

假如Imhostid回传”"，则也许是由于在BIOS中CPUID的选项关了，可在重新启动时将其

启动。

要检置dongleID(限于WindowsNT/2023/XP),则键入Imhostld-flexld

会得到如下例之输出

>Imhostid-flexid

Imhastid-Copyright(C)1989-2023GlobetrotterSoftware,Inc.

TheFLEXImhostIDofthismachineis"FLEXID=7-36c79bd7"

注意，此时序号会写入dongle口

2.3.2Runtimelicense和HALCON的模块

HALCON之运算符可分类成不一样口勺模块，像是"Basicoperators"，或是

"Image/Region/XLDmanagement",用于所有HALCON之功能，尤其的I像是"Background

Estimation'*,"1DBarCodeReader"之类也只用于特定白勺程序。使用runtime版时可以只

包括您需要的模块。您的J程序中用到了那些模块，有两种方式来检查。

在HDevelop下执行的程序，可由选单下，File>Moduals,然后会出现一种如下图H勺窗口，

其中就有使用到的模块名称，然后按“Save”，即可将这些纪录存成.mod文献，放在目前的

工作目录下。

由C,C++,COM所写成的应用程序，则需在程序结尾加入运算符get_moduals,

然后将确定需要的模块名称送到代理商。

Backgroundestimation

Optic例characterrecognition

Fourierdescriptors

VMenerfilter

Cameracalibration

Tools

ySystem

Barcodereader

Opticalcharacterverification

CsnceijlSave

图例您使用到的模块

2.3.3女装licensefile

要使用HALCON就要安装licenseGle,这个档案必须放在％HALCONROOT%\license下,

档名需为license.dat,假如是用floatonglicense,您必须将这个档案复制到所有己安装

HALCON的计算机上，包括作为licenseverver的计算机。

如下例子是一种nodelockedlicensefile的内容。

1111Uli1111IL11itItititif11itIt11111111II11111111111111

uHiniITITITJrJiJiIIJiJi1111ITJrJrJr7r7i7i7i7i717!7iri

#MVTec(ID:0080c77161e2)#

“It”ItIt“ItItIt1，」tliltIt"ItItItItIt

FEATUREMVTec.Halconmvtecd6.1permanent0FC17B37961F326F957A8\

VENDORSTR1NG=65535HOSTID=0080c77161e2ck=23

FEATUREMVTec_HDevelopmvtecd6.1permanent0CC279389F3566E1D6363\

VENDORSTRING=65535HOSTID=0080c77161e2ck=32

图例nodelockedlicense,限用于某台计算机

您可以看到，档案中"FEATURE”接着HALCON的版本名称，而license是向下兼容欧J,举

例来说，6.1版於Jlicense亦可以用于6.0版。同步，向上亦可用于小改版的升级，例如6.1

版打勺license可用于6.1.x版。

#############################郴##

#MVTec(ID:FLEXID=7-b285ff7f)#

“L〃〃〃〃JI〃〃“14JI〃〃1n"〃。LJI。

FEATUREMVTcc_Halconmvtecd6.1permanent03C574319AF86C4A5DE4A\

VENDOR_STRING=65535HOSTID=FLEXID=7-b285ff7fck=35

FEATUREMVTcc_HDcvelopmvtecd6.1permanent07C772379E2D066930D10\

VENDOR_STRING=65535HOSTID=FLEXID=7-b285ff7fck=245

图例nodelockeddevelopmentlicense,限用于特定dongle

IL[I，，乜，1II»LIIII,111111IlL乂L//”」/1lll1111I1，L〃11

#MVTec(ID:FLEXID=7-b285fi7D#

11iimi11iiiitiJiiiiiita11iinitaiiiiitnaaiiitaaiiifttaii

•IIIlTIIIIITlHliIIIITr7T7TTTIT777TTTTTTTTTTTTTTTIT7TTTTTTTT^7TTr

FEATUREMVTcc_Halconmvtecd6.1permanent03C574319AF86C4A5DE4A\

VENDOR_STRING=65535HOSTID=FLEXID=7-b285ff7fck=35

图例nodelockedruntimelicense,限用于特定dongle

2.3.4floatinglicense之使用在之前H勺简介中已经有概略R'、j简介，苜先，要有一台计算

机当成licenseverver,安装一种名为

licensemanagerdaemonH勺程序来检查网络中执行HALCON之计算机之数目，再来，

licensefile要copy到所有安装HALCON之计算机，并且也要copy到作为licenseverver的

计算机上(参考)。

接着来看看一种经典的jfloatinglicense，"SERVER"告诉FLEXIm当作licenseserver计算机

口勺名称，这个例子里，就是halconserver<,尚有网络卡号，以及port

number(27000)o

############################

#MVTec(ID:0080c77161e2)#

############################

SERVERhalconserver0080c77161e227000

DAEMONmvtecdC:\Progra~1\MVTec\Halcon\FLEXIm\i586-nt4\mvtecd

FEATUREMVTcc_Halconmvtecd6.1permanent24C72DB2EC0F315624FAE\

VENDOR_STRING=i6383ck=97

图例floatingruntimelicense的内容(限用于某台计算机)

某些状况卜您可会想变化计算机於Jhostname,例如您用的I是dongle-boundlicense,基于某

些需要想把dongle换到网络中另一台计算机上，或是您用限用于某网络卡的license,而

您想把网络卡移到另一台计算机上。

您也也许会需要更改使用的port,例如默认的port已被网络中某软件占用，不过要注意的，

大部分的计算机中，portnumber不不小于1024的，只有特定权限"勺使用者能更改。

当您在网络中任一台计算机执行HALCON时，licensefile中时'SERVER'后接着的数据，诸

如hostname和portnumber等等，是用于让程序寻找联络licenseserver,而在作为

licenseserver的计算机匕portname是作为启动licensemanagerdaemon的根据，因此

在计算机中，所有复制的档案内容必须相似。

在您做为licenseserver的计算机上，也许会需要修改daemon的J目录mvtecd,这目录一般

如下

%HALCONROOT%\FLEXIm\%ARCHITECTURE%\mvtecd

（有关环境变量ARCHITECTURE请看2.4节）

由于licensefile中没有环境变量数据，因此这个目录要自己新增。由于目录字符串中具有空

白字符时会导致HALCON时何题，因此当您将HALCON装在像是c:\program

Files\MVTec\Halcon下时，途径字符串应改为c:\progra~1\MVTec\Halcon。最终一点，

licensemanagerdaemon必须在开机时启动。

在WindowsNT/2023/XP下安装licensemanagerdaemon

在Windows下，可以由安装程序来安装，然后他就会在重新启动后来自动启动，当然您也

可以自行手动安装，这要在DOS下键入（这是一整串指令）

"%HALCONROOT%\FLEXlm\i586-nt4\installs"-n"HALCONLicenses"

-c"%HALCONROOT%\license\license.dat"

-I,,%HALCONROOT%\license\license.log"

-c"%HALCONROOT%\FLEXlm\i586-nt4\lingrd.cxc"

%HALCONROC）T%即是安装的目录，在Windows下，安装好后必须重开机假如安装成功,

一种称为HALCON的service会出目前控制面板下日勺系统管理工具时服务”中出现。

要移除liscensemanagerdaemon,键入如下之指令

"％HALCONROOT%\FLEXIm\i58-nt4\installs”-r-n"HALCONLicenses',

在UNIXF安装licensemanagerdaemon

在UNIX下，这个程序Imgrd必须放在合适口勺启动档中，像是/etc/init.d/boot.local或

/sbn/init.d/boot.locaL诸如此类。这部分请参照您使用H勺操作系统手册。

在这个档案中加入下面一整行（要有Imgrd口勺目录）

/etc/lmgrd-c$HALCONROOT/license/license.dat>$HALCONROOT/license/license.log

2>&1&

注意，Imgrd要由root启动，否则不能正常的作业。

重新启动licensemanagerdaemon

假如您换了一种floatinglicense,就要将daemon重新启动。措施之一是重新启动计算机,

如果您有管理者的J权限，也可以用手动方式新启动。在Windiows下，您只要在系统管理工

具下时服务“中，将"HALCONLicense”这个服务重新启动即可。

在UNIX下，您可以终止Imgrd这个process,然后再重新启动，启动口勺指令就是234.2节

中，加入启动档的那一行。

2.3.5使用dongle

dongle只有在windowsF才能使用，从6.0.2版起，还提供了连接USB日勺dongle。连接印

表机埠的dongle,其ID是以“FLEXID=6」或"FLEXID=7・”开始，而USBdongle的ID是以

"FLEXID=9-"起。

2.3,5.1连接并行端口的dongle

就像2.1.1节所论述时，您可以让HALCON安装驱动程序，要检查安装与否成功，可由装置

管理员来检视与否有一种叫sendnel的设备。

HALCON也有一种辅助程序让您可以自行安装，设定，或是移除驱动程序。进到DOS下，

切换到％HALCONROOT%\FLEXIm\i568-nt4\flexid6-7\win_nt目录下，执行setupx86.exeo

要安装驱动程序，在主选单下选Functions>install,然后重新启动计算机。然后用上述的检

查措施应当可以看到该项设备。要注意啊是，您必须要有Administrator的权限才能安装驱动

程式。假如您没有权限，程序会也安装，并告诉您安装完毕，而实际上无法作用。

要是计算机上有多种parallelport,则还要再调整驱动程序。

HALCONH勺卸载程序并不会移除这个驱动程序（由于其他程序有也许用到），不过却会把这

个安装程序移除，因此假如您要移除这个dongle驱动程序，就要在您将HALCON解除安

装之前完毕。这个安装程序是在CD於JFLEXIm\i586-nt4\flexid6-7\win_nt,有需要时可再叫

用。

有关6.0.2版H勺尤其消息

如同在2.1.3以及2.2.1节所论述口勺注意事项，为防止出问题，提议以如下之程序进行安装。

手动方式解除旧时驱动程序。

用到的程序是setupx86.exe,位于％HALCONROOT%\FLEXIm\i586-nt4\dongle下。

再来就有两个方式可以安装HALCONo

用2.2.1节的措施来移除旧版口勺HALCON,然后将6.0.2版和新口勺驱动程序一起安装。

用2.1.3节的更新措施，也就是手动更新，用到的程序setupx86.exe位在

%HALCONROOT%\FLEXIm\i568-nt4\flexid6-7\win_nt下。

假如您在移除IH版的驱动程序前先移除了旧版日勺HALCO^这个setupx86.exe也会被删除，

不过它是位在CD中FLEXIm\i586-nt4\dongle下，若您没有CD,提议您重新安装旧版的

HALCONo

USBdongle

如同2.1.1节，所需要的驱动程序可在HALCON安装时一起安装，安装与否成功，可由装置

管理员中查看与否有新增如下两项装置Hardlock以及HASP。随者操作系统的不一样，

您也可以用一种HALCON随附的辅助程序来修改，设定，移除驱动程序。切换到DOS

下，切换到目录％HALCONROOT%\FLEXI“i\i586-nl4Vlexid9,有个程序hinslall.exe,有

下列指令可供显示，安装，移除等等。

hinstall显示怎样使用hinstall

hinstall-info显使驱动程序的状态

hinstall-install安装驱动程序

hinstall-remove移除驱动程序

肖然，必须要有Administrator■的权限才能安装。

由于HALCON的卸载程序不会移除dongle的驱动程序，不过会将安装程序hinstall.exe移

除，因此若是要移除这个驱动程序，就要在卸载HALCON前进行。原始的程序在CD中的位

置位于FLEXIm\i586-nt4\flexid9o

2.4设定

HALCON需要设定的东西大部分都是环境变曷，例如放置影像，放置extensionpackage的

目录等等。要使用ParallelHALCON时，每一台分担i-算的计算机上都要做初始化

(initialize),这部分会在5.1.1阐明。

2.4.1WindowsNT/2023/XP下H勺设定。

安装程序Setup.exe执行时会自动设定这些环境变量，像是%HALCONROOT%等，要查看

变量的I内容，可用控制面板下的“系统”中查看，或是修改，新增变量内容。若是变量内容具

有不只一种项目，例如％PATH%也许具有数个目录，此时各个目录间就要以分号”；“区隔

之。此外，要在安装时同步修改建立这些变量，必须要有Administrator的权限。

HALCONROOT

这是最重要的J环境变量，指出了HALCON安装口勺目录。经典的变量内容内容像是

C:\ProgramFiles\MVTec\Halcorio根据这个变量，HALCON得以到如下H勺子目录中寻找资

料。

%HALCONROOT%\help

运算符的数据库位于此处。由HALCON来存取有关运算符的资料。

%HALCONROOT%\doc\html\reference\hdevelop

在线辅助阐明，只要有一种浏览器就可以阅读其内容。

%HALCONROOT%\lut

使用者自定义之look-uptableo

%HALCONROOT%\ocr

寄存了trainedfontso

%HALCONROOT%\license

licenseKEY置于此，也就是license.dat槽。

%HALCONROOT%\images

系统中没有HALCONIMAGES这个变数时，HALCON会到这个目录找寻影像。

HALCONIMAGES

这是告诉系统影像数据寄存的地方，其中可以包括数个目录，不过要记得用分号区隔之。

ARCHITECTURE

HALCON用这个变量来区别操作系统，在Windows下，％ARCHITECTURE%即是设成

i586-nt4o

这个变量同步会在好几种地方出现，像是HALCONH勺程序，hdevelop.exe,halcon.dll等等,

是置于％HALCONROOT%\bin\i586-nt4下，要link程序用的library像是halcon.lib,位在

%HALCONROOT%\lib\i586-nt4下。

HALCONEXTENSIONS

这个变量含的I目录，是顾客自定义的运算符所在位置（所谓的extensionpackages）,每个

package中具有数个运算符，linked到一种共享的library。尚有某些阐明文献，像是运算符

日勺help,以及HTML槽。安装extensionpackage请看2.5节的安装措施。

HALCONSPY

假如在启动HALCON前，系统中已经有HALCONSPY这个变数，那么在HALCON启动

时，一种工具程序HALCONSpy也会启动。由运算符set_spy也可以将其启动（参数为

"mode","on"）,两种启动措施的差异在于，有了

%HALCONSPY%这个变量，就可以监看一种linked好日勺HALCON程序，而不必再去修改。

有关设定请参照6.4节。

PATH

安装时，%HALCONROOT%\bin\i586-nt4»%HALCONROOT%\FLEXIm\i586-nt4会被加到

PATH中。

2.4.2UNIX下口勺设定

在UNIX下，不一样的shells设定环境变量时指令各不相似，例如setenv

<variable><value>,export<variable>=<value>,这部分请参照您的J操作系统阐明。假如变

量内容不只一种项目，请用冒号区隔。

下表列出了HALCONlibrary和HDevelop耍用到H勺环境变量列表。最佳把这些指令加在一

个loginscript或是shellresourcescript中，例如.cshrc或是.profile里。

HALCONROOT

这是最重要的环境变量，指出了HALCON安装H勺目录。经典的变量内容内容像是

/usr/local/halcon^/usr/halcorio根据这个变量，HALCON得以到如下H勺子目录中寻找数捱。

$HALCONROOT\help

运算符日勺数据库位于此处。由HALCON来存取有关运算符的资料。

$HALCONROOT\doc\html\reference\hdevelop

在线辅助阐明，只要有一种浏览器就可以阅读其内容。

$HALCONROOT\lut

使用者自定义之look-uptableo

$HALCONROOT\ocr

寄存了trainedfontSo

$HALCONROOT\license

licenseKEY置于此，也就是license.dat槽。

$HALCONROOT\images

系统中没有HALCONIMAGES这个变数时，HALCON会到这个目录找寻影像。

HALCONIMAGES这是告诉系统影像数据寄存的地方，其中可以包括数个目录，不过要记

得UNIX下要用冒号区隔之。

ARCHITECTURE

这个变量以一种简写表达了所用的处理器以及操作系统版本。例如i586-linux2.2,或是

sparc-sun-solaris7<>ARCHITECTURE会出目前好几种地方，像是程序hdevelop位在

$HALCONROOT/bin/$ARCHITECTUREoffil$HALCONROOT/bin/$ARCHITECTURE力口到

PATH变量中，在使用shellscript时很好用。Sharedlibrary位于

$HALCONROOT/lib/$ARCHITECTURE下。下表为目前支持H勺作业平台以及对应的

ARCHITECTURE内容。

ARCHITECTUREOperatingSystem(Platform)

i586-linux2.2Linux2.2/2.4onIntelPentium(orcompatible)

sparc-sun-solaris7Solaris7onSparcWorkstations

mips-sgi-irix6.5IRIX6.5onSGIWorkstations(Mipsprocessors)

alpha-compaq-osf5.1Tru64UNIX5.15onAlphaprocessors

PATH

假如想要在任一种目录都可以启动HDevelop,就必须将HALCON口勺目录

$HALCONROOT/bin/$ARCHITECTURE力口进环境变量PATH中。

LD_LIBRARY_PATH

请将HALCONlibraryR^$HALCONROOT/lib/$ARCHITECTURE加至U

LD_LIBRARY_PATH这个环境变量之中。设好后来，

HDevelop和开发H勺独立H勺程序才能使用。

HALCONEXTENSIONS

包括某些使用者自定义的I运算符（所谓H勺package）所在的目录，每个package中具有数个运

算子，linked到一种共享口勺library。尚有某些阐明文献，像是运算符代1help,以及HTML

彳常。安装extensionpackage请看2.5节H勺安装措施。详细措施请参照Extensionpackage

Programmer'sManuaL

HALCONSPY

假如在启动HALCON前，系统中已经有HALCONSPY这个变数，那么在HALCON后动

时，一种工具程序HALCONSpy也会启动。由运算符set_spy也可以将其启动（参数为

“mode","on"）,两种启动措施的差异在于，有了$HALCONSPY这个变量，就可以监看一

种linked好口勺HALCON程序，而不必再去修改。有关设定请参照6.4节

DISPLAY

系统以这个变量火显示彻口，和其他的X窗口程序同样。

HOME

在ParallelHALCON6.0beta中，做初始化的运算符check_par_hw_potential会将获得时

主机数据存于$HOME.halcon_par_info0

2.5整合HALCONExtensionPackage

HALCON啊ExtensionPackageInterface可以让您将自行开发日勺计算法和HALCON整合

在一起，成为所谓H勺extensionpackages。目前可以使用的package项目可由HDevelop之

选单Help>HALCONNews(),连结到MVTec口勺网站来获得资料。

2.5.1安装Extensionpackage

先将这些package移到％HALCONROT%目录下，解压缩，再来，将完整的目录

%HALCONROOT%\packages\halconuser加到环境变量HALCONEXTENSONS中。

注意，package的名称，以及其中所含的Jlibrary或DII档的名称都不可以更改。否则会无怯

用使用。