第一章HALCON

恭喜諸位。您采用了這套在產(chǎn)品研發(fā)，研究以及教育方面均有頂尖體現(xiàn)H勺影像

分析軟件。

HALCON可在UNIX,NT/2023/xp等等平臺(tái)下作業(yè)，它獨(dú)特的Library提供了千余個(gè)為影像

分析作業(yè)，數(shù)據(jù)可視化，除錯(cuò)等等功能所設(shè)計(jì)的運(yùn)算符，顧客可以運(yùn)用它H勺功能以C及C++

等程序語(yǔ)言自行撰寫(xiě)圖像處理程序。

此外，HALCON亦支持WindowsNT/2023/XP下的COM接口，因此您也可以透過(guò)Visual

Basic使用它，使得系統(tǒng)的整合更為輕易。

HALCON的設(shè)計(jì)使得影像區(qū)域，邊緣,以及等值線(xiàn)的J處理上更以便，優(yōu)化H勺算法讓這套軟

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

HALCON包括了名為HDevelop的I程序設(shè)計(jì)界面，減少了設(shè)計(jì)軟件所花H勺時(shí)間，尚有一種好

用的聯(lián)機(jī)協(xié)助，您可以杳到有關(guān)HALCON運(yùn)算符間功能相近的替代者，也許H勺變化，以及

交互的參照。

HALCON從6.0版開(kāi)始提供兩個(gè)版本，除了原則版外，尚有支持平行運(yùn)算的parallel

HALCON,可使用多CPU的機(jī)器，提高指令周期。

如二是HALCON特點(diǎn)時(shí)闡明

1.1

HALCON強(qiáng)化口勺o(hù)preatorlibrary提供有效率乂有彈性的圖像處理功能，簡(jiǎn)化了影像程序

口勺設(shè)計(jì)。

HALCONoperatorlibrary有千余個(gè)運(yùn)算符。所有H勺HALCON應(yīng)用程序（像是HDevelop和

HALCONC++程序）皆是運(yùn)用這個(gè)library來(lái)工作。這些運(yùn)算符功能廣泛，包括了簡(jiǎn)樸的讀取

影像，到復(fù)雜的像是Kalman濾波等。基本上這些運(yùn)算符各有其單一功能，而非包括了多種

運(yùn)算，因此一種影像分析功能是由好幾種運(yùn)算符構(gòu)成的，因此其彈性遠(yuǎn)不小于山少數(shù)而復(fù)雜

H勺運(yùn)算符構(gòu)成的分析程序。特化而復(fù)雜H勺運(yùn)算符往往只合用于某些工作甚至于影像，應(yīng)用范

圍狹窄。相對(duì)于這種窘境，HALCON運(yùn)算符卻能任意組合來(lái)完畢工作。眾多的運(yùn)算符中，

有些是以不一樣的I算法來(lái)到達(dá)相似的功能，例如只需要粗略定位時(shí)，可用fast_match來(lái)作最

快的運(yùn)算，需要精確定位時(shí)，用best_match,以較多H勺時(shí)間來(lái)求得最準(zhǔn)確成果。

HALCON可處理彩色及多頻道影像可用于計(jì)算的影像數(shù)據(jù)，包括二值化影像，單色，彩色，

或是多頻影像，在使用上并無(wú)差異。（多頻道影像是以多鏡頭系統(tǒng)獲得的影像數(shù)據(jù)）。

HALCON提供了迅速有效率的region處理計(jì)算

除了使計(jì)算更輕易外，region尺寸無(wú)限制，甚至于可以重迭，而region數(shù)據(jù)通過(guò)最佳時(shí)編碼

處理，在內(nèi)存中所占的資源很少。

HALCON可做ROI的計(jì)算

每個(gè)影像中的物體都可由顧客自行定義其region,接著再由運(yùn)算符進(jìn)行計(jì)算時(shí)就可以只針

對(duì)定義區(qū)域作處理，因此可以集中運(yùn)算資源和速度，到達(dá)最佳的效率。

HALCON提供了迅速［向pattern兀配計(jì)算

pattern匹配在許多應(yīng)用上是很有用的J,不過(guò)卻很花時(shí)間，HALCON有許多不一樣的pattern

演算法，可以讓您自行決定何時(shí)使用。

HALCON提供了形狀導(dǎo)向（shape-based）的匹配計(jì)算，使得物體有重迭或是旋轉(zhuǎn)雜置的狀況

下仍可計(jì)算。除了pattern匹配外，形狀導(dǎo)向口勺運(yùn)算符可以在物體有縮放，照明變化，旋轉(zhuǎn)

或重迭等等狀況下仍舊能識(shí)別出物體。從6.1版開(kāi)始，尚有一種輔助工具HMatchlt,透過(guò)簡(jiǎn)

易的設(shè)定即可用來(lái)測(cè)試匹配執(zhí)行的I效率，藉由參數(shù)的調(diào)整讓您找出最佳的J設(shè)定值，到達(dá)最快

H勺計(jì)算速度。

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

tuples是一種很有用的功能，使您處理影像，區(qū)域，參數(shù)等等數(shù)據(jù)集合時(shí)更為便利。HALCON

口勺luples可以將有關(guān)數(shù)據(jù)整合成一種對(duì)象，顧客可以針對(duì)單一或多種tuples作處理，您就

不必為一種tuple中有多少元素要處理而煩惱，只要將指定的duple丟給運(yùn)算符，HALCON

就會(huì)處理tuple中所有要計(jì)算的元素。

HALCON在影像和數(shù)據(jù)管理上效率卓著

HALCON有個(gè)迅速有效率H勺內(nèi)存管理關(guān)鍵，這個(gè)機(jī)制提供了數(shù)據(jù)H勺讀寫(xiě)，尚有溢位H勺檢

查。為了提高效率，共享的影像數(shù)據(jù)不會(huì)在內(nèi)存中反復(fù)。

HALCON支持C,C++以及COMP勺程序設(shè)計(jì)

您可以在自己撰寫(xiě)的C,C++和COM程序中使用HALCON運(yùn)算符，完畢一種獨(dú)立的程序。

HALCON的HDevelop工具協(xié)助您發(fā)展影像分析程序

撰寫(xiě)影像分析程序一般是曠日費(fèi)時(shí)，為了協(xié)助設(shè)計(jì)人員找出合適時(shí)運(yùn)算符及參數(shù)，HALCON

發(fā)展出一套工具程序HDevelop。它如協(xié)助您呢？首先HDevelop有一種圖形接口，要使用

