文章目錄

• • 1、名詞解釋
  • 2、例子介紹
  • • • 1、處理原圖與任務(wù)：
      • 2、代碼與解析：
  • 3、Halcon函數(shù)封裝方式
  • • • ①明確需求
      • ②選取函數(shù)部分進(jìn)行函數(shù)創(chuàng)建，更改函數(shù)接口
      • ③運(yùn)行驗(yàn)證與函數(shù)更改操作

有網(wǎng)友說不太清楚這個(gè)halcon函數(shù)的封裝方法。今天寫個(gè)教程帖子，大家一起進(jìn)步分享。

1、名詞解釋

算子：
指Halcon中最基礎(chǔ)、最底層的函數(shù)（即你看不到它的代碼實(shí)現(xiàn)），一個(gè)算子只有一句話，例如threshold算子。

函數(shù)：
由多個(gè)算子組合成的函數(shù)。其特點(diǎn)是，可以通過鼠標(biāo)右鍵單擊“顯示函數(shù)”打開。如下圖：

通常，Halcon代碼程序窗口中，算子和小函數(shù)的代碼顏色是有差異的。如下圖：

2、例子介紹

1、處理原圖與任務(wù)：

要求求亮區(qū)外圓半徑大小。

2、代碼與解析：

* 讀入圖片 read_image (Image, 'C:/Users/Administrator/Desktop/1.jpg') * 根據(jù)圖片打開窗口 dev_open_window_fit_image (Image, 0, 0, -1, -1, WindowHandle) * 顯示圖片，用于預(yù)覽 dev_display (Image)* 二值化 binary_threshold (Image, Region, 'max_separability', 'light', UsedThreshold) * 分割連通域 connection (Region, ConnectedRegions) * 使用特征篩選去掉小面積區(qū)域的干擾 select_shape (ConnectedRegions, SelectedRegions, 'area', 'and', 5000, 1000000000) * 合并區(qū)域，為下一步求取最小外接矩形做準(zhǔn)備 union1 (SelectedRegions, RegionUnion) * 求取最小外接矩形 smallest_circle (RegionUnion, Row, Column, Radius)* 生成一個(gè)圓形，用于顯示 gen_circle (Circle, Row, Column, Radius)*顯示結(jié)果前的準(zhǔn)備 dev_clear_window () dev_set_draw ('margin') dev_set_line_width (3) dev_set_color ('red')* 顯示相關(guān)結(jié)果 dev_display (Image) dev_display (Circle) disp_message (WindowHandle, '圓環(huán)半徑: '+Radius, 'window', 50, 50, 'black', 'true')

3、Halcon函數(shù)封裝方式

Halcon的函數(shù)創(chuàng)建分為以下幾個(gè)步驟：
1、明確需求，要封裝的函數(shù)要實(shí)現(xiàn)什么功能
2、選取函數(shù)部分進(jìn)行函數(shù)創(chuàng)建，更改函數(shù)接口，即更改輸入輸出變量
3、運(yùn)行驗(yàn)證與函數(shù)更改操作

①明確需求

我們拿上邊的這個(gè)程序舉例，我們這個(gè)程序完成的任務(wù)主要是：求取外接圓的半徑并且顯示

我們看代碼一共分為三個(gè)部分：
1.準(zhǔn)備階段：讀入圖片、打開窗口、預(yù)覽等工作。
2.處理階段：進(jìn)行圖像處理，求取結(jié)果
3.顯示階段：對結(jié)果進(jìn)行顯示
如下圖：

明確1：我們需要將第二部分“處理階段的算子封裝成一個(gè)函數(shù)”

此時(shí)我們再看處理階段的代碼，我們由分析可知：
1、此段代碼需要一個(gè)圖片，用于圖像處理
2、需要得出圓環(huán)外接圓這個(gè)結(jié)果（外接圓的位置與半徑）
由此確定：
傳入一個(gè)圖像變量，傳出外接圓的坐標(biāo)（X,Y）與外接圓的半徑
到此需求已經(jīng)明確。

②選取函數(shù)部分進(jìn)行函數(shù)創(chuàng)建，更改函數(shù)接口

選中處理階段函數(shù)，右鍵，點(diǎn)擊“創(chuàng)建新函數(shù)”。如下圖所示：

之后顯示頁面如下：

首先點(diǎn)擊一般設(shè)置欄，編輯函數(shù)名稱（你想把這個(gè)函數(shù)名叫什么就命什么名），再點(diǎn)擊“參數(shù)”。
之后顯示頁面如下：

圖標(biāo)參數(shù)含義：即圖片、區(qū)域、Xld輪廓等圖形變量。
變量參數(shù)含義：指我們在程序中用得到的整形、浮點(diǎn)型、字符串、數(shù)組等變量

我們可以點(diǎn)擊添加變量按鈕進(jìn)行輸入輸出變量的添加操作
如果我們要進(jìn)行刪除變量操作，操作方式如下圖：
首先選中變量，點(diǎn)擊移除

點(diǎn)擊移除后：

也可以通過選中函數(shù)后點(diǎn)擊“上移”、“下移”更改變量順序。

我們由需求分析步驟可知，我們需要：
傳入一個(gè)圖像變量，傳出外接圓的坐標(biāo)（X,Y）與外接圓的半徑
修改參數(shù)頁面變量如下，并點(diǎn)擊一般文檔切換欄目：

一般文檔欄目：（可以對函數(shù)進(jìn)行說明性文檔的編寫）包括了函數(shù)的描述、實(shí)例程序、參數(shù)說明、高級注意事項(xiàng)4個(gè)部分。我們一般不進(jìn)行填寫。

點(diǎn)擊上圖中的參數(shù)文檔：
參數(shù)文檔包含了這個(gè)函數(shù)的詳細(xì)的參數(shù)意義說明：如下圖：

我們?nèi)绻麑⒁话阄臋n和參數(shù)文檔都填完整那么會出現(xiàn)什么情況呢？
你的函數(shù)有了一份像halcon算子一樣的說明文檔：
即選中一個(gè)算子，點(diǎn)擊F1出現(xiàn)的算子幫助文檔！


完成上述所有步驟點(diǎn)擊確定按鈕即可生成函數(shù)

③運(yùn)行驗(yàn)證與函數(shù)更改操作

點(diǎn)擊F5運(yùn)行程序或者點(diǎn)擊F6單步運(yùn)行程序驗(yàn)證程序的準(zhǔn)確性。
當(dāng)F6單步調(diào)試到函數(shù)時(shí)可以點(diǎn)擊F7運(yùn)行到函數(shù)內(nèi)部執(zhí)行。點(diǎn)擊F8跳出函數(shù)執(zhí)行

如果想查看函數(shù)代碼，選中函數(shù)，點(diǎn)擊鼠標(biāo)右鍵，選擇顯示函數(shù)即可查看代碼：

可以點(diǎn)擊紅色方框內(nèi)的后退按鈕退出當(dāng)前函數(shù)顯示
如下圖：
點(diǎn)擊藍(lán)色方框內(nèi)的 按鈕，打開函數(shù)編輯窗口（即上邊我們進(jìn)行函數(shù)名修改、接口參數(shù)變化的窗口）

博主簡介： 工業(yè)自動化上位機(jī)軟件工程師、機(jī)器視覺算法工程師、運(yùn)動控制算法工程師。目前從業(yè)于智能制造自動化行業(yè)。 博主郵箱：2296776525@qq.com

幫忙點(diǎn)個(gè)贊吧。哈哈。

總結(jié)

以上是生活随笔為你收集整理的Halcon自定义函数封装方法(全网最详细)的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。