vtkImplicitModeller 技术解析：几何体距离场量化

---

1. vtkImplicitModeller

vtkImplicitModeller是VTK中计算输入几何到结构化点集距离的核心过滤器，其核心功能是将输入几何体（如vtkPolyData、vtkUnstructuredGrid）的距离信息，采样到输出vtkImageData的结构化点集中，生成距离场（每个体素值为到最近几何体的距离），用于后续等值面提取（如vtkContourFilter生成偏移表面）等场景。关键特性包括：支持自定义采样维度（SampleDimensions，默认50×50×50）、最大采样距离控制（MaximumDistance，按输入包围盒对角线百分比设置）、边界值填充（Capping，用于闭合等值面）、多线程处理（Per-Voxel模式下可配置线程数） 及多数据集追加（StartAppend/Append/EndAppend），输出标量类型可灵活选择（如float、unsigned char），并支持按最大距离缩放（ScaleToMaximumDistance）以适配非浮点类型的动态范围。

---

2. 思维导图（mindmap）

---

3. 详细总结

1. 类概述：定位与基础特性

• 模块与定义：归属VTK的Filters/Hybrid模块，定义于vtkImplicitModeller.h，是连接几何体与结构化点集距离分析的核心工具。
• 核心价值：解决“几何体距离量化”需求，将非结构化的输入几何（如网格、点云）转换为结构化的距离场（vtkImageData），为后续等值面提取、距离分析提供标准化数据。
• 继承优势：继承vtkImageAlgorithm，确保输入为任意vtkDataSet（如vtkPolyData、vtkUnstructuredGrid）、输出为vtkImageData，天然兼容VTK图像管线（如与vtkImageWriter保存结果、vtkImageShiftScale调整范围）。
• 默认配置：构造时默认SampleDimensions=(50,50,50)、Capping=On、CapValue=大正数、ModelBounds=自动计算，可满足基础距离采样需求。

2. 核心工作原理

vtkImplicitModeller的工作流程分为4个关键步骤，核心是“空间采样+距离计算+边界处理”：

1. 采样空间初始化：根据ModelBounds（自动计算或手动设置）和SampleDimensions，生成结构化点集的空间网格，确定每个体素的物理坐标（结合网格间距）；
2. 距离计算：按ProcessMode选择计算方式：
   • Per-Vo