口勺運(yùn)算符和要分析的影像一目了然，運(yùn)算符可以自行組合，計(jì)算成果實(shí)時(shí)顯示在影像中，可

以作助使用者理解不一樣運(yùn)算符和參數(shù)對(duì)計(jì)算的影響。同步它也會(huì)提出某些運(yùn)算符或參數(shù)的

建議，在線(xiàn)輔助除理解釋運(yùn)算符怎樣工作外，尚有范例的闡明。當(dāng)您覺(jué)得計(jì)算成果滿(mǎn)意了，

可以把設(shè)計(jì)好的成果存成HDevelop的專(zhuān)用檔案，下次可再叫用，或者是將其輸出成C,C++

或COM口勺程序代碼，可供其他程序套用，就像自行撰寫(xiě)的程序同樣。

HALCON可連接40余種影像擷取設(shè)備

目前支持的I設(shè)備列表在/,要連液取像設(shè)備，只要用運(yùn)算符openjramegrabber,予以格式

或擷取模式等參數(shù)，再來(lái)用運(yùn)算符grabjmage即可獲得影像。

HALCON可以讓您自行新增取像設(shè)備

假加您用的取像設(shè)備HALCON尚未支持，您可以運(yùn)用專(zhuān)用接口連接。HALCON有個(gè)開(kāi)放H勺

接口，配合某些程序代碼，就可以和HALCON連接，有關(guān)的闡明請(qǐng)參照FrameGrabber

IntegrationProgrammer'sManuaL

1.2可執(zhí)行HALCON的操作系統(tǒng)

下表闡明了可執(zhí)行HALCON的操作系統(tǒng)

OperatingSystemProcessorCompiler

WindowsNT4.0/2023/XPcompatibletoIntelPentiumMSVisualStudio3

Linux2.2/2.4compatibletoIntelPentiumgcc2.95

Solaris7SPARCCO5.2

IRIX6.5MIPSCC

Tru64UNIX5.1Alphacxx

可執(zhí)行HALCON的操作系統(tǒng)一覽表

請(qǐng)注意在Linux下需要Iibc6(glibc-2.1.x),這是在大部分H勺Linux系統(tǒng)像是RedHat或SuSe

下需要的，請(qǐng)參照有關(guān)文獻(xiàn)。

HALCON也可以在PhilipsTrlMedlaDSP上執(zhí)行，土計(jì)算機(jī)需安裝NT/2023/XP,這部分

請(qǐng)參照HALCON/C之User'sManual。

1.3ParallelHALCON簡(jiǎn)介

簡(jiǎn)樸的說(shuō)，原則版於JHALCON是在單處理器的計(jì)算機(jī)上執(zhí)行單線(xiàn)程計(jì)算，在NT/2023/XP,

Linux,Solaris,HALCON是thread-safe,也就是可以做多緒執(zhí)行，不過(guò)所有H勺運(yùn)算符執(zhí)行

時(shí)都是獨(dú)一的J,因此線(xiàn)程間必須要互相等待。

相對(duì)來(lái)說(shuō)，ParallelHALCON支持平行運(yùn)算，是thread-safe以及reentrant,也就是不一樣

H勺線(xiàn)程可以同步呼喊同?種運(yùn)算符，可使用的操作系統(tǒng)包括NT/2023/XP,Linux,

Solarise

除了平行運(yùn)算外，ParallelHALCON在多處理器的系統(tǒng)上，會(huì)自動(dòng)將運(yùn)算符作平行化，舊的

HALCON也有此功能，像是HDevelop這個(gè)接口，因此您開(kāi)發(fā)的C++,C,不必再做更動(dòng)。

平行化的機(jī)制是將要處理的數(shù)據(jù)，例如影像，由不一樣的處理器上執(zhí)行不一樣的線(xiàn)程（所謂H勺

dataparallelism）,例如一張影像的濾波運(yùn)算，在一種到處理器的計(jì)算機(jī)上執(zhí)行時(shí)，計(jì)算工作

會(huì)被提成四份，由四個(gè)線(xiàn)程負(fù)貨，每個(gè)線(xiàn)程都是做相似的濾波計(jì)算。由于待處理H勺影像在

系統(tǒng)中不必復(fù)制，因此HALCON的這種設(shè)計(jì)設(shè)想可以到達(dá)最佳的效率。

至于平行化或數(shù)據(jù)分派的的程度可以實(shí)時(shí)掌控，以免導(dǎo)致反效果，例如一張很小時(shí)影像，又

要將數(shù)據(jù)分散處理反而會(huì)揮霍時(shí)間，此外，不是所有H勺運(yùn)算符做平行化都能提高效率。

此外，parallelHALCON是用于內(nèi)存共享的系統(tǒng)中，像是經(jīng)典口勺多CPU主板，這樣不一樣

口勺線(xiàn)程才能共享一種HALCON數(shù)據(jù)庫(kù)，同步也不必再?gòu)?fù)制影像而導(dǎo)致占用內(nèi)存。這樣一

來(lái)有些系統(tǒng)是不適合執(zhí)行HALCON的，像是cluster式的I工作站或是某些不提供共享記憶

體的系統(tǒng)。

ParallelHALCON也不提供COM接口，包括平行化機(jī)制和reentrant,這是由于撰寫(xiě)COM

日勺重要工具，Microsoft『、JVisjalBasic,尚未有效支持多緒執(zhí)行之故。

1.4其他數(shù)據(jù)

下列口勺手冊(cè)提供了多種參照數(shù)據(jù)

HDevelopUser'sManual

簡(jiǎn)介與HALCON關(guān)鍵功能鏈接的圖形顧客接口HDevelopo

HALCON/C++User'sManual

怎樣在您寫(xiě)的C++程序中使用HALCONlibrary<.

HALCON/CUser'sManual

怎樣在您寫(xiě)的C程序中使用HALCONlibraryo

HALCON/COMUser'sManual

怎樣在您寫(xiě)的ICOM程序中使用HALCONlibrary,例如使用VisualBasico

ExtensionPackageProgrammer'sManual

怎樣自己設(shè)計(jì)一種運(yùn)算符，并將其整合到HALCON中。

FrameGrabberIntegrationProgrammer'sManualo

怎樣將一種新的取像設(shè)備加入HALCON的系統(tǒng)中。（更

新到8.0后這個(gè)手冊(cè)就沒(méi)有了,改為imageacquire）

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

所有HALCON運(yùn)算符口勺參照手冊(cè)。

ApplicationGuide

這是幾份各自獨(dú)立的文獻(xiàn)，即所謂的ApplicationNote,是以工業(yè)視覺(jué)應(yīng)用的觀點(diǎn)來(lái)寫(xiě)的，

