概述：使用Halcon在VS中的控件显示一张图片。
要点：使用了图像缩放和图像显示函数，以及鼠标滚轮响应函数。
1、创建WinForm项目
首先在VS中添加Halcon所需的控件HSmartWindowControl
然后创建新的winForm工程，并向窗体中拖入一个HSmartWindowControl控件和两个按钮控件。
拖入后不添加代码，直接运行，可能会出现如下错误：
HalconDotNet.HHandleBase 的类型初始化值设定项引发异常
Halcon error #2381:License is for wrong edition of Halcon in Operator set_system
原因是halcon运行库是64位的，vs的运行模式也需要设置为64位，默认的debug模式可能是any CPU，需要把这里修改成x64。
或者从解决方案资源管理器（solution Explorer）中双击打开属性（Property）页面，把Build栏的Platform target 改为x64即可。
2、创建Halcon实时显示代码并导出
打开halcon，写一句简单的代码
接着，选择文件->导出，将HDevelop语言导出为C#语言。
3、halcon 导出的C#代码分析
1 using System;
2 using HalconDotNet;
3
4 public partial class HDevelopExport
5 {
6 public HTuple hv_ExpDefaultWinHandle;
7
8 // Main procedure
9 private void action()
10 {
11 // Local iconic variables
12 HObject ho_Image;
13 // Local control variables
14 HTuple hv_Width = new HTuple(), hv_Height = new HTuple();
15 // Initialize local and output iconic variables
16 HOperatorSet.GenEmptyObj(out ho_Image);
17 ho_Image.Dispose();
18 HOperatorSet.ReadImage(out ho_Image, "printer_chip/printer_chip_01");
19 hv_Width.Dispose();hv_Height.Dispose();
20 HOperatorSet.GetImageSize(ho_Image, out hv_Width, out hv_Height);
21 ho_Image.Dispose();
22
23 hv_Width.Dispose();
24 hv_Height.Dispose();
25 }
26
27 public void InitHalcon()
28 {
29 // Default settings used in HDevelop
30 HOperatorSet.SetSystem("width", 512);
31 HOperatorSet.SetSystem("height", 512);
32 }
33
34 public void RunHalcon(HTuple Window)
35 {
36 hv_ExpDefaultWinHandle = Window;
37 action();
38 }
39 }
实际有用的代码就是action()内的代码，首先声明了图像变量：HObject ho_Image;
需要注意的是，图像类型需要先初始化再使用：HOperatorSet.GenEmptyObj(out ho_Image);
然后调用ReadImage函数读入图像文件，最后调用Dispose函数清空对象。但是没有显示图像的代码，需要自己添加。
4、向VS中插入代码
打开Winform工程窗体关联的cs文件Form1.cs，首先需要在文件头部添加命名空间引用：
using HalconDotNet;
需要在类中定义全局的窗口变量，便于操作窗体：
1 private static HWindow hwindow; //全局窗口变量
2 public HTuple hv_ExpDefaultWinHandle; //导出的代码定义的，其实没用到
窗口的初始化函数中添加全局变量的初始化函数：
1 public Form1()
2 {
3 InitializeComponent();
4 hwindow = hSmartWindowControl1.HalconWindow;//初始化窗口变量
5 this.MouseWheel += new System.Windows.Forms.MouseEventHandler(this.my_MouseWheel);
6 }
然后在按钮的响应函数中添加载入图像的及显示的代码：
1 private void button2_Click(object sender, EventArgs e)
2 {
3 #region 初始化变量
4 // Local iconic variables
5 HObject ho_Image;
6 // Local control variables
7 HTuple hv_Width = new HTuple(), hv_Height = new HTuple();
8 // Initialize local and output iconic variables
9 HOperatorSet.GenEmptyObj(out ho_Image);
10 ho_Image.Dispose();
11 HOperatorSet.ReadImage(out ho_Image, "clip.png");
12 hv_Width.Dispose(); hv_Height.Dispose();
13 #endregion
14
15 #region 缩放图像，适应窗口
16 bool needResizeImage = true;
17 //获取图像大小及纵横比
18 HOperatorSet.GetImageSize(ho_Image, out hv_Width, out hv_Height);
19 int im_width = int.Parse(hv_Width.ToString());
20 int im_height = int.Parse(hv_Height.ToString());
21 double im_AspectRatio = (double)(im_width)/(double)(im_height);
22 //获取窗口大小及纵横比
23 int w_width = hSmartWindowControl1.Size.Width;
24 int w_height = hSmartWindowControl1.Size.Height;
25 double w_AspectRatio = (double)(w_width)/(double)(w_height);
26
27 HOperatorSet.SetSystem("int_zooming", "false");//图像缩放之前最好将此参数设置为false.
28 HTuple para = new HTuple("constant");
29 HObject ho_zoomImage;
30 HOperatorSet.GenEmptyObj(out ho_zoomImage);
31
32 ho_zoomImage.Dispose();
33 if(w_width<im_width && im_AspectRatio>w_AspectRatio)
34 {
35 //超宽图像
36 HOperatorSet.ZoomImageSize(ho_Image, out ho_zoomImage, w_width, w_width / im_AspectRatio, para);
37 }
38 else if (w_height < im_height && im_AspectRatio < w_AspectRatio)
39 {
40 //超高图像
41 HOperatorSet.ZoomImageSize(ho_Image, out ho_zoomImage, w_height * im_AspectRatio, w_height, para);
42 }
43 else
44 {
45 needResizeImage = false;
46 }
47 #endregion
48
49 #region 显示图像
50 hwindow.SetPart(0, 0, -2, -2);
51 if (needResizeImage)
52 {
53 hwindow.DispObj(ho_zoomImage);
54 }
55 else
56 {
57 hwindow.DispObj(ho_Image);
58 }
59
60
61 //HOperatorSet.GetImageSize(ho_zoomImage, out hv_Width, out hv_Height);
62 //im_width = int.Parse(hv_Width.ToString());
63 //im_height = int.Parse(hv_Height.ToString());
64 //MessageBox.Show(hv_Width.ToString() + " " + hv_Height.ToString());
65
66 #endregion
67
68 ho_Image.Dispose();
69 ho_zoomImage.Dispose();
70 hv_Width.Dispose();
71 hv_Height.Dispose();
72 }
5、图像缩放和显示
这里我对导出的代码做了修改，主要是增加了图像缩放和显示功能。
图像缩放使用了ZoomImageSize函数，在帮助文档中，这个函数有两种用法：
1 static void HOperatorSet.ZoomImageSize(HObject image, out HObject imageZoom, HTuple width,HTuple height, HTuple interpolation)
2 HImage HImage.ZoomImageSize(int width, int height, string interpolation)
上面的代码中使用了第一种用法，所有的参数必须是Halcon的类型，但是实际使用时width 和height 可以用int类型，interpolation即差值算法参数也可以直接传入string类型，如“constant”。
第二种方法需要将使用HImage类型的变量来操作，所以需要将 HObject 类型定义的图像变量转换一下：
1 HImage img = new HImage(ho_Image);
2 ho_zoomImage = img.ZoomImageSize(w_width, w_width, "constant");
图像显示功能：先调用SetPart函数确定要显示图像的区域，然后调用DispObj函数显示图像，DispObj也有三种用法：
1 static void HOperatorSet.DispObj(HObject objectVal, HTuple windowHandle)
2 void HObject.DispObj(HWindow windowHandle)
3 void HWindow.DispObj(HObject objectVal)
此处我用的第三种：通过Hwindow调用，参数为要显示的图像变量。
1 hwindow.SetPart(0, 0, -2, -2);
2 hwindow.DispObj(ho_zoomImage);
6、SmartWindowControl窗口交互
前面实现了图像显示，SmartWindowControl最大的亮点其实是方便的交互功能。
可以用鼠标拖动图像水平移动，利用鼠标滚轮实现图像放大缩小。
另外，在winForm项目中，为了使用SmartWindowControl控件中图像的缩放，还需要添加鼠标滚轮响应的回调函数。
详见：C:/Program Files/MVTec/HALCON-18.05-Progress/doc/html/manuals/programmers_guide/programmers_guide_0051.html
实际测试发现帮助文档中的用法有一些问题，消息相应函数的注册应该在整个窗体的初始化函数中，而不是SmartWindowControl的初始化函数中。
1 private void hSmartWindowControl1_Load(object sender, EventArgs e)
2 {
3 //这句话不起作用
4 this.MouseWheel += new System.Windows.Forms.MouseEventHandler(this.my_MouseWheel);
5 }
1 public Form1()
2 {
3 InitializeComponent();
4 hwindow = hSmartWindowControl1.HalconWindow;//初始化窗口变量
5 // 鼠标滚轮的响应函数注册
6 this.MouseWheel += new System.Windows.Forms.MouseEventHandler(this.my_MouseWheel);
7 }
这样修改后，直接使用帮助文档中提供的my_MouseWheel也有一个小bug，就是无论在窗体的任何位置滑动滚轮，图片都会缩放，所以需要对鼠标的位置做一下限制：
1 private void my_MouseWheel(object sender, MouseEventArgs e)
2 {
3 System.Drawing.Point pt = this.Location;
4 int leftBorder = hSmartWindowControl1.Location.X;
5 int rightBorder = hSmartWindowControl1.Location.X + hSmartWindowControl1.Size.Width;
6 int topBorder = hSmartWindowControl1.Location.Y;
7 int bottomBorder = hSmartWindowControl1.Location.Y + hSmartWindowControl1.Size.Height;
8 if(e.X > leftBorder && e.X < rightBorder && e.Y > topBorder && e.Y < bottomBorder)
9 {
10 MouseEventArgs newe = new MouseEventArgs(e.Button, e.Clicks,
11 e.X - pt.X, e.Y - pt.Y, e.Delta);
12 hSmartWindowControl1.HSmartWindowControl_MouseWheel(sender, newe);
13 }
14 }