企业官网建设流程全解析

做OCCT开发的人迟早都会撞上同一个问题：几何体建出来了，但你根本看不到它。第一次用BRepPrimAPI_MakeBox生成一个立方体，盯着返回的那个TopoDS_Shape看了很久，说实话有点迷茫——它是一堆只有数学定义的面、边、顶点，没有画面，没有光影，它只存在于数据世界里。要让用户看到、旋转、缩放、拾取一个三维模型，必须把它翻译成渲染器能理解的语言。

这就是我写这一讲的原因。前面两讲把OCCT的数据结构和基础建模讲清楚了，这一讲我们把它和VTK串起来，做一个真正能跑起来的三维建模Demo：OCCT负责"算"，VTK负责"画"，中间再解决一个最关键的桥接问题——OCCT的BRep数据怎么变成VTK能渲染的三角网格。我会把从环境配置、几何建模、网格离散化、数据转换到鼠标拾取坐标的完整链路都过一遍，代码都给全，跟着敲完你就能拥有一个自己的三维建模可视化原型。适合刚入门OCCT、想把OCCT集成进Qt/VTK项目、或者正在做CAD/CAM工具链选型的朋友。

1. 整体设计思路与方案选型

1.1 为什么是OCCT+VTK这套组合

先说结论：OCCT不是不能显示模型，它自带AIS（Interactive Service）和V3d_Viewer，甚至支持鼠标旋转缩放，但那套可视化体系更像是"为了看而看"——做快速预览够用，一旦你要做复杂的自定义交互、把模型嵌入到自己设计的UI里、或者想把渲染效果和现代图形技术结合，用起来就会很别扭。AIS的扩展性虽然有，但它的文档少、社区小、出问题你只能自己去啃源码，成本高。

VTK不一样。VTK在三交互维可视化和科学计算可视化领域沉淀了二十多年，拾取、裁剪、测量、动画、体渲染这些现成的高质量交互组件随便调，而且和Qt的集成方案非常成熟。把OCCT当几何内核，把VTK当渲染和前端的组合，实际上也是很多开源CAD项目验证过的成熟路线。

这套组合分工很清晰：OCCT管"数学"——精确的NURBS曲面、拓扑关系、布尔运算、倒角倒圆；VTK管"画面"——三角形网格的光栅化、光照、相机控制、事件交互、Qt窗口嵌入。你不需要在两个领域里都做专家，你只需要把中间那条数据通路打通。

1.2 这个Demo要演示什么

做这类Demo，我建议不要只画一个干巴巴的立方体，那样转换链路虽然能跑通，但根本测试不出问题。我们做的是一个带孔、带倒角的组合体：先用BRepPrimAPI_MakeBox生成底座，再用BRepPrimAPI_MakeCylinder生成圆柱，做一次布尔减运算掏个孔，最后在边缘上倒个圆角。这个模型既有平面又有曲面，有锐边有光滑边，网格化之后能很好地暴露法线方向、三角剖分质量、拾取精度这些问题——这比任何理想化测试用例都管用。

Demo本身要具备三个能力：模型显示、视角操作、鼠标拾取坐标。这三个能力对应着三维建模软件最基础的使用感受，也正好是VTK交互体系里最典型的三个场景。

1.3 整条数据链路

我把这个Demo的核心架构画成一个线性流程，你在心里有这个图，后面代码就好读了：

OCCT的TopoDS_Shape（精确几何）→BRepMesh_IncrementalMesh离散化（生成三角网格）→ 遍历Poly_Triangulation提取节点和三角形 → 填充到vtkPolyData→ 挂到vtkPolyDataMapper→ 交给vtkActor→ 加入vtkRenderer→ 在QVTKOpenGLNativeWidget里显示。

整条链路里，最容易出问题的就是第3步到第4步——遍历OCCT网格数据、填VTK数据结构，这段代码必须自己写，而且有很多细节坑。后面我会专门用一整节来讲。

2. 环境搭建实战：OCCT、VTK、Qt6三方版本怎么配