重要是闡明某些計(jì)算方式的關(guān)鍵以及使用時(shí)口勺注意事項(xiàng)以及要訣等等。例如以型狀導(dǎo)向匹配

來(lái)尋找物體等等。

在MVTec的網(wǎng)站上所有H勺參照手冊(cè)均有PDF槽及HTML文獻(xiàn)可如下載，網(wǎng)址為

第二章安裝，授權(quán)以及設(shè)定

在未闡明安裝及設(shè)定措施前，先來(lái)看看不一樣版本及授權(quán)的有關(guān)闡

明

HALCON有三種版本

1.demo版，含HDEvelop以及完整時(shí)圖像處理功能，不過(guò)有某些限制，例如不能連接取像

設(shè)備，也少了程序設(shè)計(jì)界面，這個(gè)版本可讓您測(cè)試HALCON運(yùn)算符H勺所有功能而無(wú)時(shí)叵限

制。

2.完整版，讓您可以用HALCONH勺功能發(fā)展程序。除了HDevelop外，還包括了所有取像功

能，C,C++,COM之接口，尚有ExtensionpackageInterface,讓您可以整合自定義的運(yùn)

算子或是新的取像設(shè)備。

3.假如您用HALCON的功能寫(xiě)好程序，您可以得到一種runtimeversion,包括了程序中

需要的功能，這個(gè)版本就不包括HDevelop。

使用完整版或runtime版，需要不一樣H勺授權(quán)碼，而demo扳可以不顧客許可證碼。授權(quán)使

用方式闡明如下

1.Nodelockedlicense用于固定地址H勺計(jì)算機(jī)或機(jī)

器

2.完整版上也可以使用所謂H勺floatinglicense,在局域網(wǎng)絡(luò)中特定地址日勺機(jī)器可以使用，

個(gè)licenseserver會(huì)檢查執(zhí)行的HALCON程序數(shù)量。

至于作為licenseserver的機(jī)器并非要真如一般日勺server般龐大，或是一定要是某種server

系統(tǒng)，像是WindowsNTserver,它可以是一臺(tái)Linux或是Solaris工作站，然后在其他的電

腦安裝WindowsNT/2023/XP等以執(zhí)行HALCON只要在HALCON執(zhí)行時(shí)能和這個(gè)server

連接就可以了。

假如是為了估價(jià)的目?jī)r(jià)J,您可以用一種免費(fèi)H'、Jtemporarylicense。

2.1安裝

如二闡明怎樣由CD安裝HALCON,由網(wǎng)絡(luò)安裝的措施在網(wǎng)址d有闡明。名為

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

除了UNIX的系統(tǒng)外，檔案途徑和環(huán)境變量是以Windows式的寫(xiě)法表達(dá)，例如

%HALCONROOT%\examples\extension_package\halconuser

請(qǐng)參照2.4節(jié)日勺闡明

若是在UNIX系統(tǒng)下，寫(xiě)法就變成

$HALCONROOT/examples/extensionjDackage/halconuser

注意

假如要安裝大改版的新版HALCON,例如6.0或6.1版等等，就必須先將舊版卸載，這在

Windows下尤其重要，由于必須要清除舊版在registry歐J紀(jì)錄。移除措施請(qǐng)看2.2節(jié)。有

個(gè)例外是ActiveVisionTools1.0到1.3版想安裝HALCON6.1版，這時(shí)就要保留舊版H勺

HALCON6.0.x“

假如只是小改版的更新，像是601升級(jí)成6.0.2版，有個(gè)尤其H勺更新措施，在2.1.3節(jié)有說(shuō)

明。

2.1.1在WindowsNT/2023/XP下的安裝

將CD置入機(jī)器，就會(huì)啟動(dòng)一種安裝程序，若沒(méi)有自動(dòng)執(zhí)行，可在一種叫nt-x86的I目錄下，

執(zhí)行一種名為Setup.exe日勺程序，當(dāng)然，您必須要有Administrator日勺權(quán)限。首先，程序會(huì)

先檢查系統(tǒng)資源與否足夠安裝，再來(lái)會(huì)檢查與否己安裝了HALCON,假如已安裝了相似的

版本，程序會(huì)檢查已安裝的部分，再讓您安裝新增長(zhǎng)的東西。若是已安裝了不一樣版本的

HALCON,會(huì)問(wèn)您要不要保留，至于怎樣在不一樣版本間切換，在2.1.5節(jié)有闡明。安裝程

序同步也會(huì)檢查與否有安裝ActiveVisionTools,尚有它的版在與否和目前要安裝的

HALCON兼容。

（請(qǐng)參照2.1.5節(jié)）

這些檢查都結(jié)束后，安裝精靈會(huì)要您選擇安裝版本如下

(Compact,Custom,Typical)FullHALCONversion

(Runtime)runtimeversion

(Demo)demo版的hdevelop_demo.exe

某些額外的東西可后來(lái)來(lái)再安裝，同樣將CD置入執(zhí)行，再選擇您要的部分即可。再來(lái)，假

如您要用dongle,安裝程序會(huì)問(wèn)您與否安裝驅(qū)動(dòng)程序，2.3.5節(jié)有驅(qū)動(dòng)程序日勺闡明，

以及怎樣自行安裝而不透過(guò)HALCON口勺安裝程序。接著，程序會(huì)問(wèn)您這分計(jì)算機(jī)是不是要

當(dāng)成floatinglicenseserver,這樣會(huì)安裝名為licensemanagerdaemon,來(lái)管理您的J

floatinglicense。floatinglicenseH勺顧客只要在?臺(tái)計(jì)算機(jī)上安裝這個(gè)程序即可當(dāng)作license

server。請(qǐng)參照2.3.4節(jié)。

2.1.2在UNIX下日勺安裝

您要先mountCD,例如/cdrom,一般您要有root的I權(quán)限才能作這個(gè)動(dòng)作，而在大部分

H勺系統(tǒng)下，CD會(huì)被mount成/etc/fstab,不能在此執(zhí)行程序，因此要改成mount

/deu/cdrom/cdrom

要安裝時(shí)，啟動(dòng)CD主目錄下的shellscripl“insldll-unix“，會(huì)問(wèn)您HALCON要裝在哪，接著

環(huán)境變量HALCONROOT也要設(shè)成安裝時(shí)目錄（參照2.4.2節(jié)），再來(lái)會(huì)問(wèn)您HALCON日勺附

加部分要裝在何處。

由于在CD上是只讀的，假如您是以一般使用者來(lái)安裝，在權(quán)限變化時(shí)會(huì)出現(xiàn)警告訊息，而

