1. 项目背景与核心价值

在工业视觉领域，Halcon作为老牌机器视觉软件，其强大的算子库一直是核心竞争力。但官方文档以英文为主，中文资料往往分散且不成体系。很多工程师在使用时，面对数百个算子常常需要反复查阅文档，严重影响开发效率。

我整理了这份中文算子速查手册，覆盖了图像采集、预处理、 blob分析、形态学、测量、匹配等12个核心模块的常用算子。每个条目包含算子名称、功能说明、典型参数和适用场景，特别标注了工业检测中的实战技巧。这份资料特别适合以下场景：

• 现场调试时快速查阅参数含义
• 新项目技术选型时筛选合适算子
• 团队新人快速掌握核心算子用法

2. 算子分类与功能解析

2.1 图像采集与基础操作

read_image
功能：读取图像文件
参数说明：

• FileName：支持bmp/jpg/png等常见格式
• Image：输出图像对象
  实战技巧：
• 批量读取时建议使用image_directory+tuple_regexp_match组合
• 读取失败时检查路径中的中文字符编码问题

get_image_size
功能：获取图像尺寸
输出参数：

• Width/Height：以像素为单位的尺寸
• 特别在兼容不同分辨率相机时必用

2.2 图像预处理算子

mean_image
功能：均值滤波
核心参数：

• MaskWidth/MaskHeight：滤波核尺寸（奇数）
• 典型值：3×3或5×5
  适用场景：
• 去除高斯噪声
• 过度平滑会导致边缘模糊（需平衡）

gauss_filter
功能：高斯滤波
关键差异：

• sigma参数控制平滑程度
• 比均值滤波更保边缘
• 计算量较大，实时系统慎用

3. Blob分析核心算子

3.1 阈值处理

threshold
功能：全局阈值分割
参数要点：

• MinGray/MaxGray：灰度区间
• 自动阈值推荐使用auto_threshold
• 光照不均时考虑dyn_threshold

connection
功能：连通域分析
输出：

• ConnectedRegions：连通区域集合
• 必须配合threshold使用
• 工业缺陷检测基础算子

3.2 特征提取

select_shape
功能：区域筛选
筛选维度：

• Area：面积筛选
• Circularity：圆度
• Rectangularity：矩形度
  典型应用：
• 过滤噪点区域
• 筛选特定形状目标

4. 形态学处理专题

4.1 基础运算

dilation_circle
功能：圆形膨胀
参数：

• Radius：膨胀半径
• 注意：过大半径会导致特征融合

erosion_rectangle1
功能：矩形腐蚀
应用场景：

• 消除毛刺
• 分离粘连物体

4.2 高级应用

opening_circle
功能：开运算（先腐蚀后膨胀）
优势：

• 平滑轮廓
• 保持原位置不变
• 比单独使用dilation更稳定

5. 几何测量算子

5.1 边缘检测

edges_sub_pix
功能：亚像素边缘检测
核心参数：

• Filter：选择sobel/canny等滤波器
• Alpha：平滑系数（0.1-1.0）
• 测量精度可达1/10像素

5.2 尺寸测量

measure_pos
功能：边缘对测量
输出：

• Row/Column：边缘位置
• Distance：边缘间距
• 必须配合ROI使用

6. 模板匹配实战

6.1 创建模板

create_shape_model
功能：创建形状模板
关键参数：

• NumLevels：金字塔层数（影响速度）
• AngleStart/AngleExtent：旋转范围
• 模板质量决定匹配成功率

6.2 匹配优化

find_shape_models
功能：多模板匹配
性能优化：

• MinScore：匹配分数阈值
• MaxOverlap：重叠区域控制
• 工业场景建议GPU加速

7. 特殊场景算子

7.1 一维码识别

find_bar_code
功能：条形码识别
支持类型：

• EAN-13/UPC-A等25+种
• 注意设置合适的符号体系

7.2 颜色处理

trans_from_rgb
功能：颜色空间转换
常用转换：

• RGB→HSV
• RGB→灰度
• 色差检测必备

8. 调试与优化技巧

8.1 可视化调试

dev_display
功能：显示图像/区域
调试技巧：

• 多窗口使用dev_open_window
• 显示文本用disp_message

8.2 性能优化

count_seconds
功能：耗时统计
优化方法：

• 算子级耗时分析
• 重点关注循环内算子

9. 工业检测案例实录

9.1 定位应用

affine_trans_region
功能：仿射变换
典型流程：

1. 创建模板
2. 匹配定位
3. 坐标变换
4. ROI校正

9.2 缺陷检测

difference
功能：图像差分
应用场景：

• 标准品比对
• 划痕检测
• 需配合blob分析

这份手册经过三年工业现场验证，累计覆盖200+实际案例。建议打印成册放在工位，遇到陌生算子时优先查阅中文说明，再结合官方文档理解细节参数。对于复杂算子如deformable_model_match，还需要配合示例程序学习。