刻线/轮廓高亮特效 osgFX::Scribe

在 OpenSceneGraph（OSG）三维开发中，模型轮廓高亮、线框刻线是工业仿真、三维展示、交互选中场景的核心需求。

osgFX::Scribe 是 OSG 官方提供的开箱即用特效类，无需编写着色器，即可快速实现实体模型+轮廓线的双重渲染效果，兼具易用性与兼容性。

本文将从继承关系、核心原理、类成员、完整代码实现、应用场景全方位解析 osgFX::Scribe，帮你彻底掌握这个实用特效。

osgFX::Scribe 继承关系

osgFX::Scribe 是 OSG 特效体系的标准实现，严格遵循 OSG 场景图设计规范，其继承链清晰明确：

osg::Object → osg::Node → osg::Group → osgFX::Effect → osgFX::Scribe

层级作用解析

1. osg::Object：OSG 所有对象的基类，提供引用计数、内存管理能力；
2. osg::Node：场景图节点基类，具备节点遍历、状态设置能力；
3. osg::Group：组节点，可挂载子节点，是场景组织的核心；
4. osgFX::Effect：OSG 特效基类，定义特效的统一接口（启用/禁用、渲染通道管理）；
5. osgFX::Scribe：最终实现类，专门负责刻线/轮廓渲染。

核心特性：Scribe 本身就是组节点，直接将需要添加特效的模型作为子节点挂载即可，无需修改原有模型代码，零侵入式使用。

osgFX::Scribe 核心原理

Scribe 采用双通道渲染机制，这是它实现轮廓效果的核心逻辑：

1. 第一通道（实体渲染）：按照模型原始材质、光照正常渲染实体部分；
2. 第二通道（线框渲染）：以线框模式渲染模型轮廓，通过 PolygonOffset 深度偏移技术，避免线框与实体面深度重叠导致的闪烁（Z-fighting） 问题；
3. 兼容优势：基于 OpenGL 固定管线实现，最低支持 OpenGL 1.1，无需高端显卡，全平台兼容。

osgFX::Scribe 核心类成员详解

osgFX::Scribe 提供了简洁的 API 接口，所有参数均可动态调整，满足个性化需求：

代码实现

以下代码整合了模型加载、Scribe 特效配置、场景渲染、性能优化，可直接编译运行：

1. 主代码（main.cpp）

// OSG 核心头文件
#include <osgViewer/Viewer>         // 渲染窗口管理器
#include <osg/Group>               // 场景组节点
#include <osgDB/ReadFile>          // 模型文件加载
#include <osgFX/Scribe>            // Scribe 刻线特效
#include <osgUtil/Optimizer>       // 场景优化器
#include <iostream>

int main()
{
    // 1. 创建渲染窗口
    osg::ref_ptr<osgViewer::Viewer> viewer = new osgViewer::Viewer();

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

    // 3. 加载模型（使用 OSG 自带示例模型 cessna.osg，可替换为自定义模型）
    osg::ref_ptr<osg::Node> model = osgDB::readNodeFile("cessna.osg");
    // 模型加载失败判断
    if (!model)
    {
        std::cerr << "错误：模型加载失败！请检查模型路径" << std::endl;
        return -1;
    }

    // ==================== 核心：Scribe 特效配置 ====================
    osg::ref_ptr<osgFX::Scribe> scribeEffect = new osgFX::Scribe();

    // 启用刻线特效
    scribeEffect->setEnabled(true);
    // 设置轮廓线颜色：红色（RGBA）
    scribeEffect->setWireframeColor(osg::Vec4(1.0f, 0.0f, 0.0f, 1.0f));
    // 设置轮廓线宽度：2 像素
    scribeEffect->setWireframeLineWidth(2.0f);
    // 设置深度偏移，解决线框闪烁问题
    scribeEffect->setPolygonOffset(-1.0f, -1.0f);

    // 将模型挂载到特效节点上
    scribeEffect->addChild(model.get());
    // ============================================================

    // 4. 将特效节点添加到场景根节点
    root->addChild(scribeEffect.get());

    // 5. 场景优化（提升渲染性能）
    osgUtil::Optimizer optimizer;
    optimizer.optimize(root.get());

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

应用场景与注意事项

1. 核心应用场景

• 模型选中高亮：交互系统中，鼠标点击模型时启用 Scribe 特效，实现选中反馈；
• 工业模型展示：机械零件、建筑模型的线框结构展示；
• 教学演示：三维模型拓扑结构可视化教学。

2. 注意事项

1. 模型必须是有效三角化网格，否则无法渲染轮廓线；
2. 复杂模型建议先优化（减面），避免线框渲染带来性能损耗；
3. 若轮廓线闪烁，微调 setPolygonOffset 参数（如 -2.0,-2.0）；
4. 线宽超过 5.0 可能在部分显卡上失效，建议控制在 1~3 像素。

总结

osgFX::Scribe 是 OSG 中最简单、最实用的轮廓特效类，依托 OSG 场景图架构，零代码侵入、全平台兼容，完美满足基础轮廓渲染需求。对于无需高级卡通描边的项目，它是最优选择。