某些系統(tǒng)上會(huì)出現(xiàn)文獻(xiàn)名長(zhǎng)度超過(guò)32字符的訊息。接著，會(huì)檢查您的系統(tǒng)與否足夠安裝，

安裝完畢后有幾種環(huán)境變量要設(shè)定，HALCON才能工作。（請(qǐng)參照2.4.2節(jié)）

2.1.3更新

HALCON小改版H勺更新有一種尤其H勺措施，例如從6.0或601更新到6.02更新措施請(qǐng)參

考MVTec's時(shí)下載區(qū)

有關(guān)HALCON6.0.2版的尤其闡明

從6.0.2版開(kāi)始，HALCON要月新的dongle驅(qū)動(dòng)程序（來(lái)自GLOBEtrotter）,不過(guò)更新措施

中并無(wú)解除舊版的驅(qū)動(dòng)程序以及新版H勺安裝，因此HALCON會(huì)出現(xiàn)"licensenotfound”或類(lèi)

似的錯(cuò)誤訊息，因此您要用2.351節(jié)的措施自行將舊時(shí)驅(qū)動(dòng)程序移除。

2.1.4HALCON系統(tǒng)里的多種檔案以及目錄如下闡明了安裝目錄％HALCONROOT%下的

多種子目錄以及檔案內(nèi)容，不過(guò)伴隨安裝選項(xiàng)口勺不一樣，有些目錄不會(huì)出現(xiàn)。

FLEXIm包括檢查license的程序

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

doc\pdfPDF闡明文獻(xiàn)

examples其中H勺子目錄包括各類(lèi)范例，例如

application_guide,配合C,C++,delphi之程序設(shè)計(jì),fgjntegration（影像擷取

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

直接使用這些范例，由于在大部分的作業(yè)平臺(tái)下，只有安裝者可以修改或儲(chǔ)存這些范例，

也不是所有顧客都可以在范例的目錄下新增儲(chǔ)存東西。因此最佳是自行復(fù)制一份到自己H勺

工作目錄下。

images多種工作所用的I影像

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

libHALCON『、Jlibraries,包括和多種取像設(shè)備相連接W、J驅(qū)動(dòng)程序。（在Windows下擴(kuò)展名

為.lib,UNIX下則為.so）

license授權(quán)數(shù)據(jù)文獻(xiàn)要放在這

里

2.1.5不一樣HALCON版本間的切

換

您可以同步安裝不一樣版本的HALCON在同一臺(tái)計(jì)算機(jī)上。在WindowsNT/2023/XP,

安裝時(shí)要修改有關(guān)的環(huán)境變量，像

是%PATH%,%HALCONROOT%,%HALCONIMAGES%，以及自設(shè)的像

^%HALCONEXTENSIONS%,這部分請(qǐng)參照2.4.1節(jié)。

假如您使用HALCONH勺COM接口，就要對(duì)專(zhuān)用H勺DLL槽halconx.dll做re-register,例如，

開(kāi)一種DOSshell,然后進(jìn)到bin\i586-nt4目錄下（您口勺舊版HALCON）,先做unregister,就

是在命令提醒符號(hào)下鍵入

regsvr32/uhalconx.dll

然后到您的I新版HALCON相對(duì)應(yīng)的R錄下，將halconx.dll做register

regsvr32halconx.dll

在UNIX下，要轉(zhuǎn)換不一樣於JHALCON版本，則要修改有關(guān)環(huán)境變量，像是

$HALCONROOT,

$HALCONIMAGES,$PATH,SLD_UBRARY_PATH等等。

2.1.6給ActivVisionTools顧客的信息

ActiveVisionToolsLO到2.0版是以HALCON6.0版（或）為基礎(chǔ)的，因此要是裝了HALCON

6.1版，將會(huì)使得ActivVisionTools無(wú)法使用，因此HALCON6.1的安裝程序會(huì)

檢查與否在計(jì)算機(jī)上已經(jīng)有安裝ActivVisionTools,假如偵測(cè)到安裝了ActivVisionTools2.0

版，它會(huì)提供一種新的，和HALCON6.1版相容的OCXActivVTools.ocXo一般來(lái)說(shuō)這是

您該做日勺選擇，您也可以事后手動(dòng)修正如下，開(kāi)一種DOSshell,到您安裝ActivVisionTools

目錄下的Ibi下586-M4目錄下,對(duì)舊的ocx做unregist,鍵入

regsvr32/uActivVTools.ocx

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

然后鍵入

regsvr32ActivVTools.ocx

即完畢更新

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

沒(méi)有兼容歡Iocx）,假如HALCON6.1版的安裝程序發(fā)現(xiàn)計(jì)算機(jī)上安裝了ActivVisionTools,

像是

1.3版，它會(huì)警告您繼續(xù)安裝會(huì)使得現(xiàn)存於JActivVisionTools無(wú)法使用，若您還想使用，您就

得保留舊有的HALCON6.0.X同步用2.1.5節(jié)的措施來(lái)轉(zhuǎn)換版本假如只是要評(píng)估試用新版

提議您安裝試用版，這樣就不必再registerCOM接口口勺libraryhalconx.dlL

2.2卸載

2.2.1WindowsNT/2023/XP

在Windows卜有幾種卸載的方式（不過(guò)某些舊版H勺HALCON不一定合用）

1.在控制臺(tái)下，選擇新增/移除程序。

2.若您用的是HALCON5.1后來(lái)的版本，從開(kāi)始,程序集>MVTecHALCON>Uninstall

HALCON來(lái)卸載。

3.從5.2版起，安裝程序會(huì)檢查機(jī)器上與否已經(jīng)有安裝舊版，然后您可以運(yùn)用安裝程序來(lái)解

除舊版H勺安裝。

這是比很好的措施，這樣可以防止途徑H勺變量發(fā)生問(wèn)題。

以上是原則的卸載法，假如碰到問(wèn)題，請(qǐng)參照6.5.2節(jié)。注意，卸載會(huì)真的刪除女裝的檔

案，不過(guò)不會(huì)刪除顧客設(shè)定的數(shù)據(jù)，也就是registry

中，像是和HDevelop有關(guān)時(shí)某些自定數(shù)據(jù)不會(huì)被刪除，保留在

HKEY_CURRENT_USER>Software>MVTev>HalconTo這里可以自行手動(dòng)刪除，不會(huì)出

問(wèn)題。

卸載也不會(huì)移除dongle的驅(qū)動(dòng)程序，要移除的話(huà)請(qǐng)參照2.3.5節(jié)的闡明。

