2.VTK是什么

VTK第一阶段：1.VTK是什么、应用场景、版本选择

你是小白，我尽量避开晦涩黑话，遇到专有名词会解释清楚。

一、VTK是什么

VTK = Visualization ToolKit，可视化工具库

• 用C++写的开源三维图形库，也提供Python绑定。
• 它不是游戏引擎（不是Unity、Unreal），它重点做「科学/工业数据可视化」。
• VTK帮我们做两件大事：
  1. 数据处理：对三维网格模型做裁剪、布尔、平滑、简化、计算法向量等几何运算。
  2. 渲染展示：把三维模型显示到窗口，支持旋转、缩放、平移鼠标交互。

简单理解： 你不用自己写OpenGL底层着色器、不用手写矩阵变换，VTK把底层图形逻辑全部封装好，你调用类和函数就可以完成三维软件功能。

和你工作相关的场景（工业三维）

1. 查看STL/OBJ三维扫描模型
2. 有限元仿真结果展示（应力云图，给网格上色）
3. 工业零部件三维预览、拾取面片、测量
4. 医学影像体渲染（CT/MRI）

VTK不擅长什么

1. 不适合做大型3D游戏；
2. 没有CAD参数化建模能力（没有直接拉伸、旋转建模，这个是OCCT做的，VTK只管网格数据）。

重点区分： OCCT：做CAD实体BRep建模； VTK：处理三角网格PolyData，负责可视化、网格处理渲染。 很多工业软件两者搭配使用：OCCT生成实体 → 转三角网格交给VTK渲染显示。

二、版本怎么选（非常关键，小白很容易踩坑）

VTK有两大分支：VTK 8.x、9.x，强烈建议直接选 VTK‑9.2.6

为什么不选最新版？

• VTK10改动大，大量API变动，网上旧教程代码跑不通，文档例子少，新手不友好。
• VTK9.2.6：接口稳定，网上案例多，CMake配置成熟，Qt集成成熟，工业项目大量在用。
• 不要选8版本：老版本对现代VS、新Qt兼容性差，很多bug不再修复。

编译方式二选一：

1. 自己源码编译VTK9.2.6（推荐，工业开发首选） 可以按需开关模块，没有多余模块，方便调试源码。缺点编译时间长。
2. 使用预编译包（vcpkg），适合快速跑demo，正式项目不推荐。

小白忠告：学习阶段优先 vcpkg 快速跑通第一个demo；后续做项目，再自己源码编译。

三、VTK最核心思想：可视化管线 Pipeline（整个VTK的灵魂，先理解这个）

VTK所有代码几乎都围绕管线，没理解管线，写代码只会复制粘贴，遇到报错完全看不懂。

什么是管线？

就像工厂流水线： 原始数据 → 经过一道道加工处理 → 交给渲染器画到屏幕上

VTK管线分为两大部分：数据处理管线 + 渲染管线

完整流程：

1. Source（数据源）：产生原始数据

   • 可以是程序生成球体、立方体；
   • 也可以读取STL文件，读进来模型数据。

2. Filter（过滤器）：对输入数据做加工。 例子：裁剪模型、平滑网格、合并模型、计算法向量。

   Filter特点：拿上一步输出作为输入，输出一份新的数据。可以多个Filter串联。

3. Mapper（映射器）：把处理完的数据，转换成渲染器能识别的绘制图元。

4. Actor（演员）：代表场景里的物体，设置颜色、透明度材质，交给渲染器。

5. Renderer（渲染器）：场景，存放很多Actor，管理相机、灯光。

6. RenderWindow（渲染窗口）：操作系统窗口，承载Renderer。

7. Interactor（交互器）：处理鼠标键盘，实现旋转缩放拖拽。

文字流程图：

Source → Filter1 → Filter2 → Mapper → Actor
                                          ↓
Interactor(鼠标键盘) ← RenderWindow ← Renderer（相机+灯光）

📌小白重点记忆：

• Source输出数据；Filter吃数据吐新数据；Mapper把数据变成可渲染对象；Actor代表物体；Renderer是舞台；RenderWindow是窗户；Interactor处理鼠标操作。
• 每一步是串联的，上一步输出给到下一步输入。

举个生活化例子： Source=一块生肉；Filter=切肉、腌制；Mapper=装盘；Actor=摆好的菜；Renderer=餐桌；RenderWindow=窗户，你透过窗户看餐桌；Interactor=你的手，可以旋转桌子看不同角度。

四、VTK内存管理：vtkSmartPointer智能指针（重中之重，新手高频坑）

VTK全部对象都继承vtkObjectBase，使用引用计数管理内存。

两种写法

1. 旧写法（不推荐，容易内存泄漏）

vtkSphereSource* sphere = vtkSphereSource::New();
sphere->Delete(); //手动释放，忘记写就内存泄漏

New()：创建对象，引用计数=1； Delete()：引用计数减1，计数到0自动释放内存。

2. vtkSmartPointer智能指针（学习、开发全部用这个）

vtkSmartPointer<vtkSphereSource> sphere = vtkSmartPointer<vtkSphereSource>::New();

不需要手动Delete！智能指针超出作用域自动帮你计数释放，杜绝内存泄漏。

小白铁律：写VTK C++代码，全部优先使用vtkSmartPointer，不要裸指针New/Delete。

小知识点：GetOutput()

Source/Filter调用GetOutput()拿到处理之后的数据对象。

sphere->GetOutput(); //获取球体生成出来的网格数据

⚠️注意：GetOutput返回的是内部指针，不要手动delete，由source/filter自己管理。

Update() 更新

source/filter需要调用Update()，才会真正执行计算生成数据。

sphere->Update(); //执行球体生成，数据才真正生成

很多新手忘记Update()，拿不到数据，程序崩溃或者窗口空白。

本节小结，需要记住的关键点

1. VTK是C++开源三维可视化库，做网格处理+渲染，不做CAD实体建模。
2. 学习版本优先选择 VTK‑9.2.6。
3. 核心是管线Pipeline：Source → Filter → Mapper → Actor → Renderer → RenderWindow → Interactor。
4. 内存：优先vtkSmartPointer智能指针，避免裸指针New/Delete。
5. Update()触发计算，GetOutput()获取输出数据。

---