4. HALCON编程语言基础

HALCON的编程语言基础是连接图像处理算法与工程应用的桥梁。与通用编程语言（如C++或C#）不同，HALCON提供了一套高度优化的算子库和独特的语法体系，尤其在变量类型、数据管理及图像处理流程控制上具有鲜明的领域特征。本章将系统梳理HALCON的语法结构、核心变量类型、控制流逻辑、文件读写方法以及最常用的图像处理算子，帮助学习者建立从“看懂代码”到“编写高效视觉程序”的能力。

上图展示了HALCON编程基础的核心框架。语法与变量类型是程序的地基，控制流程决定逻辑走向，文件读写负责数据交互，而图像处理算子则是实现视觉功能的关键工具。四个模块相互依存，共同构成完整的HALCON开发能力。下面我们将逐一深入剖析。

4.1 HALCON语法核心与变量类型

4.1.1 核心原理：赋值、算子调用与Tuple机制

HALCON的语法风格简洁，但与传统C语言有显著差异。最核心的语法规则包括：

• 赋值操作符：使用 := 进行变量赋值，例如 Image := read_image('test.png')。注意，HALCON中 = 用于比较，而 := 用于赋值，这与Pascal语言类似。
• 算子调用：HALCON算子采用“输出参数在前，输入参数在后”的约定。例如 threshold(Image, Region, 128, 255) 中，Image 是输入图像，Region 是输出区域，128 和 255 是阈值参数。
• Tuple（元组）：这是HALCON最独特的变量类型。一个Tuple可以包含多个同类型或混合类型的元素，例如 Tuple := [1, 2, 3, 'hello', 5.5]。Tuple支持索引访问（从0开始）、拼接、比较等操作，极大简化了批量数据处理。

变量类型方面，HALCON主要支持以下几种：

4.1.2 操作流程：变量声明与类型转换

HALCON中变量无需显式声明类型，解释器会根据赋值自动推断。但为了代码可读性和性能，建议遵循以下流程：

1. 命名规范：变量名以字母开头，可包含数字和下划线，区分大小写。建议使用驼峰命名法，如 RegionROI。
2. 类型转换：使用 tuple_int()、tuple_real()、tuple_string() 等函数进行显式转换。例如：IntVal := tuple_int(3.14) 结果为3。
3. Tuple操作：使用 | 拼接Tuple，使用 [] 索引，使用 tuple_length() 获取长度。例如：t1 := [1,2]; t2 := [3,4]; t3 := t1 | t2 结果为 [1,2,3,4]。

ImagePaths := []
for i := 1 to 10 by 1
    Path := 'part_' + i$'02d' + '.png'
    ImagePaths := [ImagePaths, Path]
endfor
// 此时 ImagePaths 包含10个字符串元素

4.1.3 常见误区与总结

总结：掌握HALCON的语法核心在于理解“输出在前”的算子约定和Tuple的灵活运用。建议初学者在HDevelop中多使用“变量窗口”观察类型变化，逐步建立直觉。

4.2 控制流程：条件、循环与异常处理

4.2.1 核心原理：HALCON控制流的特点

HALCON的控制流语句与通用语言类似，但有几个关键差异：

• 条件语句：支持 if / else / elseif 和 switch / case。条件表达式必须返回布尔值（0或1）。
• 循环语句：支持 for / endfor、while / endwhile、repeat / until。循环变量默认步长为1，可通过 by 指定步长。
• 异常处理：使用 try / catch / endtry 捕获运行时错误。这是保证程序健壮性的重要机制，尤其在处理图像读取失败或算子参数错误时。

4.2.2 操作流程：典型控制结构模板

// 条件判断示例
if (Area > 1000 and Area < 5000)
    Result := '中等大小'
elseif (Area >= 5000)
    Result := '大目标'
else
    Result := '小目标'
endif

// 循环遍历图像序列
for Index := 1 to NumImages by 1
    read_image (Image, 'img_' + Index$'03d')
    // 处理图像...
    if (Index == 5)
        continue // 跳过第5张
    endif
endfor

// 异常处理
try
    read_image (Image, 'nonexistent.png')
catch (Exception)
    disp_message (WindowHandle, '读取失败: ' + Exception[0], 'window', 12, 12, 'red', 'true')
endtry

4.2.3 案例拆解：批量图像处理中的流程控制

背景与约束：某工厂需要检测1000张电路板图像中的焊点缺陷。图像文件命名规则为 board_0001.png 至 board_1000.png。程序需要在每张图像上执行定位、检测，并记录结果。若某张图像无法读取，应跳过并记录错误日志，不能中断整个流程。

关键实现：

ErrorLog := []
for i := 1 to 1000 by 1
    FileName := 'board_' + i$'04d' + '.png'
    try
        read_image (Image, FileName)
        // 执行定位与检测算子...
        // 假设得到缺陷数量 DefectCount
        if (DefectCount > 0)
            disp_message (WindowHandle, '缺陷数: ' + DefectCount, 'window', 10, 10, 'red', 'true')
        endif
    catch (Exception)
        ErrorLog := [ErrorLog, FileName + ' 错误: ' + Exception[0]]
    endtry
endfor
// 将错误日志写入文件
open_file ('error_log.txt', 'output', FileHandle)
fwrite_string (FileHandle, ErrorLog)
close_file (FileHandle)

结果与复盘：该流程通过 try/catch 保证了1000张图像全部处理完成，即使有损坏文件也不会中断。错误日志记录了具体文件名和错误信息，便于后续排查。复盘发现，使用 continue 跳过特定索引（如校准图像）非常高效，但需注意循环变量的更新逻辑。