有關(guān)6.0.2版時(shí)尤其闡明

從這個(gè)版本開(kāi)始需要一種新時(shí)dongle驅(qū)動(dòng)程序，由于卸載不會(huì)移除舊有的驅(qū)動(dòng)程序，所以無(wú)

法安裝6.0.2版所需的新H勺驅(qū)動(dòng)程序，因此在用程序進(jìn)行卸載舊版H勺HALCON前，要先以

手動(dòng)移除其驅(qū)動(dòng)程序，請(qǐng)參照節(jié)。

2.2.2在UNIX下卸載

只要將HALCON所在的安裝目錄移除即可

rm-rf$HALCONROOT

再來(lái)，移除子目錄.hevelop,這是位在環(huán)境變量HOME所定義的目錄之下（參照242節(jié)），

HDevelop是以這個(gè)目錄來(lái)儲(chǔ)存窗口位置，選項(xiàng)數(shù)據(jù)等。卸載不會(huì)刪除任何顧客自定數(shù)據(jù)，

因此環(huán)境變量也不會(huì)變化，要?jiǎng)h除或修改時(shí)就要自行手動(dòng)處理。

假如您呼喊了ParallelHALCON6.0betaH勺o(hù)peratorcheck_par_hw_potential來(lái)做初始化動(dòng)

作，獲得H勺資料會(huì)存在一.halcon_par_info文獻(xiàn)中，置于環(huán)境變量HOME所指定H勺目錄

下八

2.3授權(quán)

HALCON透過(guò)FLEXImlicensemanager來(lái)確認(rèn)顧客的授權(quán)數(shù)據(jù)，如下闡明獲得授權(quán)碼

及其安裝方式。

要獲得授權(quán)前，先要獲得欲安裝HALCON計(jì)算機(jī)之辨識(shí)數(shù)據(jù)，送至代理商（新亞洲儀器企

業(yè)），若使用H勺是runtimelicense,則請(qǐng)告知欲安裝的模塊。（請(qǐng)參照2.3.2）

在您收到licensefile之后，請(qǐng)參照2.3.2節(jié)H勺措施來(lái)安裝。floatinglicense的使用者請(qǐng)參照

2.3.4節(jié)來(lái)安裝。

2.3.4獲得辨識(shí)資料

獲得辨識(shí)數(shù)據(jù)是由您計(jì)算機(jī)上安裝的網(wǎng)絡(luò)卡，若您日勺操作系統(tǒng)為NT/2023/XP,處理器為

PentiumIII,則能獲得所謂的CPUID。ftWindowsNT/2023/XP下，也可以用一種dongle,

只要有dongle,就可以在其他計(jì)算機(jī)上執(zhí)行，這樣就不必限定在某臺(tái)計(jì)算機(jī)上使用，并且合

用于nodelocked或是floatinglicense之使用者。詳細(xì)闡明請(qǐng)參照2.3.5節(jié)。

用HDevelop獲得辨識(shí)資料

用demo版的HDevelop來(lái)獲得辨識(shí)數(shù)據(jù)是最簡(jiǎn)樸的措施。在主選單Help>About,會(huì)出現(xiàn)如

下FJ一種窗II,最底下的數(shù)據(jù)就是有關(guān)您這部計(jì)算機(jī)的數(shù)據(jù)，像是網(wǎng)絡(luò)卡卡號(hào)，CPUID,

dongle號(hào)碼等。

networkcardIDdongleID

CPUID

假如發(fā)生問(wèn)題，既有的設(shè)備數(shù)據(jù)找不到，例如有網(wǎng)絡(luò)卡而偵測(cè)不到，請(qǐng)參照6.5.3來(lái)排除問(wèn)

題。

用Imhostid來(lái)獲得資料

Imhostid是伴隨FLEXImrJ軟件，在Windows操作系統(tǒng)下,由DOS下執(zhí)行,在UNIX系統(tǒng)

中，則要切換目錄，5iJ$HALCONROOT/FLEXIm下，再到對(duì)應(yīng)您口勺硬設(shè)備口勺目錄下(例如

i586-Linux2.2)執(zhí)行之。

要識(shí)別一臺(tái)計(jì)算機(jī)的網(wǎng)絡(luò)卡號(hào)，鍵入Imhostid-

ether

Windows系統(tǒng)下口勺輸出畫(huà)面例子如下

>Imhostid-ether

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

TheFLEXImhostIDofthismachineis"00e02958e36a"

請(qǐng)將ID,就是上面例中的“00e02958e36a”以及計(jì)算機(jī)的hostname一起送給代理

商。

假如Imhostid回傳"ffffffff”，請(qǐng)根據(jù)6.531節(jié)H勺措施來(lái)處理。

要識(shí)別CPUID,鍵入Imhostid-cpu64

>Imhostid-cpu64

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

TheFLEXlmhostIDofthismachineisn0003-ClDE-0IC3-E79F"

假如Imhostid回傳”"，則也許是由于在BIOS中CPUID的選項(xiàng)關(guān)了，可在重新啟動(dòng)時(shí)將其

啟動(dòng)。

要檢置dongleID(限于WindowsNT/2023/XP),則鍵入Imhostld-flexld

會(huì)得到如下例之輸出

>Imhostid-flexid

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

TheFLEXImhostIDofthismachineis"FLEXID=7-36c79bd7"

注意，此時(shí)序號(hào)會(huì)寫(xiě)入dongle口

2.3.2Runtimelicense和HALCON的模塊

HALCON之運(yùn)算符可分類(lèi)成不一樣口勺模塊，像是"Basicoperators"，或是

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

Estimation'*,"1DBarCodeReader"之類(lèi)也只用于特定白勺程序。使用runtime版時(shí)可以只

包括您需要的模塊。您的J程序中用到了那些模塊，有兩種方式來(lái)檢查。

在HDevelop下執(zhí)行的程序，可由選單下，F(xiàn)ile>Moduals,然后會(huì)出現(xiàn)一種如下圖H勺窗口，

其中就有使用到的模塊名稱(chēng)，然后按“Save”，即可將這些紀(jì)錄存成.mod文獻(xiàn)，放在目前的

工作目錄下。

由C,C++,COM所寫(xiě)成的應(yīng)用程序，則需在程序結(jié)尾加入運(yùn)算符get_moduals,

然后將確定需要的模塊名稱(chēng)送到代理商。

Backgroundestimation

Optic例characterrecognition

Fourierdescriptors

VMenerfilter

Cameracalibration

Tools

ySystem

Barcodereader

Opticalcharacterverification

