Halcon C语言扩展包编程指南（第10版）

需积分: 9 163 浏览量更新于2024-07-29 收藏 1.42MB PDF 举报

Halcon程序员手册英文原版是一份由MVTec Software GmbH提供的专业文档，专为Halcon视觉软件开发人员设计。这份手册详尽介绍了如何基于用C语言编写的新型运算符创建Halcon扩展包，适用于Halcon版本10.0及后续更新。Halcon是一款广泛应用于工业自动化、机器视觉领域的高级机器视觉库，它允许用户通过模块化的编程方式构建复杂的图像处理应用。该手册自1997年首次发行以来，经历了多次迭代更新，直至Halcon 10.0和11.0版本，反映出MVTec公司在视觉处理技术上的持续创新与完善。版权信息表明，所有内容受MVTec Software GmbH保护，且部分内容受到美国专利US7,062,093和US7,239,929的保护，还有其他专利正在申请中。手册的重要内容包括但不限于： 1. **C语言集成**：强调了如何将C语言编程技能与Halcon接口相结合，开发出可扩展的视觉算法，以适应不断变化的业务需求。 2. **模块化开发**：阐述了如何通过编写独立的运算符（operators）来构建模块化的解决方案，提高代码的可重用性和维护性。 3. **版本兼容性**：手册覆盖了多个版本的Halcon，确保开发者了解不同版本之间的差异和新特性，以便于选择最适合当前项目的工具。 4. **操作流程**：详细描述了从编写运算符到打包、测试和部署的完整开发过程，包括编译、链接和集成到Halcon核心库中的步骤。 5. **许可证和法律注意事项**：强调了版权和使用条款，提醒开发者在复制、存储或传播内容时必须获得MVTec的书面许可，尊重知识产权。 6. **专利保护**：说明了Halcon所受的专利保护情况，这对于理解潜在的技术限制和可能的侵权风险具有重要意义。作为一份关键的学习和参考资源，Halcon程序员手册对于深入理解和开发机器视觉应用的工程师来说是不可或缺的。通过阅读和实践手册中的指导，开发者能够充分利用Halcon的强大功能，提升工业自动化系统的性能和智能化水平。

16 Introduction

1.3.2 Additional Information for Linux

On UNIX PCs running Linux you have to include the package library subdirectory lib/$HALCONARCH

in the environment variable LD_LIBRARY_PATH in order to use a package.

This has to be done in any case – regardless whether you plan to use a package within HDevelop only or

you want to create stand-alone applications.

For .NET applications, an alternative to setting LD_LIBRARY_PATH is described in the Programmer’s

Guide in section 11.3.3 on page 113.

1.3.3 Additional Information for Solaris

On UNIX workstations running Solaris you have to add the package library subdirectory

lib/$HALCONARCH to the environment variable LD_LIBRARY_PATH in order to run stand-alone appli-

cations based on the package. Otherwise the loader will fail to access the interface library libpack-

agec.so or libpackagecpp.so linked to the application, see section 7.2.7.3 on page 121.

Note that you must extend the variable LD_LIBRARY_PATH also for .NET applications, even if you do

not explicitly link the main package library (package.so): The referenced .NET assembly automatically

loads this library. An alternative to setting LD_LIBRARY_PATH is described in the Programmer’s Guide

in section 11.3.3 on page 113.

Note, that it is not necessary to modify LD_LIBRARY_PATH in order to use the package within HDevelop.

1.4 An Example

The following example illustrates the steps described in section 1.2 on page 12. Assume, one wants

to implement a new operator named user_thresh to extract all pixels with a gray value larger than a

threshold value speciﬁed in an input parameter. The use of user_thresh within a C program is illus-

trated in ﬁgure 1.2; a more detailed example is provided in %HALCONEXAMPLES%\extension_package\

halconuser\source\testthreshold.c.

main()

{

Hobject Image,Region;

int Thresh;

read_image(&Image,"monkey");

Thresh = 100;

user_thresh(Image,&Region,Thresh);

}

Figure 1.2: Calling the operator user_thresh in C.

1.4 An Example 17

To use user_thresh in this way within C programs

• The new operator must be implemented.

• The corresponding HALCON interface code must be generated.

• The corresponding package must be created especially containing the operator and interface li-

braries.

• The application must be linked.

user_thresh <- CIPUserThreshold[Image:Region:Threshold$i:];

Figure 1.3: Deﬁning a new operator user_thresh.

First of all one has to create a deﬁnition ﬁle (ﬁle extension .def), as illustrated in ﬁgures 1.3 and 1.4.

Figure 1.3 shows only the absolute minimum of information that a deﬁnition ﬁle must contain in order

to call a new operator within C programs. When using HDevelop, C++, or C#, an extended version is

necessary as described in section 2.2 on page 23. The minimal form of such an extended deﬁnition is

illustrated in ﬁgure 1.4. The deﬁnition ﬁle speciﬁes:

• the name of the operator (user_thresh),

• the name of the supply procedure that has to be implemented in C (CIPUserThreshold),

• names and types of the operator’s parameter(s). The names of the parameters are only important

for the manuals and within HDevelop.

The minimal form of the extended operator def-ﬁle includes: A short description (short), the HALCON

module (module) the operator belongs to, the mapping to a chapter (chapter) of the manual, the map-

ping to an iconic object (functionality), and for every parameter its semantic type (sem_type). In

addition, the type (default_type) and number (multivalue) must be speciﬁed for control parameters.

Our operator user_thresh has got the following parameters:

• one input iconic object parameter (Image),

• one output iconic object parameter (Region),

• one input control parameter (Threshold) of type int with exactly one value and

• no output control parameter.

The operator deﬁnition within the def-ﬁle now is used by hcomp to generate the appropriate interface

code. ﬁgure 1.5 shows the calls of hcomp. Note, that within this manual halconuser is used as name

of the HALCON package to be created. By calling hcomp with these options

the ﬁles Hhalconuser.c

(HALCON interface code), HChalconuser.c (C-speciﬁc interface code) and HChalconuser.h (proto-

type of the new HALCON operator) are created.

In the next step one has to program the new HALCON operator. This is done by implementing the

supply and action procedure. This results in the typical structure of HALCON operators as illustrated in

ﬁgure 1.6.

To use it within C++, C#, or Visual Basic basically the same steps are necessary, see

chapter 7 on page 111.

see section 7.1 on page 111 for a complete description.

Introduction

剩余162页未读，继续阅读

chenyun518

粉丝: 1
资源: 3

Halcon C语言扩展包编程指南（第10版）

Halcon程序员手册英文原版 20181126

halcon使用手册中文版

halcon中文手册

halcon开发手册

halcon手册英文

halcon算子中文手册chm

halcon 12 算子手册

halcon中文算子手册

halcon深度学习 手册

halcon22 算子手册

最新资源

halcon深度学习手册