4.2.4 常见误区与总结

总结：控制流程是程序逻辑的骨架。在HALCON中，尤其要注意循环内图像内存的释放（使用 clear_image），避免长时间运行导致内存溢出。

4.3 文件读写：图像、文本与参数管理

4.3.1 核心原理：HALCON的文件I/O体系

HALCON支持多种文件读写方式，主要分为三类：

• 图像文件：使用 read_image / write_image 读写常见格式（PNG、JPEG、BMP、TIFF等）。支持多页TIFF和图像序列。
• 文本文件：使用 open_file / fread_string / fwrite_string 进行文本读写。支持追加、覆盖、二进制模式。
• 序列化对象：使用 write_region / read_region、write_shape_model / read_shape_model 等保存区域、轮廓、模板等复杂对象。

4.3.2 操作流程：参数文件读写示例

在实际项目中，我们经常需要将相机参数、ROI坐标、阈值等配置保存到外部文件，便于调试和部署。以下是一个典型的参数读写流程：

// 写入参数
open_file ('config.txt', 'output', FileHandle)
fwrite_string (FileHandle, 'ExposureTime=' + ExposureTime + '\n')
fwrite_string (FileHandle, 'Gain=' + Gain + '\n')
fwrite_string (FileHandle, 'ROI_X=' + ROI_X + '\n')
close_file (FileHandle)

// 读取参数
open_file ('config.txt', 'input', FileHandle)
fread_string (FileHandle, Line, 100)
while (Line != '')
    // 解析键值对
    SplitPos := strstr(Line, '=')
    Key := Line{0:SplitPos-1}
    Value := Line{SplitPos+1:strlen(Line)-1}
    if (Key == 'ExposureTime')
        ExposureTime := tuple_real(Value)
    elseif (Key == 'Gain')
        Gain := tuple_real(Value)
    endif
    fread_string (FileHandle, Line, 100)
endwhile
close_file (FileHandle)

4.3.3 实战场景：批量保存检测结果

场景描述：在视觉定位系统中，需要将每次检测的坐标、角度、分数保存到CSV文件，供MES系统读取。要求数据格式为：时间戳, 图像名, X坐标, Y坐标, 角度, 分数。

实现方案：

open_file ('results.csv', 'append', FileHandle) // 追加模式
for each image
    // 执行定位...
    Timestamp := tuple_secs() // 获取当前时间戳
    Line := Timestamp + ',' + ImageName + ',' + X + ',' + Y + ',' + Angle + ',' + Score + '\n'
    fwrite_string (FileHandle, Line)
endfor
close_file (FileHandle)

复盘经验：使用追加模式可以避免每次覆盖整个文件，适合长时间运行的生产环境。但需注意多线程写入时的文件锁问题，建议在写入前加互斥锁。

4.3.4 常见误区与总结

总结：文件读写是连接HALCON程序与外部系统的桥梁。掌握 open_file 的三种模式（input/output/append）和字符串解析技巧，能大幅提升开发效率。

4.4 图像处理基本算子：从采集到特征提取

4.4.1 核心原理：算子分类与数据流

HALCON提供了超过3000个算子，但初学者只需掌握以下核心类别：

4.4.2 操作流程：典型图像处理流水线

// 1. 读取图像
read_image (Image, 'sample.png')
// 2. 灰度化（若为彩色）
if (Image::is_color())
    rgb1_to_gray (Image, GrayImage)
endif
// 3. 高斯滤波降噪
gauss_filter (GrayImage, FilteredImage, 3)
// 4. 阈值分割
threshold (FilteredImage, Region, 128, 255)
// 5. 连通域分析
connection (Region, ConnectedRegions)
// 6. 特征筛选（选择面积在100-5000之间的区域）
select_shape (ConnectedRegions, SelectedRegions, 'area', 'and', 100, 5000)
// 7. 计算质心
area_center (SelectedRegions, Area, Row, Column)
// 8. 显示结果
disp_cross (WindowHandle, Row, Column, 6, 0)

4.4.3 案例拆解：零件定位中的算子组合

背景：需要定位传送带上的圆形零件，并输出其圆心坐标和半径。零件图像存在光照不均和轻微噪声。

关键步骤与算子选择：

1. 预处理：使用 median_image 去除椒盐噪声，核大小5x5。
2. 阈值分割：由于光照不均，使用 dyn_threshold 结合背景图像进行动态阈值分割，比固定阈值更鲁棒。
3. 形态学闭运算：使用 closing_circle 填充零件内部孔洞，半径5像素。
4. 特征提取：使用 select_shape 筛选圆形度（'circularity'）大于0.8的区域。
5. 拟合圆：使用 fit_circle_contour_xld 对区域边缘进行亚像素圆拟合，得到精确圆心和半径。

结果对比：固定阈值在光照变化时误差达±3像素，而动态阈值+圆拟合的误差稳定在±0.5像素以内。

复盘经验：算子选择应遵循“由粗到精”原则：先用快速算子（如 threshold）缩小范围，再用高精度算子（如 fit_circle_contour_xld）精确定位。同时，注意 dyn_threshold 需要提供背景图像，可通过 mean_image 生成。

4.4.4 常见误区与总结

总结：图像处理算子是HALCON的核心价值所在。建议初学者在HDevelop中逐步执行算子，观察每一步的中间结果（图像、区域、轮廓），理解数据流的变化。这是快速提升调试能力的有效方法。