CsnceijlSave

圖例您使用到的模塊

2.3.3女裝licensefile

要使用HALCON就要安裝licenseGle,這個(gè)檔案必須放在％HALCONROOT%\license下,

檔名需為license.dat,假如是用floatonglicense,您必須將這個(gè)檔案復(fù)制到所有己安裝

HALCON的計(jì)算機(jī)上，包括作為licenseverver的計(jì)算機(jī)。

如下例子是一種nodelockedlicensefile的內(nèi)容。

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,限用于某臺(tái)計(jì)算機(jī)

您可以看到，檔案中"FEATURE”接著HALCON的版本名稱(chēng)，而license是向下兼容歐J,舉

例來(lái)說(shuō)，6.1版於Jlicense亦可以用于6.0版。同步，向上亦可用于小改版的升級(jí)，例如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勺簡(jiǎn)介中已經(jīng)有概略R'、j簡(jiǎn)介，苜先，要有一臺(tái)計(jì)算

機(jī)當(dāng)成licenseverver,安裝一種名為

licensemanagerdaemonH勺程序來(lái)檢查網(wǎng)絡(luò)中執(zhí)行HALCON之計(jì)算機(jī)之?dāng)?shù)目，再來(lái)，

licensefile要copy到所有安裝HALCON之計(jì)算機(jī)，并且也要copy到作為licenseverver的

計(jì)算機(jī)上(參考)。

接著來(lái)看看一種經(jīng)典的jfloatinglicense，"SERVER"告訴FLEXIm當(dāng)作licenseserver計(jì)算機(jī)

口勺名稱(chēng)，這個(gè)例子里，就是halconserver<,尚有網(wǎng)絡(luò)卡號(hào)，以及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的內(nèi)容(限用于某臺(tái)計(jì)算機(jī))

某些狀況卜您可會(huì)想變化計(jì)算機(jī)於Jhostname,例如您用的I是dongle-boundlicense,基于某

些需要想把dongle換到網(wǎng)絡(luò)中另一臺(tái)計(jì)算機(jī)上，或是您用限用于某網(wǎng)絡(luò)卡的license,而

您想把網(wǎng)絡(luò)卡移到另一臺(tái)計(jì)算機(jī)上。

您也也許會(huì)需要更改使用的port,例如默認(rèn)的port已被網(wǎng)絡(luò)中某軟件占用，不過(guò)要注意的，

大部分的計(jì)算機(jī)中，portnumber不不小于1024的，只有特定權(quán)限"勺使用者能更改。

當(dāng)您在網(wǎng)絡(luò)中任一臺(tái)計(jì)算機(jī)執(zhí)行HALCON時(shí)，licensefile中時(shí)'SERVER'后接著的數(shù)據(jù)，諸

如hostname和portnumber等等，是用于讓程序?qū)ふ衣?lián)絡(luò)licenseserver,而在作為

licenseserver的計(jì)算機(jī)匕portname是作為啟動(dòng)licensemanagerdaemon的根據(jù)，因此

在計(jì)算機(jī)中，所有復(fù)制的檔案內(nèi)容必須相似。

在您做為licenseserver的計(jì)算機(jī)上，也許會(huì)需要修改daemon的J目錄mvtecd,這目錄一般

如下

%HALCONROOT%\FLEXIm\%ARCHITECTURE%\mvtecd

（有關(guān)環(huán)境變量ARCHITECTURE請(qǐng)看2.4節(jié)）

由于licensefile中沒(méi)有環(huán)境變量數(shù)據(jù)，因此這個(gè)目錄要自己新增。由于目錄字符串中具有空

白字符時(shí)會(huì)導(dǎo)致HALCON時(shí)何題，因此當(dāng)您將HALCON裝在像是c:\program

Files\MVTec\Halcon下時(shí)，途徑字符串應(yīng)改為c:\progra~1\MVTec\Halcon。最終一點(diǎn)，

licensemanagerdaemon必須在開(kāi)機(jī)時(shí)啟動(dòng)。

在WindowsNT/2023/XP下安裝licensemanagerdaemon

在Windows下，可以由安裝程序來(lái)安裝，然后他就會(huì)在重新啟動(dòng)后來(lái)自動(dòng)啟動(dòng)，當(dāng)然您也

可以自行手動(dòng)安裝，這要在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下，安裝好后必須重開(kāi)機(jī)假如安裝成功,

一種稱(chēng)為HALCON的service會(huì)出目前控制面板下日勺系統(tǒng)管理工具時(shí)服務(wù)”中出現(xiàn)。

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

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

在UNIXF安裝licensemanagerdaemon

在UNIX下，這個(gè)程序Imgrd必須放在合適口勺啟動(dòng)檔中，像是/etc/init.d/boot.local或

/sbn/init.d/boot.locaL諸如此類(lèi)。這部分請(qǐng)參照您使用H勺操作系統(tǒng)手冊(cè)。

在這個(gè)檔案中加入下面一整行（要有Imgrd口勺目錄）

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

2>&1&

注意，Imgrd要由root啟動(dòng)，否則不能正常的作業(yè)。

重新啟動(dòng)licensemanagerdaemon

假如您換了一種floatinglicense,就要將daemon重新啟動(dòng)。措施之一是重新啟動(dòng)計(jì)算機(jī),

如果您有管理者的J權(quán)限，也可以用手動(dòng)方式新啟動(dòng)。在Windiows下，您只要在系統(tǒng)管理工

具下時(shí)服務(wù)“中，將"HALCONLicense”這個(gè)服務(wù)重新啟動(dòng)即可。

在UNIX下，您可以終止Imgrd這個(gè)process,然后再重新啟動(dòng)，啟動(dòng)口勺指令就是234.2節(jié)

中，加入啟動(dòng)檔的那一行。

2.3.5使用dongle

dongle只有在windowsF才能使用，從6.0.2版起，還提供了連接USB日勺dongle。連接印

表機(jī)埠的dongle,其ID是以“FLEXID=6」或"FLEXID=7?”開(kāi)始，而USBdongle的ID是以

"FLEXID=9-"起。

2.3,5.1連接并行端口的dongle

就像2.1.1節(jié)所論述時(shí)，您可以讓HALCON安裝驅(qū)動(dòng)程序，要檢查安裝與否成功，可由裝置

管理員來(lái)檢視與否有一種叫sendnel的設(shè)備。

HALCON也有一種輔助程序讓您可以自行安裝，設(shè)定，或是移除驅(qū)動(dòng)程序。進(jìn)到DOS下，