2.1 OCCT的获取方式

OCCT现在官方提供的预编译包已经很方便了。Windows下可以直接从GitHub Releases里下载对应版本的二进制包，解压出来配置好环境变量就能用。用源码自己编译的好处是能自己控制优化选项和第三方依赖，但耗时比较长，Windows上完整编译一次可能半小时起步，不追求极致的其实没必要折腾。

Linux下的选择是系统包管理器的版本，但一般比较旧。比如Ubuntu仓库里的OCCT长期停留在一个老版本，如果你只是学习还好，要上项目我建议还是用官方预编译包或者vcpkg。vcpkg安装的方式运行vcpkg install opencascade，好处是版本、依赖都由vcpkg管理，CMake集成也很顺。

我当前用的版本是OCCT 7.7.0以上，7.x系列在核心API上差异不大，下面代码在7.5到7.8都能编译通过。OCCT 7.8.x对BRepMesh的处理有一些更新，但API层面完全兼容。

2.2 VTK版本与Qt版本的匹配关系

VTK版本选择上有一个硬性判断标准：你要用的Qt是哪个大版本。VTK 9.0开始对Qt6有支持，但9.0和9.1的支持不够稳定，真正成熟是在VTK 9.2之后。如果你决定用Qt6，直接上VTK 9.2或9.3，别回头。

还有一点必须提醒：VTK从9.0开始，把原来嵌入Qt的QVTKOpenGLWidget改名成了QVTKOpenGLNativeWidget，这个名字很多人写程序时就容易写错，或者在网上搜到老代码还写着旧的类名。我们用的是后者，编译时头文件引入QVTKOpenGLNativeWidget.h。

2.3 CMake里三方库集成

CMake配置本身不复杂，但顺序会坑人，网上很多报错都出在find_package的组件没写全。我这里给一个可以直接用的配置片段：

cmake_minimum_required(VERSION 3.22) project(OcctVtkDemo LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) set(CMAKE_AUTOMOC ON) find_package(OpenCASCADE REQUIRED) find_package(VTK REQUIRED COMPONENTS GUISupportQt) find_package(Qt6 REQUIRED COMPONENTS Widgets) add_executable(OcctVtkDemo main.cpp ShapeBridge.h ShapeBridge.cpp ) target_link_libraries(OcctVtkDemo PRIVATE ${OpenCASCADE_LIBRARIES} ${VTK_LIBRARIES} Qt6::Widgets )

这里要注意，VTK_LIBRARIES变量在find_package之后会被自动填充，但前提是VTK编译时开启了Qt支持。你在编译VTK时，VTK_GROUP_ENABLE_Qt这个选项必须打开，否则find_package(VTK COMPONENTS GUISupportQt)会直接失败。如果用的是vcpkg安装，需要指定特性：vcpkg install vtk[qt,rendering]。

3. 建模篇：用OCCT API生成一个能展示的模型

3.1 核心思路：从简单体到组合体

我个人做Demo的习惯是先跑通最小链路，再叠加复杂度。第一次做OCCT+VTK转换的时候，可以先从一个Box开始，确认整个管线没问题后，再上组合体。这里直接讲组合体的做法，因为它更有参考价值。

造型逻辑是：生成一个长60、宽40、高20的长方体作为底座；在默认Z轴方向上生成一个半径12、高30的圆柱，让它贯穿底座；用BRepAlgoAPI_Cut做布尔减，在底座上掏一个通孔；最后在底座的四条长边上做倒角，让模型不至于那么"生硬"。

建模部分代码很短：

