Halcon的C#二次開發及經驗分享

 

本文涉及面較廣，所以很難在全部方面都講解得很詳細，故適合具備必定Halcon開發經驗的人閱讀。

 

1、Halcon二次開發的兩種方式

① 使用C#的語法方式逐句改寫Halcon代碼

優勢：各類變量的類型清楚，可讀性強，改寫後代碼行數幾乎不會增長多少。

缺點：改寫工做量大，容易出錯，若是Halcon代碼量大，後期將難以更新維護。

 

② 封裝成函數導出 （推薦）

優勢：操做簡單，對開發人員編程能力要求低，工做量少，且便於維護。

缺點：Halcon函數導出的代碼可讀性極低，一旦丟失原Halcon文件，二次開發程序將難以更新維護。

 

建議：主二副一。

 

2、Halcon聯合C#開發必備的設置步驟（Halcon 12 + Visual studio 2013）

① 在項目「引用」中添加halcondotnet.dll。其通常路徑以下：

C:\Program Files\MVTec\HALCON-12.0\bin\dotnet35\halcondotnet.dll

② 在「工具箱」的「選擇項」中添加hWindowControl控件，這是Halcon 12惟一提供的控件

③ 在用到Halcon代碼的類頂部添加using HalconDotNet;

④ 在「屬性」——「生成」中將目標平臺由「Any CPU」改成「x64」（計算機推薦使用64位系統）

⑤ 若是安裝Halcon時不是安裝在默認路徑，可能須要將halcon.dll文件複製到當前項目的輸出路徑下，halcon.dll的路徑爲：C:\Program Files\MVTec\HALCON-12.0\bin\x64-win64\halcon.dll

 

3、Halcon圖形元素的顯示

hWindowControl1.HalconWindow.DispObj(image);//顯示圖像、Region、Xld

hWindowControl1.HalconWindow.SetDraw("margin");//設置填充的模式

hWindowControl1.HalconWindow.SetColor("green");//設置顯示顏色

 

4、系統全局參數設置（非必要，但建議設置）

HOperatorSet.SetSystem("do_low_error", "false");//少報錯

HOperatorSet.SetSystem("clip_region", "false");//region在圖像外不切掉

HOperatorSet.SetSystem("border_shape_models", "true");//依然匹配邊緣的圖形

 

5、調試

C#中Halcon部分代碼的調試不太方便，但也不是毫無辦法。

① 調試時HTuple類型的變量能夠直接查看值。

② Image、Region、Xld的變量通常只能經過「保存文件到本地」來查看變量狀況。

HOperatorSet.WriteImage(image, "jpg", 0x000000, "1.jpg");//彩色圖像

HOperatorSet.WriteImage(image, "jpg", 0, "1.jpg");//灰度圖像

HOperatorSet.WriteRegion(ho_RegionUnion, "1.hobj");//後綴用.reg也行

HOperatorSet.WriteContourXldDxf(contours,"1.dxf");

③ 安裝Halcon的變量檢查插件到Visual Studio。該安裝文件所在的默認路徑爲：

C:\Program Files\MVTec\HALCON-12.0\misc\HALCON_Variable_Inspect.vsix

 

6、在hWindowControl控件中顯示文字

如下兩個函數的內容由Halcon中的set_display_font和disp_message算子導出，可完成控件中的文字顯示。

 

set_display_font(windowHandle, hv_TextSize, "mono", "true", "false");

disp_message(windowHandle, hv_Text, "window", row, col, hv_Color,"true");

 

7、格式轉換

① HTuple兼容int、double等數據類型

② HObject類型的圖像兼容HImage類型的圖像

③ Bitmap轉Himage（24位或8位的）的方法以下：

 1 public static HImage Bitmap2HImage_24(Bitmap bImage)  2 {  3  Bitmap bImage24;  4     BitmapData bmData = null;  5  Rectangle rect;  6  IntPtr pBitmap;  7  IntPtr pPixels;  8     HImage hImage = new HImage();  9     rect = new Rectangle(0, 0, bImage.Width, bImage.Height); 10     bImage24 = new Bitmap(bImage.Width, bImage.Height, System.Drawing.Imaging.PixelFormat.Format24bppRgb); 11     System.Drawing.Graphics g = System.Drawing.Graphics.FromImage(bImage24); 12  g.DrawImage(bImage, rect); 13  g.Dispose(); 14     bmData = bImage24.LockBits(rect, ImageLockMode.ReadOnly, System.Drawing.Imaging.PixelFormat.Format24bppRgb); 15     pBitmap = bmData.Scan0; 16     pPixels = pBitmap; 17     hImage.GenImageInterleaved(pPixels, "bgr", bImage.Width, bImage.Height, -1, "byte", 0, 0, 0, 0, -1, 0); 18  bImage24.UnlockBits(bmData); 19 
20     return hImage; 21 }

 1 public static HImage Bitmap2HImage_8(Bitmap bImage)  2 {  3  Bitmap bImage8;  4     BitmapData bmData = null;  5  Rectangle rect;  6  IntPtr pBitmap;  7  IntPtr pPixels;  8     var hImage = new HImage();  9     rect = new Rectangle(0, 0, bImage.Width, bImage.Height); 10     bmData = bImage.LockBits(rect, ImageLockMode.ReadOnly, PixelFormat.Format8bppIndexed); 11     pBitmap = bmData.Scan0; 12     pPixels = pBitmap; 13     hImage.GenImage1("byte", bImage.Width, bImage.Height, pPixels); 14  bImage.UnlockBits(bmData); 15     //formathimage = hImage;
16     return hImage; 17 }

 

8、在hWindowControl控件中縮放圖像

 

在hWindowControl中鼠標位置可用GetMposition得到，SetPart可改變窗口中顯示的圖像部分。

 

HOperatorSet.GetMposition(hWHandle, out mouseY, out mouseX, out mbutton);

HOperatorSet.SetPart(hWHandle, mRow1, mCol1, mRow2, mCol2);

 

set_part：用於修改窗口中顯示的圖像部分。(Row1，Column1) 表示要顯示的圖像部分的左上角， (Row2，Column2)表示要顯示的圖像部分的右下角。（詳見dev_set_part和set_part的幫助文檔）

 

9、Halcon圖形元素與其餘圖像算法庫數據的交互

Halcon的Region、Xld是本身的特有格式，它們與外界是不通用的。目前我研究出來的主要是經過將座標點做爲橋樑來與外界進行數據交互。

 

Region轉化爲座標點：get_region_polygon(Region : : Tolerance : Rows, Columns)

座標點轉化爲Region：gen_region_polygon_filled( : Region : Rows, Columns : )

 

Xld轉化爲座標點   ：get_contour_xld(Contour : : : Row, Col)

座標點轉化爲Xld   ：gen_contour_polygon_xld( : Contour : Row, Col : )