Halcon深度图转点云实战：从XYZ映射到3D可视化全解析

1. 深度图与点云的基础概念

深度图本质上是一张特殊的灰度图像，每个像素值代表该点到相机的距离。比如用Kinect拍摄的深度图，白色区域表示物体离相机较近，黑色区域则表示较远或无效区域。这种数据在工业检测中特别有用，比如测量零件的高度差或检测表面缺陷。

点云则是三维空间中一系列离散点的集合，每个点都有XYZ坐标。想象把深度图的每个像素"拉起来"到对应高度，就形成了三维点云。Halcon的ObjectModel3D对象就是用来存储这种点云数据的容器，支持附加颜色、法向量等属性。

XYZ映射是连接两者的桥梁。简单来说：

• X图像：每个像素值是该点在相机坐标系下的X坐标
• Y图像：对应Y坐标
• Z图像：就是深度图本身，记录Z坐标

2. 环境准备与数据读取

2.1 Halcon环境配置

建议使用Halcon 20.11及以上版本，对3D功能支持更完善。安装时务必勾选"3D Vision"组件。我习惯在HDevelop中新建一个专用3D窗口：

dev_open_window (0, 0, 800, 600, 'black', WindowHandle)
dev_set_window (WindowHandle)

2.2 深度图读取技巧

读取深度图时要注意数据类型。很多工业相机输出的TIFF深度图是16位无符号整型：

read_image (ImageZ, 'part_depth.tiff')
get_image_type (ImageZ, Type)  // 检查图像类型

如果深度值有负值（比如扫描凹陷区域），需要做归一化处理：

min_max_gray (ImageZ, ImageZ, 0, Min, Max, Range)
if (Min < 0)