#include <BRepPrimAPI_MakeBox.hxx> #include <BRepPrimAPI_MakeCylinder.hxx> #include <BRepAlgoAPI_Cut.hxx> #include <BRepFilletAPI_MakeFillet.hxx> TopoDS_Shape BuildDemoShape() { // 底座：60x40x20 TopoDS_Shape base = BRepPrimAPI_MakeBox(60.0, 40.0, 20.0); // 圆柱默认沿Z轴，高度30保证贯穿底座 TopoDS_Shape cyl = BRepPrimAPI_MakeCylinder(12.0, 30.0); // 布尔减：掏孔 TopoDS_Shape withHole = BRepAlgoAPI_Cut(base, cyl); // 对底座的边做倒角 BRepFilletAPI_MakeFillet fillet(withHole); TopExp_Explorer exp(withHole, TopAbs_EDGE); for (; exp.More(); exp.Next()) { fillet.Add(2.0, TopoDS::Edge(exp.Current())); } return fillet.Shape(); }

这里有三个经验点。第一，圆柱生成时默认的轴向就是Z轴，如果想让孔的方向不同，需要传入gp_Ax2坐标系统。第二，BRepFilletAPI_MakeFillet的Add方法第一个参数是倒角半径，半径大于模型特征尺寸时会报错，所以先做布尔再做倒角的时候，倒角半径要小于孔的边界尺寸，否则可能倒不出来。第三，布尔运算的结果是一个复合体，BRepAlgoAPI_Cut返回的Shape已经带上了新的拓扑关系，不需要你再手动合并。

3.2 离散化：为什么必须做，参数怎么设

OCCT里的TopoDS_Shape是精确的边界表示，它记录的是曲面方程、曲线方程，而不是离散的三角形。但不管是VTK还是任何OpenGL渲染管线，最终都只能画三角形面片。所以中间必须有一个"三角剖分"（Tessellation）过程，把精确几何离散成网格模型。这个过程在OCCT里由BRepMesh模块完成。

最常用的类是BRepMesh_IncrementalMesh：

#include <BRepMesh_IncrementalMesh.hxx> void MeshShape(TopoDS_Shape& shape) { // 线性偏差0.5，相对偏差关闭，角度偏差0.5 BRepMesh_IncrementalMesh mesher(shape, 0.5, Standard_False, 0.5); }

这三个参数决定网格质量和数量。第一个参数是线性偏差（Deflection），指离散后的三角形边与原始曲面之间的最大距离，这个值越小网格越密、越贴近原始曲面；第二个参数是相对偏差开关，设为Standard_True时，偏差值会按模型包围盒的大小自动缩放，适合不知道模型实际尺寸的场景；第三个参数是角度偏差，单位是弧度，控制曲面在弯曲处的细分程度。

我的经验是：做视觉展示用，偏差值取模型最大尺寸的千分之一左右通常效果不错。比如这个模型最大长度60，线性偏差取0.1~0.5都能接受；如果模型很大（比如几米的装配体），还用0.1就会产生海量三角形，卡到没法看。这种情况下建议开启相对偏差，或者对偏差值做一个基于包围盒直径的比例计算。

3.3 网格已经生成过了吗

在遍历一个Shape的三角化数据结构之前，一定先确认它确实已经网格化了。OCCT的BRepTools::IsTriangulated就是干这个的：

#include <BRepTools.hxx> if (!BRepTools::IsTriangulated(shape)) { MeshShape(shape); }

如果你传入一个没有网格化的Shape就去调BRep_Tool::Triangulation，拿到的Poly_Triangulation引用是空的，程序跑起来就崩溃，而且这种崩溃的位置还不一定在调用点，排查起来很折腾。这是我自己踩过的坑，写在这里给你提个醒。

4. 桥接篇：OCCT网格数据转VTK可渲染数据的完整实现

4.1 两种方案，为什么选内存直转

把OCCT模型送到VTK里，有两条路。一条是先在OCCT里导出成STL/OBJ/STEP这类中间格式，再用VTK的读取器读进来。这个方法听起来简单，但实际工程里我基本不用——导入导出有精度损失，文件I/O浪费时间，模型更新一次就要落一次盘，交互体验很差。