切換到％HALCONROOT%\FLEXIm\i568-nt4\flexid6-7\win_nt目錄下，執(zhí)行setupx86.exeo

要安裝驅(qū)動(dòng)程序，在主選單下選Functions>install,然后重新啟動(dòng)計(jì)算機(jī)。然后用上述的檢

查措施應(yīng)當(dāng)可以看到該項(xiàng)設(shè)備。要注意啊是，您必須要有Administrator的權(quán)限才能安裝驅(qū)動(dòng)

程式。假如您沒(méi)有權(quán)限，程序會(huì)也安裝，并告訴您安裝完畢，而實(shí)際上無(wú)法作用。

要是計(jì)算機(jī)上有多種parallelport,則還要再調(diào)整驅(qū)動(dòng)程序。

HALCONH勺卸載程序并不會(huì)移除這個(gè)驅(qū)動(dòng)程序（由于其他程序有也許用到），不過(guò)卻會(huì)把這

個(gè)安裝程序移除，因此假如您要移除這個(gè)dongle驅(qū)動(dòng)程序，就要在您將HALCON解除安

裝之前完畢。這個(gè)安裝程序是在CD於JFLEXIm\i586-nt4\flexid6-7\win_nt,有需要時(shí)可再叫

用。

有關(guān)6.0.2版H勺尤其消息

如同在2.1.3以及2.2.1節(jié)所論述口勺注意事項(xiàng)，為防止出問(wèn)題，提議以如下之程序進(jìn)行安裝。

手動(dòng)方式解除舊時(shí)驅(qū)動(dòng)程序。

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

再來(lái)就有兩個(gè)方式可以安裝HALCONo

用2.2.1節(jié)的措施來(lái)移除舊版口勺HALCON,然后將6.0.2版和新口勺驅(qū)動(dòng)程序一起安裝。

用2.1.3節(jié)的更新措施，也就是手動(dòng)更新，用到的程序setupx86.exe位在

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

假如您在移除IH版的驅(qū)動(dòng)程序前先移除了舊版日勺HALCO^這個(gè)setupx86.exe也會(huì)被刪除，

不過(guò)它是位在CD中FLEXIm\i586-nt4\dongle下，若您沒(méi)有CD,提議您重新安裝舊版的

HALCONo

USBdongle

如同2.1.1節(jié)，所需要的驅(qū)動(dòng)程序可在HALCON安裝時(shí)一起安裝，安裝與否成功，可由裝置

管理員中查看與否有新增如下兩項(xiàng)裝置Hardlock以及HASP。隨者操作系統(tǒng)的不一樣，

您也可以用一種HALCON隨附的輔助程序來(lái)修改，設(shè)定，移除驅(qū)動(dòng)程序。切換到DOS

下，切換到目錄％HALCONROOT%\FLEXI“i\i586-nl4Vlexid9,有個(gè)程序hinslall.exe,有

下列指令可供顯示，安裝，移除等等。

hinstall顯示怎樣使用hinstall

hinstall-info顯使驅(qū)動(dòng)程序的狀態(tài)

hinstall-install安裝驅(qū)動(dòng)程序

hinstall-remove移除驅(qū)動(dòng)程序

肖然，必須要有Administrator■的權(quán)限才能安裝。

由于HALCON的卸載程序不會(huì)移除dongle的驅(qū)動(dòng)程序，不過(guò)會(huì)將安裝程序hinstall.exe移

除，因此若是要移除這個(gè)驅(qū)動(dòng)程序，就要在卸載HALCON前進(jìn)行。原始的程序在CD中的位

置位于FLEXIm\i586-nt4\flexid9o

2.4設(shè)定

HALCON需要設(shè)定的東西大部分都是環(huán)境變曷，例如放置影像，放置extensionpackage的

目錄等等。要使用ParallelHALCON時(shí)，每一臺(tái)分擔(dān)i-算的計(jì)算機(jī)上都要做初始化

(initialize),這部分會(huì)在5.1.1闡明。

2.4.1WindowsNT/2023/XP下H勺設(shè)定。

安裝程序Setup.exe執(zhí)行時(shí)會(huì)自動(dòng)設(shè)定這些環(huán)境變量，像是%HALCONROOT%等，要查看

變量的I內(nèi)容，可用控制面板下的“系統(tǒng)”中查看，或是修改，新增變量?jī)?nèi)容。若是變量?jī)?nèi)容具

有不只一種項(xiàng)目，例如％PATH%也許具有數(shù)個(gè)目錄，此時(shí)各個(gè)目錄間就要以分號(hào)”；“區(qū)隔

之。此外，要在安裝時(shí)同步修改建立這些變量，必須要有Administrator的權(quán)限。

HALCONROOT

這是最重要的J環(huán)境變量，指出了HALCON安裝口勺目錄。經(jīng)典的變量?jī)?nèi)容內(nèi)容像是

C:\ProgramFiles\MVTec\Halcorio根據(jù)這個(gè)變量，HALCON得以到如下H勺子目錄中尋找資

料。

%HALCONROOT%\help

運(yùn)算符的數(shù)據(jù)庫(kù)位于此處。由HALCON來(lái)存取有關(guān)運(yùn)算符的資料。

%HALCONROOT%\doc\html\reference\hdevelop

在線(xiàn)輔助闡明，只要有一種瀏覽器就可以閱讀其內(nèi)容。

%HALCONROOT%\lut

使用者自定義之look-uptableo

%HALCONROOT%\ocr

寄存了trainedfontso

%HALCONROOT%\license

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

%HALCONROOT%\images

系統(tǒng)中沒(méi)有HALCONIMAGES這個(gè)變數(shù)時(shí)，HALCON會(huì)到這個(gè)目錄找尋影像。

HALCONIMAGES

這是告訴系統(tǒng)影像數(shù)據(jù)寄存的地方，其中可以包括數(shù)個(gè)目錄，不過(guò)要記得用分號(hào)區(qū)隔之。

ARCHITECTURE

HALCON用這個(gè)變量來(lái)區(qū)別操作系統(tǒng)，在Windows下，％ARCHITECTURE%即是設(shè)成

i586-nt4o

這個(gè)變量同步會(huì)在好幾種地方出現(xiàn)，像是HALCONH勺程序，hdevelop.exe,halcon.dll等等,

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

%HALCONROOT%\lib\i586-nt4下。

HALCONEXTENSIONS

這個(gè)變量含的I目錄，是顧客自定義的運(yùn)算符所在位置（所謂的extensionpackages）,每個(gè)

package中具有數(shù)個(gè)運(yùn)算符，linked到一種共享的library。尚有某些闡明文獻(xiàn)，像是運(yùn)算符

