本文介绍 Halcon 中函数的常识规则，使用习惯，封装方法等内容。

简介 {#简介}

• Halcon 以速度快、精度高而闻名于工业机器视觉领域，其中核心就是存在着大量优质的函数（算子）供相关从业开发人员使用。
• Halcon 的函数不设返回值，需要返回的结果都以实参的形式定义并返回

查看函数文档 {#查看函数文档}

查阅帮助文档是学习 Halcon 算子的重要方式

• 在 Halcon 界面按下 F1 键或单击帮助菜单，选择帮助

• 可以在多个维度下搜索算子，示例：

• 也可以将光标放在函数名称上，按下 F1 调出对应算子文档

文档签名 {#文档签名}

• 在介绍每个函数的参数列表时，每个函数的签名中都会有 3 个冒号

• 三个冒号的作用是将参数列表分隔为 4 个部分，从左到右分别为：

  1. 输入图像参数列表
  2. 输出图像参数列表
  3. 输入控制参数列表
  4. 输出控制参数列表

• 以 threshold 函数为例：

  • 输入图像参数为 ： Image
  • 输出图像参数为： Region
  • 输入控制参数为：MinGray, MaxGray
  • 没有输出控制参数

自定义函数 {#自定义函数}

• 可以将工作流程封装为自己的本地函数，在程序界面 右键 -> 创建新函数

• 填写函数名称

• 设置函数参数，包括参数类型、参数名称、参数顺序

• 在编写函数时，输入参数名称可以直接使用
• 想要向外输出结果仅需为输出参数名称赋值
• 调用参数时按照函数签名的顺序，输入图像参数 - 输出图像参数 - 输入控制参数 - 输出控制参数
• 在本地函数编辑界面单击编辑按钮可以重新进入函数编辑面板

参考资料 {#参考资料}

• https://www.mvtec.com/products/halcon/work-with-halcon/documentation

文章链接：
https://www.zywvvd.com/notes/coding/halcon/halcon-func/halcon-func/