另一条路就是内存直转，也是这里要详细实现的方案。OCCT网格化之后，每个TopoDS_Face会关联一个Poly_Triangulation对象，里面保存了节点数组和三角形数组。我们要做的就是把每个面的节点坐标和三角形索引读出来，填进VTK的vtkPoints和vtkCellArray，组装成vtkPolyData。整个过程快、无中间文件、模型修改后能实时更新。

4.2 完整转换代码与逐段说明

下面是整个Demo里最核心的一段代码，我把它单独抽成一个函数：ShapeToPolyData。你以后做任何OCCT模型显示，都能直接复用这个函数。

#include <TopExp_Explorer.hxx> #include <TopoDS.hxx> #include <TopoDS_Face.hxx> #include <BRep_Tool.hxx> #include <Poly_Triangulation.hxx> #include <Poly_Array1OfTriangle.hxx> #include <TColgp_Array1OfPnt.hxx> #include <TopLoc_Location.hxx> #include <vtkPolyData.h> #include <vtkPoints.h> #include <vtkCellArray.h> vtkSmartPointer<vtkPolyData> ShapeToPolyData(const TopoDS_Shape& shape) { vtkNew<vtkPoints> points; vtkNew<vtkCellArray> polys; // 遍历所有面 TopExp_Explorer faceExp(shape, TopAbs_FACE); for (; faceExp.More(); faceExp.Next()) { const TopoDS_Face& face = TopoDS::Face(faceExp.Current()); // 获取该面的三角剖分数据 TopLoc_Location loc; const Handle(Poly_Triangulation)& tri = BRep_Tool::Triangulation(face, loc); if (tri.IsNull()) continue; // face可能位于shape的局部坐标系中，必须先做变换 const gp_Trsf& tr = loc.Transformation(); const TColgp_Array1OfPnt& nodes = tri->Nodes(); int nbNodes = nodes.Length(); // 每个顶点在vtkPoints里的起始偏移 vtkIdType baseIdx = points->GetNumberOfPoints(); points->SetNumberOfPoints(baseIdx + nbNodes); // 拷贝节点坐标 for (int i = 1; i <= nbNodes; i++) { gp_Pnt p = nodes(i).Transformed(tr); points->SetPoint(baseIdx + i - 1, p.X(), p.Y(), p.Z()); } // 拷贝三角形索引 const Poly_Array1OfTriangle& tris = tri->Triangles(); for (int i = 1; i <= tris.Length(); i++) { int n1, n2, n3; tris(i).Get(n1, n2, n3); vtkIdType ids[3] = { baseIdx + n1 - 1, baseIdx + n2 - 1, baseIdx + n3 - 1 }; polys->InsertNextCell(3, ids); } } vtkNew<vtkPolyData> polyData; polyData->SetPoints(points); polyData->SetPolys(polys); return polyData; }

这段代码有几个细节值得展开说。

第一，BRep_Tool::Triangulation(face, loc)返回的坐标是面局部坐标系下的，你需要用loc.Transformation()把坐标变换到shape全局坐标系。如果你图省事直接拿坐标去填充，模型会碎片化地错位，看起来像被肢解了。我第一次就漏了这行，出来的模型面片全是乱的，那种情况很难通过打印调试发现。

第二，OCCT的节点和三角形索引全部是1-based的，而VTK是0-based。所以填充三角形时每个索引都要减1。这个错看起来小，实际引发的后果是所有三角形错乱，模型会出现大量细长的撕裂状破面，几乎无法正常显示。

第三，每个面都是独立三角化的，所以相邻面之间共享边上的顶点会被重复存储到vtkPoints里。对于这个小Demo完全无伤大雅，但对大模型会导致顶点数量膨胀。如果你后面要做几十万面的大装配，可以考虑做一个哈希表按坐标去重，或者接受冗余顶点同时接受更大的内存开销，这个要结合具体场景权衡。

第四，vtkNew和vtkSmartPointer都是VTK的智能指针，用起来比你手动New/Delete安全得多。函数返回的vtkPolyData是vtkSmartPointer，调用方拿到的引用不会悬空。

4.3 法线处理：决定模型是"实体"还是"塑料片"

