osgUtil::Simplifier 模型简化利器

在三维渲染、GIS 仿真、VR/AR 等场景中，高精度模型往往会带来巨大的渲染压力，面数过多、顶点冗余是导致帧率下降、加载缓慢的核心原因。

OpenSceneGraph（OSG）提供了开箱即用的模型简化工具——osgUtil::Simplifier，它基于成熟的边塌陷算法，能在可控误差范围内轻量化模型，兼顾渲染性能与视觉效果，是构建 LOD（细节层次）系统、优化大规模场景的核心组件。

osgUtil::Simplifier 核心认知

1. 类定义与继承关系

osgUtil::Simplifier 是 OSG 工具库中的场景图访问器，其继承关系清晰，遵循 OSG 核心设计规范：

osg::Referenced → osg::NodeVisitor → osgUtil::Simplifier

• osg::Referenced：OSG 所有智能指针管理类的基类，提供自动内存回收；
• osg::NodeVisitor：场景图访问器基类，定义了遍历场景节点的统一接口；
• osgUtil::Simplifier：继承并扩展访问器能力，专门针对 osg::Geode 节点下的 osg::Geometry 执行网格简化。

这种设计让 Simplifier 无需手动遍历模型，只需调用 node->accept(simplifier) 即可自动递归处理场景中所有可简化的几何体，使用极简。

2. 核心原理：边塌陷算法

Simplifier 采用**边塌陷（Edge Collapse）**算法实现模型简化：

1. 遍历模型的三角网格边，计算每条边的塌陷代价（结合顶点误差、边界权重）；
2. 将满足条件的边两端顶点合并，删除冗余顶点与三角面；
3. 严格控制最大误差，确保简化后模型与原始模型的视觉偏差在可接受范围。

算法支持保留法线、纹理坐标等顶点属性，避免简化后出现渲染异常，同时支持保护模型边界，防止关键轮廓丢失。

3. 核心参数（控制简化效果）

Simplifier 的简化强度由两个关键参数决定，是调优的核心：

参数	类型	作用	简化规则
sampleRatio	浮点型	采样比率	取值0~1，数值越小，保留的面数越少，简化越激进
maxError	浮点型	最大误差阈值	简化后顶点与原始位置的最大距离，误差越大，简化越自由

完整代码

以下代码实现原始模型与简化模型并排显示，支持按 W 键切换线框模式，直观对比简化效果，可直接编译运行。

1. 完整源码

#include <osgViewer/Viewer>
#include <osgGA/StateSetManipulator>
#include <osg/Group>
#include <osg/PositionAttitudeTransform>
#include <osgUtil/Simplifier>
#include <osgUtil/Optimizer>
#include <osgDB/ReadFile>

int main()
{
    // 1. 初始化渲染窗口
    osg::ref_ptr<osgViewer::Viewer> viewer = new osgViewer::Viewer();
    // 添加状态集操作器：按W键切换实体/线框模式
    viewer->addEventHandler(new osgGA::StateSetManipulator(
        viewer->getCamera()->getOrCreateStateSet()
    ));

    // 场景根节点
    osg::ref_ptr<osg::Group> root = new osg::Group();

    // 2. 配置 Simplifier 简化参数
    float sampleRatio = 0.3f;   // 保留30%的三角面
    float maxError = 4.0f;      // 最大允许误差4.0单位
    osgUtil::Simplifier simplifier(sampleRatio, maxError);

    // 3. 加载原始模型（OSG自带cow.osg，需放置在程序同目录）
    osg::ref_ptr<osg::Node> originalModel = osgDB::readNodeFile("cow.osg");
    if (!originalModel) {
        OSG_WARN << "模型加载失败，请检查cow.osg路径！" << std::endl;
        return -1;
    }

    // 4. 深拷贝模型，避免简化操作修改原始模型
    osg::ref_ptr<osg::Node> simplifiedModel = dynamic_cast<osg::Node*>(
        originalModel->clone(osg::CopyOp::DEEP_COPY_ALL)
    );

    // 5. 平移简化模型，实现左右并排显示
    osg::ref_ptr<osg::PositionAttitudeTransform> pat = new osg::PositionAttitudeTransform();
    pat->setPosition(osg::Vec3(10.0f, 0.0f, 0.0f)); // 右侧10单位放置简化模型
    pat->addChild(simplifiedModel.get());

    // 6. 执行模型简化（核心调用）
    pat->accept(simplifier);

    // 7. 将两个模型添加到场景
    root->addChild(originalModel.get());  // 左侧：原始模型
    root->addChild(pat.get());            // 右侧：简化模型

    // 8. 场景优化：合并几何体、优化渲染状态
    osgUtil::Optimizer optimizer;
    optimizer.optimize(root.get());

    // 启动渲染
    viewer->setSceneData(root.get());
    return viewer->run();
}

2. 编译与运行

# 创建编译目录
mkdir build && cd build
# 生成编译文件
cmake ..
# 编译
make -j4
# 运行（将cow.osg放入build目录）
./osg_simplifier_demo

3. 操作说明

• 鼠标左键：旋转视角；
• 鼠标滚轮：缩放模型；
• W 键：切换实体/线框模式，直观对比面数差异。

Simplifier 关键特性与使用场景

1. 核心特性

• 自动遍历：继承 NodeVisitor，一键递归简化整个场景树；
• 属性保留：默认保留法线、纹理坐标，不破坏渲染效果；
• 边界保护：支持 setBoundaryWeight 保护模型关键轮廓；
• 误差可控：通过 maxError 精准控制简化精度，平衡性能与效果。

2. 适用场景

1. LOD 系统构建：生成不同精度的模型层级，远距离显示低模，近距离显示高模；
2. 大规模场景优化：GIS 倾斜摄影、城市建筑模型轻量化，提升加载与渲染效率；
3. VR/AR 实时渲染：降低模型复杂度，保证设备流畅运行；
4. 模型预处理：减少冗余面片，压缩模型文件大小，方便传输与存储。

总结

osgUtil::Simplifier 是 OSG 生态中轻量化模型的最优解，它以简洁的 API、稳定的算法，解决了高精度模型的渲染性能痛点。其清晰的继承关系让它完美融入 OSG 场景图体系，无需复杂配置即可实现高效简化。

通过调整 sampleRatio 和 maxError 参数，开发者可以灵活平衡模型精度与渲染性能，配合 LOD 系统，轻松应对各类复杂三维场景的优化需求。无论是小型仿真项目，还是大规模 GIS 工程，Simplifier 都是不可或缺的核心工具。