如何添加operatorfactory.h
在HALCON/.NET,我们可以用过一个类的实例
(instances of class)来调用HALCON算子。在HalconDotNet引用里,也就是动态链接库里包许多实例化一个类方法,这些
方法可能是重载的,静态的HALCON算子我们可以直接通过类名来调用(这些方法包括HALCON里所有的算子),而非静态的方法必须要通过实例化一个类
后才可以使用,通常HALCON/.NET封装了一个类的实例化方法以及类方法。
例如在C++中,可以使用以下两种方法:
C++(算子模式)
通过代码导出,以C++为例,默认导出为算子型的语法结构,而非面向对象的;在此模式下,全部函数声明为全局类型,数据类型只需要用Hobject、HTuple两类类型进行声明;
2. C++(面向对象)
可以以面向对象的方式重写代码,也即利用类及类的成员函数;在这种模式下,控制变量的类型仍未HTuple,而图形数据可以由多种类型,如HImage等;
HALCON手册建议使用者使用第二种方法。
例如我们使用第二种方法实现抓取图像序列(imagesequence)里第一张图像,并且将他显示在HWindowControl窗口中。代码是:
[cpp] view plaincopy
private HWindow Window;
private HFramegrabber Framegrabber;
private HImage Img;
Window= WindowControl.HalconWindow;
Framegrabber= new HFramegrabber("File", 1, 1, 0, 0, 0, 0, "default",
-1,"default", -1, "default",
"board/board.seq","default", 1, -1);
Img= Framegrabber.GrabImage();
Img.DispObj(Window);
GrabImage算子是通过HFramegrabber的实例来调用的。如果你是一个有经验的HALCON使用者,也许你已经看出来HFramegrabber的构造函数调用了OpenFramegraber算子。
但是对于新手来说,可能刚刚接触Halcon,对于Halcon算子还处于熟悉阶段,从Hdevelop中直接到出来的代码也是直接使用静态类。那么建议先使用第一种方法,你只需要明白通过HOperatorSet这个类你可以调用任何一个HALCON算子。
下面我们来看一下到底怎么样调用一个算子。以GrabImage算子为例:
[cpp] view plaincopy
static void HOperatorSet.GrabImage (out HObject image, HTuple acqHandle)//静态方法直接调用算子,包含的参数和halcon算子参数完全相同
void HImage.GrabImage (HFramegrabber acqHandle)//类中封装的类方法,要先实例化类后才可以使用
HImage HFramegrabber.GrabImage ()//重载的方法
image(output_object) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . image ; HImage
acqHandle(input_control) . . . . . . . . . . . . . . . . . . . . . . . . . .framegrabber ; HFramegrabber / HTuple
[cpp] view plaincopy
我们可以看出,算子可以通过三个类进行调
用:HOperatorSet, HImage,和HFramegrabber。其中第一种通过HOperatorSet调用主要是用在导出的
HDevelop中(如果你导出程序的话就会看到),也是建议新手使用的方法。而熟悉了之后一般我们在写程序时建议使用另外两种方式,就像下面这样进行调
用:
[cpp] view plaincopy
HImage Image1;
HImage Image4 = newHImage();
HFramegrabberFramegrabber =
newHFramegrabber("File", 1, 1, 0, 0, 0, 0, "default", -1,
"default",-1, "default", "board/board.seq", "default", -1,-1);
Image1 =Framegrabber.GrabImage();
HImage Image3 = null;
需要注意的是通过
HFramegrabber调用返回方法的值,而通过HImage调用没有返回值而是调用的类实例被修改,也就是HImage对象被修改。通常,调用类实
例不会被一个算子所修改,除了被上面所看到的“类构造器”(constructor-like)算子调用。
一些算子像CountSeconds可以当做类方法来使用,例如,你可以直接通过类名调用它们而不用生成一个实例:
[cpp] view plaincopy
double S1, S2;
S1 =HSystem.CountSeconds();
这是因为这些算子声明前面都有static关键字:
[cpp] view plaincopy
static void HOperatorSet.CountSeconds (outHTupleseconds)
static double HSystem.CountSeconds()<span style="font-family:'Times New Roman'; font-size:14px; line-height:21px"> </span>
下面我们看一下类的生命周期:从声明(Declaration)到终结(Finalization)
下面的声明仅仅声明了一个类HImage的变量,而没有指向任何的对象:
[cpp] view plaincopy
HImage Image1;
在这个语句中,你不能只使用变量直接去调用算子;有些语言里面甚至不能够将它用做一个输出参数(例如VB 2005)。只有先给它一个图像对象,例如:
[cpp] view plaincopy
Image1 =Framegrabber.GrabImage();
你也可以在声明的时候初始化一个变量:
[cpp] view plaincopy
HImage Image2 =Framegrabber.GrabImage();
[cpp] view plaincopy
<span style="font-family:Arial,Helvetica,sans-serif"></span><pre name="code" class="cpp">HImage Image3 = null;</pre>
你可以通过一个IsInitialized方法来检验一个类实例是否被初始化。
但是使用构造函数(Constructors)后的对象就可以了:
下面的式子是利用类HImage空的构造函数来初始化一个类变量
[cpp] view plaincopy
HImage Image4 = new HImage(); <span style="font-family:'Times New Roman'; font-size:14px"> </span>
类实例可以用来调用“类似构造函数”算子像GrabImage,用抓住的一张图片初始化类变量:
[cpp] view plaincopy
Image4.GrabImage(Framegrabber);
除了空的构造器,大部分HALCON/.NET类提供一个或者更多的构造器来初始化基于HALCON算子的对象。例如,HImage提供了一个构造器:
[cpp] view plaincopy
HImage Image5 = newHImage("fuse");<span style="font-family:'Times New Roman'; font-size:14px; line-height:21px"> </span>
reference manual和右键go to definition是很好的参考资料。
关于Finalizers
在.NET中程序员不需要考虑内存管理方面的事情,因为它有自动垃圾回收回收哪些不再使用的对象。HALCON/.NET完全遵循这种规则通过提供所有类的回收器,所以不需要管理资源,例如,一个图像采集设备的连接会被自动正确的删除。
对于大部分类,回收器自动调用合适的算子像CloseFramegrabber来释放资源。调用的算子在一个参考手册页中列了出来(例如HFramegrabber)。这个算子不可以通过类来调用,在相应的参考手册条目中可以看到:
[cpp] view plaincopy
static void HOperatorSet.CloseFramegrabber (HTupleacqHandle)
也就是说你没有必要调用这样一个算子,如果你想用别的参数从新进行连接,它会自动执行。
注意当用HFramegrabber一般的类时不能使用HOperatorSet来关闭或者清除算子。
但是对于像图像这种数据变量,它们包含的只是引用,对于他们指向的内存垃圾回收机制也许不会直接清除,这些就需要手动清除:
有一种方法是在处理完事件后直接调用GC清除:
[cpp] view plaincopy
private void Timer_Tick(object sender, System.EventArgs e)
{
Action();
GC.Collect();
GC.WaitForPendingFinalizers();
}
另一种方法是直接调用自带的销毁方法:
[cpp] view plaincopy
HImage Image = new HImage("fuse");
Image.Dispose();