网格数据填充完毕只是第一步，渲染效果还差一道关键工序——法线。OpenGL的光照计算依赖每个顶点或每个面的法线方向，没有正确的法线，模型看起来要么全黑，要么明暗错乱。

OCCT的Poly_Triangulation里其实也可能保存法线，但不同版本、不同离散化配置下不一定都有。最稳妥的做法是交给VTK的vtkPolyDataNormals重新计算：

#include <vtkPolyDataNormals.h> vtkSmartPointer<vtkPolyData> ComputeNormals(vtkSmartPointer<vtkPolyData> src) { vtkNew<vtkPolyDataNormals> normals; normals->SetInputData(src); normals->ComputePointNormalsOn(); normals->ComputeCellNormalsOff(); normals->SplittingOff(); normals->Update(); return normals->GetOutput(); }

SplittingOff()是视觉质量的一个关键开关。保持SplittingOn时，VTK会在每个面的边界处切断法线共享，模型看起来是棱角分明的多面体；SplittingOff则让相邻面共享平滑的法线过渡，曲面看起来更圆润。对CAD模型的视觉展示，通常SplittingOff效果更好。如果你想让模型的棱边保持清晰的边线感，可以改成SplittingOn。

如果某个模型转换后发现部分表面黑掉，多半是三角形绕序和法线方向反了。这种情况可以在vtkPolyDataNormals上调用FlipNormalsOn()，把所有法线翻转过来。OCCT生成的三角形绕序通常是符合右手定则的，但遇到从其他格式导入、或者做过复杂布尔运算的模型，出现反向并不罕见。

4.4 渲染管线：从PolyData到屏幕

有了vtkPolyData，剩下的就是把PGM管线的标准四件套组装起来：

#include <vtkPolyDataMapper.h> #include <vtkActor.h> #include <vtkRenderer.h> #include <vtkCamera.h> vtkNew<vtkPolyDataMapper> mapper; mapper->SetInputData(polyData); vtkNew<vtkActor> actor; actor->SetMapper(mapper); actor->GetProperty()->SetColor(0.45, 0.65, 0.85); actor->GetProperty()->SetSpecular(0.4); actor->GetProperty()->SetSpecularPower(20); vtkNew<vtkRenderer> renderer; renderer->SetBackground(0.12, 0.14, 0.16); renderer->AddActor(actor); // 相机初始位置很关键，否则模型可能在视野外 vtkNew<vtkCamera> camera; camera->SetPosition(140, 100, 120); camera->SetFocalPoint(0, 0, 10); renderer->SetActiveCamera(camera);

vtkPolyDataMapper负责把我们的多边形数据交给GPU，vtkActor负责管理材质、颜色、变换等绘制属性，vtkRenderer持有一个场景的渲染状态。这个四件套是VTK所有显示场景的最小集合，你以后做任何可视化都离不开。

4.5 画线框：调试网格质量的一把利器

调试三角化质量的时候，我总会把actor切成线框模式看一眼：

actor->GetProperty()->SetRepresentationToWireframe();

这个操作能把所有隐藏的三角形拓扑暴露在眼前，网格哪里过密、哪里破洞、哪里三角形退化，一眼就能看出来。确认无误后再切回SetRepresentationToSurface()。我建议你在开发流程里养成这个习惯，比看任何统计信息都直观。

5. 交互篇：鼠标拾取三维坐标与Qt6视图嵌入

5.1 交互器的正确姿势

VTK默认提供了vtkInteractorStyleTrackballCamera这套交互器，它实现了鼠标左键旋转、中键缩放、右键平移的标准相机操作，覆盖了我们这个Demo的视角控制需求。只要把交互器挂到渲染窗口上，这几项能力就自动生效，不需要你额外写任何逻辑。

#include <vtkRenderWindowInteractor.h> #include <vtkInteractorStyleTrackballCamera.h> vtkNew<vtkRenderWindowInteractor> interactor; interactor->SetRenderWindow(renderWindow); vtkNew<vtkInteractorStyleTrackballCamera> style; interactor->SetInteractorStyle(style);