日勺help,以及HTML槽。安裝extensionpackage請(qǐng)看2.5節(jié)的安裝措施。

HALCONSPY

假如在啟動(dòng)HALCON前，系統(tǒng)中已經(jīng)有HALCONSPY這個(gè)變數(shù)，那么在HALCON啟動(dòng)

時(shí)，一種工具程序HALCONSpy也會(huì)啟動(dòng)。由運(yùn)算符set_spy也可以將其啟動(dòng)（參數(shù)為

"mode","on"）,兩種啟動(dòng)措施的差異在于，有了

%HALCONSPY%這個(gè)變量，就可以監(jiān)看一種linked好日勺HALCON程序，而不必再去修改。

有關(guān)設(shè)定請(qǐng)參照6.4節(jié)。

PATH

安裝時(shí)，%HALCONROOT%\bin\i586-nt4?%HALCONROOT%\FLEXIm\i586-nt4會(huì)被加到

PATH中。

2.4.2UNIX下口勺設(shè)定

在UNIX下，不一樣的shells設(shè)定環(huán)境變量時(shí)指令各不相似，例如setenv

<variable><value>,export<variable>=<value>,這部分請(qǐng)參照您的J操作系統(tǒng)闡明。假如變

量?jī)?nèi)容不只一種項(xiàng)目，請(qǐng)用冒號(hào)區(qū)隔。

下表列出了HALCONlibrary和HDevelop耍用到H勺環(huán)境變量列表。最佳把這些指令加在一

個(gè)loginscript或是shellresourcescript中，例如.cshrc或是.profile里。

HALCONROOT

這是最重要的環(huán)境變量，指出了HALCON安裝H勺目錄。經(jīng)典的變量?jī)?nèi)容內(nèi)容像是

/usr/local/halcon^/usr/halcorio根據(jù)這個(gè)變量，HALCON得以到如下H勺子目錄中尋找數(shù)捱。

$HALCONROOT\help

運(yùn)算符日勺數(shù)據(jù)庫(kù)位于此處。由HALCON來(lái)存取有關(guān)運(yùn)算符的資料。

$HALCONROOT\doc\html\reference\hdevelop

在線(xiàn)輔助闡明，只要有一種瀏覽器就可以閱讀其內(nèi)容。

$HALCONROOT\lut

使用者自定義之look-uptableo

$HALCONROOT\ocr

寄存了trainedfontSo

$HALCONROOT\license

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

$HALCONROOT\images

系統(tǒng)中沒(méi)有HALCONIMAGES這個(gè)變數(shù)時(shí)，HALCON會(huì)到這個(gè)目錄找尋影像。

HALCONIMAGES這是告訴系統(tǒng)影像數(shù)據(jù)寄存的地方，其中可以包括數(shù)個(gè)目錄，不過(guò)要記

得UNIX下要用冒號(hào)區(qū)隔之。

ARCHITECTURE

這個(gè)變量以一種簡(jiǎn)寫(xiě)表達(dá)了所用的處理器以及操作系統(tǒng)版本。例如i586-linux2.2,或是

sparc-sun-solaris7<>ARCHITECTURE會(huì)出目前好幾種地方，像是程序hdevelop位在

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

PATH變量中，在使用shellscript時(shí)很好用。Sharedlibrary位于

$HALCONROOT/lib/$ARCHITECTURE下。下表為目前支持H勺作業(yè)平臺(tái)以及對(duì)應(yīng)的

ARCHITECTURE內(nèi)容。

ARCHITECTUREOperatingSystem(Platform)

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

sparc-sun-solaris7Solaris7onSparcWorkstations

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

alpha-compaq-osf5.1Tru64UNIX5.15onAlphaprocessors

PATH

假如想要在任一種目錄都可以啟動(dòng)HDevelop,就必須將HALCON口勺目錄

$HALCONROOT/bin/$ARCHITECTURE力口進(jìn)環(huán)境變量PATH中。

LD_LIBRARY_PATH

請(qǐng)將HALCONlibraryR^$HALCONROOT/lib/$ARCHITECTURE加至U

LD_LIBRARY_PATH這個(gè)環(huán)境變量之中。設(shè)好后來(lái)，

HDevelop和開(kāi)發(fā)H勺獨(dú)立H勺程序才能使用。

HALCONEXTENSIONS

包括某些使用者自定義的I運(yùn)算符（所謂H勺package）所在的目錄，每個(gè)package中具有數(shù)個(gè)運(yùn)

算子，linked到一種共享口勺library。尚有某些闡明文獻(xiàn)，像是運(yùn)算符代1help,以及HTML

彳常。安裝extensionpackage請(qǐng)看2.5節(jié)H勺安裝措施。詳細(xì)措施請(qǐng)參照Extensionpackage

Programmer'sManuaL

HALCONSPY

假如在啟動(dòng)HALCON前，系統(tǒng)中已經(jīng)有HALCONSPY這個(gè)變數(shù)，那么在HALCON后動(dòng)

時(shí)，一種工具程序HALCONSpy也會(huì)啟動(dòng)。由運(yùn)算符set_spy也可以將其啟動(dòng)（參數(shù)為

“mode","on"）,兩種啟動(dòng)措施的差異在于，有了$HALCONSPY這個(gè)變量，就可以監(jiān)看一

種linked好口勺HALCON程序，而不必再去修改。有關(guān)設(shè)定請(qǐng)參照6.4節(jié)

DISPLAY

系統(tǒng)以這個(gè)變量火顯示徹口，和其他的X窗口程序同樣。

HOME

在ParallelHALCON6.0beta中，做初始化的運(yùn)算符check_par_hw_potential會(huì)將獲得時(shí)

主機(jī)數(shù)據(jù)存于$HOME.halcon_par_info0

2.5整合HALCONExtensionPackage

HALCON啊ExtensionPackageInterface可以讓您將自行開(kāi)發(fā)日勺計(jì)算法和HALCON整合

在一起，成為所謂H勺extensionpackages。目前可以使用的package項(xiàng)目可由HDevelop之

選單Help>HALCONNews(),連結(jié)到MVTec口勺網(wǎng)站來(lái)獲得資料。

2.5.1安裝Extensionpackage

先將這些package移到％HALCONROT%目錄下，解壓縮，再來(lái)，將完整的目錄

%HALCONROOT%\packages\halconuser加到環(huán)境變量HALCONEXTENSONS中。

注意，package的名稱(chēng)，以及其中所含的Jlibrary或DII檔的名稱(chēng)都不可以更改。否則會(huì)無(wú)怯

用使用。