簡介面向機(jī)器視覺初學(xué)者與C桌面開發(fā)者的halconmfc模板匹配demo聚焦在Windows界面中完成基于形狀、形狀縮放與灰度的模板匹配驗(yàn)證。工程把Halcon圖像處理能力嵌入MFC對(duì)話框提供圖像加載、匹配模式選擇、參數(shù)設(shè)置、執(zhí)行匹配及位置與相似度結(jié)果展示等交互適合學(xué)習(xí)工業(yè)視覺定位、目標(biāo)識(shí)別與GUI集成的基礎(chǔ)流程。壓縮包共27個(gè)文件以8個(gè)h和6個(gè)cpp源碼為主配合ico、rc等界面資源vcxproj、sln等VS工程配置以及jpg預(yù)覽圖、exe可執(zhí)行程序和說明文檔rar整體約11.45MB。從目錄模塊看參數(shù)設(shè)置、形狀操作、結(jié)果封裝與主對(duì)話框邏輯劃分較清晰便于對(duì)照編譯、調(diào)試和二次修改。已有1246人學(xué)習(xí)可作為Halcon與MFC聯(lián)合開發(fā)模板匹配功能的入門參考。1. 一個(gè)能雙擊運(yùn)行的 exe這個(gè) HalconMFC 模板匹配 demo 到底解決什么問題某五金件產(chǎn)線上工件在傳送帶上隨機(jī)偏轉(zhuǎn)角度大概在正負(fù)十五度之間晃機(jī)械手要過去抓。算法同事在 HDevelop 里半小時(shí)就調(diào)通了create_shape_model建模板、find_shape_model拿 Row/Column/Angle 一氣呵成?？烧嬉桓兜焦の徊僮鞴げ豢赡艽蜷_ HDevelop 點(diǎn)運(yùn)行。問題于是從“怎么匹配”變成“怎么把匹配包成一個(gè)能雙擊的 exe”——這正是 Halcon MFC 模板匹配 demo 的位置。它做的事很具體把形狀匹配的建模、查找、結(jié)果顯示、參數(shù)調(diào)節(jié)塞進(jìn)一個(gè) MFC 對(duì)話框程序里對(duì)外輸出一個(gè)四元組Row、Column、Angle、Score再把匹配到的輪廓疊畫在圖上。適合做課設(shè)畢設(shè)的、剛從腳本過渡到上位機(jī)的、以及要給現(xiàn)場交付獨(dú)立程序的人如果你只做純算法研究或者習(xí)慣 Python 調(diào)庫這套東西對(duì)你價(jià)值不大。2. 工程骨架把 Halcon 算子塞進(jìn) MFC 的三條路與一次編譯配置2.1 HDevEngine、導(dǎo)出 C、混合調(diào)用先選一條這一步選錯(cuò)了后面全是返工。三種接法我都在項(xiàng)目里用過差別不在性能在“誰改算法”這件事上。接法做法優(yōu)點(diǎn)代價(jià)適合HDevEngine運(yùn)行時(shí)加載 .hdev用HDevEngine執(zhí)行過程算法同事改腳本不用重編 exe多帶一個(gè)引擎 dll報(bào)錯(cuò)是腳本行號(hào)每次調(diào)用有解析開銷算法還在頻繁迭代、現(xiàn)場要臨時(shí)調(diào)參導(dǎo)出 CHDevelop 里“文件→導(dǎo)出 C”生成 .cpp執(zhí)行最快無額外依賴改一行腳本就要重新編譯整個(gè)工程算法已經(jīng)凍結(jié)、追求穩(wěn)定交付混合建模和調(diào)參走腳本查找和結(jié)果顯示走 C兼顧兩邊接口要自己設(shè)計(jì)狀態(tài)要管好我一般會(huì)選這個(gè)Demo 這種體量直接導(dǎo)出 C 最省事因?yàn)槟０迤ヅ涞恼{(diào)用鏈很短沒必要為它背一個(gè)腳本引擎。但如果你要做“現(xiàn)場工程師拿著 hdev 自己調(diào)對(duì)比度”的功能那就得走 HDevEngine并且把腳本里的過程名、輸入輸出參數(shù)用SetProcedure、SetInputIconicParamObject這類接口約定死否則腳本一改接口exe 直接報(bào)找不到過程。2.2 VS 工程配置位數(shù)、運(yùn)行時(shí)庫、頭文件順序Halcon 的庫和你的工程必須位數(shù)一致這一條沒有例外。新版本基本只提供 64 位所以 MFC 工程從新建那一刻就該選 x64別等編譯報(bào)一堆LNK2019再回頭改。屬性頁里要落的東西位置項(xiàng)值C/C → 常規(guī)附加包含目錄$(HALCONROOT)\include、$(HALCONROOT)\include\halconcpp鏈接器 → 常規(guī)附加庫目錄$(HALCONROOT)\lib\$(HALCONARCH)鏈接器 → 輸入附加依賴項(xiàng)halconcpp.libC/C → 代碼生成運(yùn)行時(shí)庫與 Halcon 保持一致一般/MDRelease、/MDdDebugMFC 使用方式—在共享 DLL 中使用 MFCHALCONROOT和HALCONARCH這兩個(gè)環(huán)境變量是安裝時(shí)寫進(jìn)系統(tǒng)的用$(HALCONROOT)引用比自己寫死路徑靠譜換機(jī)器不用改工程。頭文件包含順序上有一個(gè)老坑windows.h里的min/max宏會(huì)和標(biāo)準(zhǔn)庫打架而 MFC 又必然帶進(jìn)windows.h// pch.h或 stdafx.h里包含順序不要隨意調(diào)換 #define NOMINMAX // 擋掉 windows.h 的 min/max 宏 #include windows.h #include atlconv.h // 后面要用 CT2A 做編碼轉(zhuǎn)換 #include halconcpp/HalconCpp.h // 放在 windows.h 之后避免類型重定義 using namespace HalconCpp; // 只在 cpp 里用別寫進(jìn)頭文件污染全局NOMINMAX不加std::min之類的調(diào)用會(huì)莫名其妙編譯不過using namespace寫進(jìn)頭文件則會(huì)讓所有包含它的 cpp 都被拖進(jìn) Halcon 的命名空間后面和 MFC 的CRect、CPoint撞名是遲早的事。部署時(shí)別忘了把運(yùn)行時(shí) dll 拷到 exe 同級(jí)目錄halcon.dll、halconcpp.dll是必須的走 HDevEngine 還要加引擎那個(gè) dll。我在項(xiàng)目里放了個(gè)拷貝腳本打包前一鍵執(zhí)行# 打包前把運(yùn)行時(shí) dll 拉到輸出目錄避免現(xiàn)場機(jī)器裝沒裝 Halcon 的玄學(xué)問題 OUTbin/Release HALCON_BIN$HALCONROOT/bin/$HALCONARCH cp $HALCON_BIN/halcon.dll $OUT/ cp $HALCON_BIN/halconcpp.dll $OUT/ # 只有用 HDevEngine 才需要下面這兩個(gè) # cp $HALCON_BIN/hdevenginecpp.dll $OUT/ # cp $HALCON_BIN/hdevengine.dll $OUT/腳本本身沒什么技術(shù)含量價(jià)值在于把“哪些 dll 是必需的”這件事固化下來。現(xiàn)場機(jī)器往往裝的是運(yùn)行版而不是開發(fā)版多拷一個(gè) dll 頂多占幾兆少拷一個(gè)就是啟動(dòng)即崩。2.3 線程模型UI 線程只負(fù)責(zé)畫算子跑在工作線程MFC 的死穴是 UI 線程不能阻塞超過幾十毫秒而一次find_shape_model在高分辨率圖、多角度、多層金字塔的情況下跑到幾十甚至上百毫秒很常見。連續(xù)采圖時(shí)直接在OnBnClickedStart里循環(huán)調(diào)用界面必卡任務(wù)管理器里那個(gè)“未響應(yīng)”的標(biāo)題就是血淚經(jīng)驗(yàn)。更麻煩的是 Halcon 窗口有線程親和性O(shè)penWindow在哪個(gè)線程開的就只能在哪個(gè)線程操作它?？缇€程去DispObj輕則不顯示重則直接崩。我一般這么切// 自定義消息工作線程算完把結(jié)果丟回 UI 線程去顯示 #define WM_MATCH_RESULT (WM_USER 100) UINT CMatchDemoDlg::MatchThreadProc(LPVOID pParam) { CMatchDemoDlg* pDlg static_castCMatchDemoDlg*(pParam); HObject ho_Image; HTuple hv_Row, hv_Column, hv_Angle, hv_Score; while (pDlg-m_bRunning) { try { // 1. 取圖這里換成你的相機(jī)采集或文件讀取 ReadImage(ho_Image, HTuple(data/part_01.png)); // 2. 匹配hv_ModelID 在 UI 線程建好后傳進(jìn)來建一次用一輩子 FindShapeModel(ho_Image, pDlg-m_hvModelID, HTuple(-15).TupleRad(), HTuple(30).TupleRad(), 0.6, 1, 0.5, least_squares, 0, 0.8, hv_Row, hv_Column, hv_Angle, hv_Score); // 3. 只傳結(jié)果和圖像句柄不碰任何窗口 pDlg-m_hoLastImage ho_Image; // HObject 是引用計(jì)數(shù)賦值是安全的 pDlg-PostMessage(WM_MATCH_RESULT, 0, 0); } catch (HException ex) { // Halcon 異常必須接住否則線程直接終止 pDlg-PostMessage(WM_MATCH_RESULT, 1, 0); } Sleep(10); } return 0; }這段的關(guān)鍵點(diǎn)有三個(gè)FindShapeModel的NumLevels傳 0 表示用建模時(shí)定好的層數(shù)不要在這里另設(shè)一個(gè)值SubPixel選least_squares比interpolation穩(wěn)代價(jià)是慢一點(diǎn)點(diǎn)HObject的賦值是淺拷貝加引用計(jì)數(shù)所以把圖像存到對(duì)話框成員上不會(huì)帶來一次完整的內(nèi)存拷貝但也意味著你在工作線程里對(duì)同一個(gè)ho_Image再ReadImage一次主線程正在顯示的那張會(huì)跟著變——想要每幀獨(dú)立就CopyObj一份。UI 線程那邊只做三件事接消息、DispObj、畫十字和矩形框。這樣即使匹配跑到 200 毫秒界面拖動(dòng)、縮放依然跟手。3. 模板訓(xùn)練與查找參數(shù)八個(gè)建模參數(shù)和四個(gè)查找參數(shù)怎么定3.1create_shape_model的參數(shù)一個(gè)個(gè)說清楚形狀匹配的建模參數(shù)直接決定“能不能找到”查找參數(shù)只決定“找得多準(zhǔn)”。順序別搞反。參數(shù)含義常用取值調(diào)錯(cuò)的表現(xiàn)NumLevels金字塔層數(shù)auto或 06太大丟小特征太小慢AngleStart起始角弧度按工件實(shí)際偏轉(zhuǎn)定范圍不夠直接找不到AngleExtent角度跨度弧度同上同上AngleStep角度步長弧度auto或按半徑算太粗定位抖太細(xì)建模慢Optimization模板點(diǎn)優(yōu)化方式auto、point_reduction_high高優(yōu)化會(huì)犧牲一點(diǎn)點(diǎn)精度Metric極性u(píng)se_polarity光照反了就全丟Contrast邊緣對(duì)比度閾值auto或 2060太高模板點(diǎn)太少M(fèi)inContrast查找時(shí)最低對(duì)比度建模值的 1/21/3太高現(xiàn)場找不到Metric這個(gè)參數(shù)是最容易被忽略的。默認(rèn)use_polarity要求待查圖像里邊緣的明暗方向和模板一致如果現(xiàn)場打光方式變了或者工件翻面邊緣極性反了score 會(huì)直接掉到 0.1 以下你還以為是角度范圍設(shè)小了。另一種是ignore_local_polarity允許局部極性變化魯棒性更好但誤匹配率上升我在有反光鋁件上用過得配合提高M(jìn)inScore一起用。// 建模先框 ROI再做域縮減最后建形狀模板 HObject ho_ModelRegion, ho_ModelImage; GenRectangle1(ho_ModelRegion, 120.0, 200.0, 380.0, 460.0); // 行1,列1,行2,列2 ReduceDomain(ho_Image, ho_ModelRegion, ho_ModelImage); // 只在 ROI 內(nèi)取邊緣 HTuple hv_ModelID; CreateShapeModel(ho_ModelImage, HTuple(0), // NumLevels0讓 Halcon 自己定 HTuple(-15).TupleRad(), // AngleStart注意單位是弧度 HTuple(30).TupleRad(), // AngleExtent覆蓋 -15°~15° HTuple(auto), // AngleStep HTuple(auto), // Optimization HTuple(use_polarity), // Metric HTuple(auto), // Contrast HTuple(25), // MinContrast現(xiàn)場光照波動(dòng)大就調(diào)小 hv_ModelID);ReduceDomain這一步不能省。整幅圖去建模板背景里的傳送帶紋路、料盤邊緣全會(huì)被當(dāng)成特征點(diǎn)模板點(diǎn)數(shù)暴漲建模慢、查找更慢而且容易在背景相似的地方誤匹配。ROI 盡量貼著工件外輪廓留 510 像素余量。MinContrast單列出來說是因?yàn)樗鼪Q定了“現(xiàn)場能不能找到”。建模時(shí)的Contrast是按當(dāng)前這張圖的對(duì)比度自動(dòng)算的換一批料、換一個(gè)班次的光照對(duì)比度可能掉三成。這時(shí)候MinContrast如果還等于建模值那些邊緣就被過濾掉模板點(diǎn)剩不下幾個(gè)。我一般把它壓到Contrast的三分之一左右寧可多留點(diǎn)噪聲點(diǎn)也別讓模板變成空殼。3.2 金字塔層數(shù)和角度步長不要讓auto替你做決定auto在大多數(shù)場景下是合理的但它有個(gè)隱含前提——你的模板 ROI 大小適中。ROI 特別大比如 800×600 的整塊鈑金時(shí)auto給出的層數(shù)會(huì)偏高最頂層只剩幾十個(gè)點(diǎn)粗定位直接飄ROI 特別小比如 30×30 的字符層數(shù)又會(huì)偏低查找慢得讓人懷疑人生。角度步長有個(gè)可以手算的經(jīng)驗(yàn)公式模板上離中心最遠(yuǎn)的邊緣點(diǎn)半徑記作 r旋轉(zhuǎn) Δθ 后這個(gè)點(diǎn)的位移約等于 r·Δθ。要求這個(gè)位移不超過 1 個(gè)像素就得到 Δθ ≤ 1/r弧度。半徑 150 像素的模板Δθ 差不多 0.0067 弧度也就是 0.38 度。// 由模板 ROI 的等效半徑反推角度步長比 auto 更貼合實(shí)際尺寸 double w 260.0, h 160.0; // ROI 寬高像素 double r 0.5 * sqrt(w * w h * h); // 最遠(yuǎn)邊緣點(diǎn)半徑 double stepRad 1.0 / r; // 旋轉(zhuǎn)位移不超過 1 像素 double stepDeg stepRad * 180.0 / 3.14159265; stepDeg stepDeg * 0.7; // 留 30% 余量 stepDeg max(0.1, min(1.0, stepDeg)); // 夾到工程可用區(qū)間 HTuple hv_AngleStep HTuple(stepDeg).TupleRad();算完之后可以反過來驗(yàn)證把AngleStep設(shè)成這個(gè)值建一次模板再用同一張圖在角度范圍的邊界處比如 14.5 度去查score 應(yīng)該還在 0.8 以上。如果掉得厲害說明步長還是粗了。這個(gè)“邊界自測”是我每次建完模板必做的一步比看任何文檔都直觀。層數(shù)這邊我的習(xí)慣是建完模板后打印一下每層的點(diǎn)數(shù)// 檢查金字塔各層剩下多少模板點(diǎn)頂層太少就手動(dòng)降層數(shù) HTuple hv_NumLevels, hv_Points; GetShapeModelContours(ho_ModelContours, hv_ModelID, 1); // 取第 1 層輪廓 // 更直接的辦法重建一次顯式指定層數(shù)對(duì)比匹配耗時(shí)和穩(wěn)定性頂層點(diǎn)數(shù)低于 20 個(gè)粗定位基本靠運(yùn)氣這時(shí)候要么把NumLevels手動(dòng)減 12 層要么擴(kuò)大 ROI 讓特征更豐富。別嫌麻煩這一步省下的時(shí)間會(huì)在現(xiàn)場調(diào)試時(shí)十倍還回來。3.3find_shape_model分?jǐn)?shù)、重疊和貪心度查找參數(shù)里真正需要?jiǎng)拥氖撬膫€(gè)MinScore、NumMatches、MaxOverlap、Greediness。MinScore是門檻低于它的候選直接丟棄。設(shè)太高光照一變就報(bào)“未找到”設(shè)太低背景里隨便一塊紋理都能湊到 0.4。經(jīng)驗(yàn)值是 0.60.7 起步等批量驗(yàn)證過 score 分布之后再收緊。MaxOverlap處理疊件。工件挨在一起時(shí)兩個(gè)匹配結(jié)果可能重疊 80% 以上其實(shí)是同一個(gè)目標(biāo)被重復(fù)報(bào)了。設(shè)成 0.30.5 能有效去重但設(shè)太小會(huì)把真正緊挨著的兩個(gè)工件誤殺。Greediness是搜索的“貪心程度”0 最徹底最慢1 最快但可能漏檢默認(rèn) 0.9。精密對(duì)位場景我一般降到 0.70.8多花 20% 時(shí)間換穩(wěn)定性值。// 查找并解析結(jié)果注意返回的是四個(gè) HTuple長度等于匹配個(gè)數(shù) HTuple hv_Row, hv_Column, hv_Angle, hv_Score; FindShapeModel(ho_Image, hv_ModelID, HTuple(-15).TupleRad(), HTuple(30).TupleRad(), HTuple(0.6), // MinScore HTuple(3), // NumMatches最多找 3 個(gè) HTuple(0.4), // MaxOverlap去掉重疊候選 HTuple(least_squares), // SubPixel亞像素精度 HTuple(0), // NumLevels0沿用建模層數(shù) HTuple(0.8), // Greediness hv_Row, hv_Column, hv_Angle, hv_Score); // 結(jié)果按 Score 降序排列取第 0 個(gè)就是最優(yōu) for (int i 0; i hv_Score.Length(); i) { double row hv_Row[i].D(); // Row 是行坐標(biāo)也就是 Y double col hv_Column[i].D(); // Column 是列坐標(biāo)也就是 X double ang hv_Angle[i].D(); // 弧度順時(shí)針為正 double scr hv_Score[i].D(); // 這里做你的坐標(biāo)轉(zhuǎn)換、發(fā)給 PLC }亞像素模式選least_squares它在初步定位后用最小二乘擬合邊緣重復(fù)精度能到 0.02 像素級(jí)別interpolation快一些但精度差一檔none只在極端追求速度時(shí)用。這個(gè)參數(shù)和Greediness是速度與精度這組矛盾的兩個(gè)旋鈕別同時(shí)往快的那頭擰。4. 顯示與坐標(biāo)從 HObject 到 Picture Control 的像素對(duì)齊4.1 把 Halcon 窗口嵌進(jìn)控件父句柄別傳錯(cuò)Halcon 的窗口本質(zhì)上是個(gè)子窗口OpenWindow的第五個(gè)參數(shù)就是父窗口句柄。傳對(duì)話框的m_hWnd圖像會(huì)蓋住所有控件傳 Picture Control 的句柄圖像才會(huì)老老實(shí)實(shí)待在框里。void CMatchDemoDlg::OpenHalconWindow() { // 重開前必須先關(guān)否則每切換一次分辨率就漏一個(gè)窗口句柄 if (m_hvWindowHandle.Length() 0) { CloseWindow(m_hvWindowHandle); m_hvWindowHandle HTuple(); } CWnd* pCtrl GetDlgItem(IDC_PIC_DISPLAY); CRect rc; pCtrl-GetClientRect(rc); OpenWindow(0, 0, rc.Width(), rc.Height(), pCtrl-GetSafeHwnd(), // 父句柄只認(rèn)控件不認(rèn)對(duì)話框 visible, , m_hvWindowHandle); SetWindowAttr(flush, false); // 批量繪制時(shí)先不刷最后統(tǒng)一 FlushBuffer }flush設(shè)成false是個(gè)明顯的性能開關(guān)尤其在一幀里要畫幾十個(gè)輪廓的時(shí)候。設(shè)完之后記得在繪制結(jié)尾調(diào)一次FlushBuffer(m_hvWindowHandle)否則畫面不動(dòng)你會(huì)以為程序死了。窗口大小變化時(shí)要重開或者用SetWindowExtents調(diào)整。重開更干脆但必須先把舊窗口關(guān)掉這一條我吃過虧——早期版本里每次OnSize都OpenWindow一次而不關(guān)舊的跑了一下午任務(wù)管理器里 GDI 對(duì)象數(shù)一路漲到幾萬最后整個(gè)界面變成一片白。4.2 三套坐標(biāo)圖像坐標(biāo)、控件坐標(biāo)、屏幕坐標(biāo)這是新手最容易翻車的地方也是我見過最多“匹配明明對(duì)了但框畫偏了”的原因。三套坐標(biāo)的換算方向必須記死Halcon 的Row對(duì)應(yīng)屏幕上的 Y豎直向下Column對(duì)應(yīng) X水平向右。寫代碼時(shí)row傳給了 X 參數(shù)結(jié)果就是整個(gè)框順時(shí)針轉(zhuǎn)了 90 度?？丶鴺?biāo)的原點(diǎn)在控件左上角MFC 的OnLButtonDown給的point是相對(duì)對(duì)話框的得先ScreenToClient。圖像坐標(biāo)和控件坐標(biāo)之間隔著一個(gè)SetPart縮放比例和偏移都在里面。void CMatchDemoDlg::OnLButtonDown(UINT nFlags, CPoint point) { // MFC 給的 point 是相對(duì)對(duì)話框客戶區(qū)的先轉(zhuǎn)到顯示控件坐標(biāo)系 CPoint pt point; m_wndDisplay.ScreenToClient(pt); // 取出當(dāng)前顯示區(qū)域?qū)?yīng)的圖像范圍 HTuple hv_Row1, hv_Column1, hv_Row2, hv_Column2; GetPart(m_hvWindowHandle, hv_Row1, hv_Column1, hv_Row2, hv_Column2); CRect rc; m_wndDisplay.GetClientRect(rc); // 控件坐標(biāo) - 圖像坐標(biāo)線性映射別在這里加任何經(jīng)驗(yàn)偏移 double imgRow hv_Row1.D() (hv_Row2.D() - hv_Row1.D()) * pt.y / rc.Height(); double imgCol hv_Column1.D() (hv_Column2.D() - hv_Column1.D()) * pt.x / rc.Width(); // 記下來給 ROI 用 m_dClickRow imgRow; m_dClickCol imgCol; }另一種寫法是直接用GetMposition(m_hvWindowHandle, row, col, window)讓 Halcon 自己算。它更省事但有個(gè)前提調(diào)用它的線程必須是開窗的那個(gè)線程工作線程里調(diào)會(huì)返回一堆 0 或者拋異常。所以我在跨線程的場合一律手算寧可多寫三行。還有一個(gè)隱蔽的坑SetPart傳的參數(shù)順序是(Row1, Column1, Row2, Column2)而GenRectangle1的順序是(Row1, Column1, Row2, Column2)看著一致但很多人順手把Column2寫成了Row2結(jié)果顯示區(qū)域變成一個(gè)細(xì)長條。這種錯(cuò)誤編譯器不會(huì)報(bào)只能靠肉眼發(fā)現(xiàn)。4.3 句柄和內(nèi)存的生命周期別指望 GCHalcon 的HObject內(nèi)部是引用計(jì)數(shù)理論上離開作用域就釋放。但有兩類東西不在此列一是窗口句柄OpenWindow出來的必須CloseWindow二是HTuple里塞的數(shù)組如果在一個(gè)循環(huán)里不停TupleConcat內(nèi)存會(huì)一直漲。我的做法是給圖像加一個(gè)作用域守衛(wèi)避免在異常路徑上漏掉釋放// HObject 的作用域守衛(wèi)構(gòu)造時(shí)給個(gè)空對(duì)象析構(gòu)時(shí)強(qiáng)制 ClearObj class HObjScope { public: HObjScope() { m_obj.GenEmptyObj(); } ~HObjScope() { m_obj.ClearObj(); } // 引用計(jì)數(shù)歸零底層內(nèi)存立即回收 HObject* operator() { return m_obj; } // 支持 ReadImage(scope, ...) 這種寫法 HObject Get() { return m_obj; } private: HObjScope(const HObjScope); // 禁止拷貝防止引用計(jì)數(shù)被意外加一 HObjScope operator(const HObjScope); HObject m_obj; };ClearObj和讓它自然析構(gòu)的區(qū)別在于時(shí)機(jī)自然析構(gòu)要等棧展開異常路徑上如果被catch吞掉又沒重新拋出對(duì)象可能活到下一輪循環(huán)。顯式清一下內(nèi)存曲線會(huì)平得多。至于查看內(nèi)存任務(wù)管理器不夠用我一般掛個(gè)性能計(jì)數(shù)器看私有字節(jié)跑兩百幀不回落就是有泄漏。5. 避坑與排查模板匹配在 MFC 里翻車的五種現(xiàn)場5.1 Debug 能跑Release 一啟動(dòng)就崩現(xiàn)象Debug 下匹配正常切到 Release 雙擊 exe要么閃退要么ReadImage返回空、后面一路空指針。原因九成是運(yùn)行時(shí)庫不匹配。工程用/MT靜態(tài)鏈接而halconcpp.lib是按/MD編的兩套 CRT 同時(shí)在進(jìn)程里堆的分配和釋放跨了邊界HObject析構(gòu)時(shí)就會(huì)踩到別人的堆。解決C/C → 代碼生成 → 運(yùn)行時(shí)庫Debug 用/MDd、Release 用/MD和 Halcon 保持一致。改完記得全量重編只做增量編譯的話舊的 obj 還帶著老設(shè)置。5.2 換個(gè)角度就找不到score 掉到 0.3 以下現(xiàn)象工件擺正的時(shí)候 score 0.9 穩(wěn)如老狗一轉(zhuǎn)到十幾度就報(bào)未找到或者匹配到一個(gè)明顯錯(cuò)誤的位置。原因三個(gè)可能按概率排——AngleExtent沒覆蓋實(shí)際偏轉(zhuǎn)范圍AngleStep太粗邊界角度上模板和實(shí)際錯(cuò)開了半個(gè)像素以上MinContrast設(shè)太高轉(zhuǎn)到側(cè)面時(shí)邊緣對(duì)比度下降模板點(diǎn)被大量過濾。解決先把AngleStart/AngleExtent放寬到實(shí)際范圍的兩倍做一次驗(yàn)證能穩(wěn)定找到再收窄再按 3.2 的公式重算AngleStep最后把MinContrast降到建模Contrast的三分之一試試。三步做完還是不行那就是模板本身特征不足得換 ROI 或者加輔助特征。5.3 界面卡死匹配框畫在了按鈕上現(xiàn)象點(diǎn)開始之后界面卡住幾秒后圖像出來但畫在了對(duì)話框左上角蓋住了標(biāo)題欄和按鈕。原因算子在 UI 線程里同步跑消息泵被堵住同時(shí)OpenWindow的父句柄傳成了對(duì)話框的m_hWnd而不是 Picture Control 的句柄。解決算子挪到工作線程見 2.3結(jié)果通過PostMessage回主線程繪制父句柄改成控件句柄。改父句柄之后要檢查OnSize控件尺寸變了窗口得跟著調(diào)否則圖像會(huì)被裁掉一塊。5.4 跑一兩個(gè)小時(shí)內(nèi)存持續(xù)上漲現(xiàn)象剛啟動(dòng)時(shí)幾十兆跑一下午漲到一兩個(gè) G最后彈“內(nèi)存不足”。原因OpenWindow之后沒CloseWindow每次重開分辨率或切圖都漏一個(gè)循環(huán)里ReadImage出來的HObject掛在成員變量上沒清HTuple在循環(huán)里做TupleConcat累積。解決所有窗口操作成對(duì)出現(xiàn)寫一個(gè)ResetWindow()統(tǒng)一管圖像用 4.3 的守衛(wèi)HTuple在循環(huán)開頭hv_Result HTuple()重置。掛性能計(jì)數(shù)器觀察私有字節(jié)跑兩百幀不回落就是還有漏。5.5 中文路徑的圖讀不進(jìn)來現(xiàn)象ReadImage拋異常說文件不存在但資源管理器里明明有或者路徑里的中文變成一堆問號(hào)。原因MFC 工程默認(rèn) UnicodeHTuple接受const char*時(shí)按 ANSI 解釋寬字符路徑直接傳進(jìn)去就是亂碼。解決所有傳給 Halcon 的字符串都過一遍轉(zhuǎn)換CString strPath _T(D:\\圖像\\part_01.png); HTuple hv_File(CT2A(strPath)); // 轉(zhuǎn)成窄字符需要 atlconv.h ReadImage(ho_Image, hv_File);更徹底的辦法是工程目錄和文件名全用英文但現(xiàn)場拷貝過來的圖往往不聽話轉(zhuǎn)換這一步別省。6. 交付前的一次壓測用五十張圖驗(yàn)證穩(wěn)定性與節(jié)拍模板匹配調(diào)通不等于能交付。我踩過最疼的一次是現(xiàn)場跑了兩小時(shí)才開始偶發(fā)漏檢——光照隨時(shí)間漂移上午十點(diǎn)以后太陽斜射進(jìn)車間工件的對(duì)比度整體往下掉了三成MinContrast那關(guān)就過不去了。從那以后交付前必須跑一輪批量驗(yàn)證。驗(yàn)證分三塊缺一不可驗(yàn)證項(xiàng)做法判據(jù)覆蓋率五十張覆蓋全角度范圍的真實(shí)圖逐張跑漏檢 0 張誤匹配 0 張分?jǐn)?shù)分布統(tǒng)計(jì)所有 score 的最小值與均值最小值 MinScore× 1.3重復(fù)性同一張固定圖連查 100 次Row/Column 標(biāo)準(zhǔn)差 0.05 像素節(jié)拍連續(xù)跑 500 次取均值單幀耗時(shí) 產(chǎn)線節(jié)拍的 1/3最后一項(xiàng)留三倍余量不是保守是給現(xiàn)場的老工控機(jī)留的——開發(fā)機(jī)是 i7產(chǎn)線上那臺(tái)可能是十年前的雙核。批量腳本我一般直接寫在 demo 里加個(gè)隱藏的按鈕只在調(diào)試模式下顯示void CMatchDemoDlg::RunBatchTest() { double minScore 1.0, sumMs 0.0; std::vectordouble vRow; int nOk 0, nNg 0; for (int i 1; i 50; i) { CString strPath; strPath.Format(_T(data\\part_%02d.png), i); // 圖按序號(hào)命名覆蓋全角度 HTuple hv_File(CT2A(strPath)); HObject ho_Image; ReadImage(ho_Image, hv_File); LARGE_INTEGER t0, t1, freq; QueryPerformanceFrequency(freq); QueryPerformanceCounter(t0); // 計(jì)時(shí)只包住 FindShapeModel HTuple hv_Row, hv_Column, hv_Angle, hv_Score; FindShapeModel(ho_Image, m_hvModelID, HTuple(-15).TupleRad(), HTuple(30).TupleRad(), 0.6, 1, 0.5, least_squares, 0, 0.8, hv_Row, hv_Column, hv_Angle, hv_Score); QueryPerformanceCounter(t1); sumMs (t1.QuadPart - t0.QuadPart) * 1000.0 / freq.QuadPart; if (hv_Score.Length() 0) { nOk; minScore min(minScore, hv_Score[0].D()); vRow.push_back(hv_Row[0].D()); // 重復(fù)性用固定圖另外跑 } else { nNg; } ho_Image.ClearObj(); } // 結(jié)果直接彈個(gè) AfxMessageBox或者寫日志別只在調(diào)試器里看 CString strMsg; strMsg.Format(_T(通過 %d / 失敗 %d / 最低分 %.3f / 平均耗時(shí) %.1f ms), nOk, nNg, minScore, sumMs / 50.0); AfxMessageBox(strMsg); }計(jì)時(shí)的位置很講究QueryPerformanceCounter要把FindShapeModel單獨(dú)包起來別把取圖和繪制也算進(jìn)去否則測出來的是整個(gè)流程的耗時(shí)優(yōu)化的時(shí)候找不到重點(diǎn)。hv_Score[0]取第一個(gè)是因?yàn)榻Y(jié)果已經(jīng)按分?jǐn)?shù)降序這里只關(guān)心最優(yōu)的那個(gè)。重復(fù)性那項(xiàng)要單獨(dú)做拿同一張圖重復(fù)查 100 次把Row、Column存進(jìn)std::vector算標(biāo)準(zhǔn)差。如果標(biāo)準(zhǔn)差跑到 0.3 像素以上說明模板的邊緣特征不夠銳利或者Greediness設(shè)太高導(dǎo)致每次走的搜索路徑不同。這個(gè)指標(biāo)比 score 更能反映系統(tǒng)的真實(shí)精度因?yàn)?score 是相對(duì)的重復(fù)性是絕對(duì)的。還有個(gè)小技巧把五十張圖的 score 全部打到日志里畫個(gè)折線看一眼。如果是一條平線說明模板很穩(wěn)如果中間有個(gè) V 形谷那幾張圖就是薄弱環(huán)節(jié)單獨(dú)拎出來分析光照或者遮擋比現(xiàn)場出了問題再回頭查高效得多。我現(xiàn)在的習(xí)慣是只要這個(gè) demo 要交給別人用不管對(duì)方說得多急批量驗(yàn)證這一輪必須強(qiáng)制走完日志文件跟 exe 一起打包。不是為了證明什么是因?yàn)楝F(xiàn)場那臺(tái)機(jī)器和那張圖永遠(yuǎn)比實(shí)驗(yàn)室里多一個(gè)你想不到的變量。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取