5.2 获取鼠标坐标：屏幕坐标和三维坐标的差别

很多刚接触VTK的人会把"鼠标坐标"理解成鼠标在窗口上的像素位置，也就是event.GetEventPosition()返回的(x, y)。这个坐标确实是拾取的第一步，但它只是屏幕坐标，单位是像素，和模型本身没有关系。

我们要的是点中模型表面之后的三维世界坐标。从二维屏幕反算三维坐标，必须借助拾取器。拾取器会从相机位置发出一条穿过鼠标位置的射线，用它和场景里的actor求交，返回最近交点的世界坐标。VTK里有好几个拾取器，这里用vtkPropPicker最合适——它专门拾取actor对象，picking速度也不错。

我自定义了一个交互样式类，重写了鼠标按下事件：

#include <vtkInteractorStyleTrackballCamera.h> #include <vtkPropPicker.h> #include <vtkRenderWindowInteractor.h> #include <vtkRenderer.h> class CMouseInteractorStyle : public vtkInteractorStyleTrackballCamera { public: static CMouseInteractorStyle* New(); vtkTypeMacro(CMouseInteractorStyle, vtkInteractorStyleTrackballCamera); virtual void OnLeftButtonDown() override { // 获取鼠标在窗口内的像素坐标 int x = this->Interactor->GetEventPosition()[0]; int y = this->Interactor->GetEventPosition()[1]; // 从屏幕坐标拾取模型表面 vtkNew<vtkPropPicker> picker; picker->Pick(x, y, 0, this->GetDefaultRenderer()); double* pos = picker->GetPickPosition(); // 这里pos[0], pos[1], pos[2]就是模型表面的三维坐标 qDebug() << "Picked: " << pos[0] << ", " << pos[1] << ", " << pos[2]; // 继续走默认的旋转逻辑 vtkInteractorStyleTrackballCamera::OnLeftButtonDown(); } }; vtkStandardNewMacro(CMouseInteractorStyle);

一个细节要说明：我把拾取逻辑写在OnLeftButtonDown里，意味着鼠标左键按下时会同时触发拾取和旋转。如果你想区分"点击"和"拖拽"，需要记录按下时的坐标和松开时的坐标，判断位移是否小于像素阈值，只有在小于阈值时才算点击拾取，否则当作旋转处理。这个逻辑在真正的建模软件里非常重要，你可以在这个Demo基础上继续完善。

5.3 嵌入Qt6：QVTKOpenGLNativeWidget的正确用法

VTK要在Qt窗口里显示，绕不开QVTKOpenGLNativeWidget。这个类把VTK的渲染窗口嵌进Qt的Widget体系里，它需要在QApplication启动之前设置默认的OpenGL格式，否则高DPI屏上可能出现显示异常：

#include <QApplication> #include <QSurfaceFormat> #include <QVTKOpenGLNativeWidget.h> #include <vtkGenericOpenGLRenderWindow.h> #include <vtkRenderer.h> int main(int argc, char* argv[]) { QApplication app(argc, argv); QSurfaceFormat::setDefaultFormat(QVTKOpenGLNativeWidget::defaultFormat()); // 创建Qt窗口部件 QVTKOpenGLNativeWidget* vtkWidget = new QVTKOpenGLNativeWidget; // 创建VTK渲染窗口 vtkNew<vtkGenericOpenGLRenderWindow> renderWindow; vtkWidget->setRenderWindow(renderWindow); // 把之前组装的renderer挂进渲染窗口 renderWindow->AddRenderer(renderer); vtkWidget->show(); return app.exec(); }

网上很多旧教程写的是QVTKOpenGLWidget，那是VTK 8.x时代的类名，在VTK 9里已经改名了。如果你在编译时遇到"找不到QVTKOpenGLWidget.h"之类的问题，十有八九就是版本差异导致的。

