学习Halcon（一）——使用HALCON/.NET开发程序（一）

参考

Chatper 10, solution_guide_i.pdf, Halcon 17.12

---

HALCON/.NET 和 .NET Framework版本

版 本	路 径	支持WPF	支持Client Profiles
.NET Framework 2.0	%HALCONROOT%\bin\dotnet20	No	No
.NET Framework 3.5	%HALCONROOT%\bin\dotnet35	Yes	No

---

在程序中使用 HALCON/.NET

将 HALCON/.NET 控件添加到工具箱中

• 在工具箱窗口点击右键，选中“选择项(I)...”。
  
• 在“选择工具箱项”窗口点击“浏览”按钮。
  
• 选中指定版本的 HALCON/.NET，再点击“打开”按钮。
  
• 工具箱中会出现“HSmartWindowControl”和“HWindowControl”2个图标。
  
• 强烈建议使用“HSmartWindowControl”控件；“HWindowControl”是旧控件，主要为了向后兼容。

添加 HALCON/.NET 引用

• 添加“HSmartWindowControl”后，自动添加了 HALCON/.NET 引用
• 手动添加引用：
  右键点击“解决方案”-“引用”，点击“添加引用(R)...”。
  
  点击“浏览”按钮。
  
  选中指定版本的 HALCON/.NET，再点击“打开”按钮。
  
  点击“确定”按钮。
  

指定名字空间

编程环境	代码
C#	using HalconDotNet;
VB .Net	Imports HalconDotNet
C++/CLI	using namespace HalconDotNet;

---

使用 HALCON/.NET 控件进行可视化编程

在 Windows Forms 中使用 HSmartWindowControl，在 WPF 中使用 HSmartWindowControlWPF。

HSmartWindowControl 对比 HWindowControl 的优点：

• 可以像其他控件一样使用（比如，能嵌入到TabControl和ScrollViewer中，能被其他控件遮挡）。
• 提供了预制的鼠标交互（可以移动窗口中的内容，并使用鼠标滚轮进行缩放操作）。在窗口双击后能复位视图。
• 控件能无闪烁地自动rescale。

使用 HSmartWindowControl 时，需要添加一些代码：

// 添加鼠标滚轮事件的回调
private void WindowControl_Load(object sender, EventArgs e)
{
    this.MouseWheel += my_MouseWheel;
}

// 发送鼠标相对坐标发给 HSmartWindowControl
private void my_MouseWheel(object sender, MouseEventArgs e)
{
    Point pt = hSmartWindowControl1.Location;
    MouseEventArgs newe = new MouseEventArgs(e.Button, e.Clicks,
    e.X - pt.X, e.Y - pt.Y, e.Delta);
    WindowControl.HSmartWindowControl_MouseWheel(sender, newe);
}

其他可以使用的事件：

• Click
• GotFocus, LostFocus
• MouseEnter, MouseLeave, MouseHover
• Resize, SizeChanged
• KeyDown, KeyUp, KeyPress

部分算子不支持 HSmartWindowControl

• draw_*
• get_mbutton(_subpix)
• get_mposition(_subpix)

---

HSmartWindowControl 属性说明

• HImagePart：图像在窗口上显示的区域。
• HMoveContent：是否可以用鼠标拖拉显示的内容。
• HZoomContent：是否可以用鼠标滚轮对显示的内容进行缩放。
• HZoomFactor：指定缩放时的步长。
• HKeepAspectRatio：是否固定图像的高宽比。
• HDrawingObjectsModifier：是否使用Alt、Ctrl或Shift来配合鼠标进行交互控制。
• HDoubleClickToFitContent：双击是否可以调整显示内容大小来适配窗口尺寸。
• • 自动将图像大小和窗口适配的代码：WindowControl.HalconWindow.SetPart(0, 0, -2, -2);
• • 将图像大小设置得和窗口一样：WindowControl.SetFullImagePart(null);
• • 显示图像：WindowControl.HDisplayCurrentObject = new HImage("fabrik");