Halcon C#.net 编程指导(1): 使用HALCIN/.NET控件

遵循以下步骤在一个应用中添加Halcon/.Net：

一. 定义工具箱

Halcon/.net 不仅提供了一个类库，而且提供了一个控件：HWindowControl，它包含一个显示图像处理结果的Halcon图像窗口。你可以通过以下的步骤把这个控件添加到VS工具箱中（注意不同的VS版本有不同版本的控件）

1. 右击工具箱（工具箱可以从视图，工具箱中打开），点击选择项，这时会显示所有的.NET Framework组件

2. 点击浏览，到%HALCONROOT%\bin目录下分别有几个文件夹对应不同的VS控件版本，dotnet10 (Visual Studio .NET2002 and 2003)或者%HALCONROOT%\bin\dotnet20 (Visual Studio 2005, Visual Studio 2008) 选择halcondotnet.dll.

3. 然后在HWindowControl就会出现在工具箱上。如下图。

二. 添加一个Halcon/.net的引用

在许多应用中我们至少会使用一个HWindowControl的实例使结果可视化（visualize results）.通过在form上添加一个控件，就可以自动创建一个halcondotnet的引用。

如过你不想使用HWindowControl，还可以通过以下步骤添加一个引用：

1. 右击引用（referencen）->添加引用

2. 点击浏览还是上一个目录找到对应的.dll文件，点击确定就可以看到在应用列表中多了一个halcondotnet

HALCON XL 应用后面会提到：当开发一个HALCON XL应用，那么就必须选择halcondotnetxl.dll而不是halcondotnet.dll.如果你已经添加了一个HALCON版本，那么必须删除并且添加halcondotnetxl.dl。

三. 指定命名空间

      为了能够直接使用HALCON/.NET的类而不要在前面加上命名空间，那么就必须在每个源文件的前面加上：using HalconDotNet;对应的VB.net和C++应用中分别是：Imports HalconDotNet;和using namespace HalconDotNet;

四. 添加并且自定义显示一个HWindowControl

在大多数的应用中我们不只想显示一个结果。当需要HWindowControl窗口时我们只需要双击工具箱中刚才添加的HWindowControl选项便会在我们的form中出现一个空白的HWindowControl窗口。如下图：

还是那句话如果已经添加了一个HALCON版本的控件，但是你想用HALCON XL，只需要删除刚才添加的halcondotnet.dll，并且添加halcondotnetxl.dll。

如果你想在在窗口里显示图像，那么你应当把窗口调整为和图像一样的尺寸，否则显示的会很慢应为这需要进行插值。我们可以通过属性窗口改变窗口和图像部分的大小，他们分别对应WindowSize和ImagePart属性。需要注意的是ImagePart中定义的是X,Y,Width,和Height的值，但是相应的SetPart算子改变的是图像四个角点的坐标。我们可以在任何时间改变我们应用中显示部分。

关于这一节更详细的信息见：基于halcon10.0二次开发基本步骤(VS2010 C#)