另外一个坑：VTK 9之后，QVTKOpenGLNativeWidget要求你的Qt程序必须使用OpenGL核心配置，并且vtkGenericOpenGLRenderWindow要和QVTKOpenGLNativeWidget配对使用。沿用老的vtkRenderWindow在纯QWidget嵌入场景下可能会报OpenGL context相关的错误。

5.4 坐标系的单位与朝向

OCCT的默认长度单位是毫米，VTK的坐标值没有单位概念，所以我们可以数值上1:1直接搬过去。但在正式项目里，如果模型来源是STEP或者其他格式，必须先确认单位。比如有的格式导入后长度变成了米，那显示出来模型就会小得看不见或大得溢出屏幕。

还有一个很阴间的细节是坐标系朝向。OCCT遵循右手坐标系，Z轴向上；VTK默认也是右手坐标系，但很多可视化场景习惯把Y轴当"上"方向。我这里直接保持Z轴向上不变，如果你后续要接游戏引擎或者其他渲染工具，坐标变换就躲不掉了，建议在转换函数里统一封装一个矩阵，不要散落在各处。

6. 踩坑实录：这条链路上我遇到过的常见问题

6.1 问题速查表

我把实际跑这个Demo过程中最容易踩的坑整理成了一张表，你遇到类似症状直接对照处理：

6.2 大数据量模型怎么做才不会卡

这个Demo里只有一个几百几千三角形的零件，怎么改都不卡。但你一旦开始加载一个整机装配，三角形数量轻松上百万，这时候就要想性能问题了。我提三条行之有效的策略。

第一条，在源头控制网格密度。BRepMesh_IncrementalMesh的偏差参数直接决定三角形数量，偏差增大一倍，三角形数量往往下降好几倍。做实时预览时用粗网格，做最终导出时才用细网格，这是一套经典的LOD（Level of Detail）思路。

第二条，用VTK的vtkDecimatePro或vtkQuadricDecimation在显示端做减面。这个命令输入的是vtkPolyData，输出的是减面后的vtkPolyData，用法简洁明确。注意减面会改变面数，不要影响你的拾取和坐标查询逻辑。

第三条，尽量避免每次模型变化都重新构建整个vtkPolyData。如果你的应用要频繁修改几何，建议把场景拆分成多个actor分别更新，只更新变化的那部分，不要整锅重来。VTK的vtkNew/vtkSmartPointer引用计数机制，在这种场景下能帮你自动管理旧数据的释放。

6.3 两个调试效率技巧

最后分享两个能显著提升调试效率的小技巧。

第一个是日志插桩。在ShapeToPolyData函数里打印每个面的节点数和三角形数，模型显示异常时，这个输出能帮你快速定位到是哪个面出了问题。处理复杂建模操作时，我还习惯给每个布尔运算的中间结果单独打印NbFaces，一旦数量异常就知道是哪一步造型出了问题。

第二个是留一个"最小复现"的入口。把一个简单立方体和一个复杂装配体都做为可切换的测试对象，放在同一个Demo里。复杂模型显示异常时，切回立方体跑一遍，如果你的链路连立方体都能弄坏，那问题基本出在数据转换本身；如果立方体正常、复杂模型异常，那问题大概率出在网格离散化参数或者模型数据本身。这套二分定位的思路，在图形开发的任何阶段都能帮上大忙。

我在实际把这条链路跑通之后最大的体会是：OCCT和VTK单独用哪个都不算难，真正让人挠头的是两者之间那条数据通路——索引从1到0的偏移、局部坐标到全局坐标的变换、法线的生成策略，每一个细节都够写一篇博客。把这个转换函数封装成一个稳定的工具模块，你就打通了从CAD内核到渲染引擎的大动脉。后续如果想继续扩展，可以在这个Demo基础上加STL导出、模型树、拾取高亮、截面剖切，甚至接一个属性面板进来，一个简单的建模软件雏形就有了。做三维开发就是这样，先打通链路，再谈功能，把基础设施做扎实了，后面的路会顺很多。