【OSG学习笔记】Day 64: Scribe（刻线/轮廓高亮）-平芜编程栈

刻线/轮廓高亮特效 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

层级作用解析

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

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

osgFX::Scribe 核心原理

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

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

osgFX::Scribe 核心类成员详解

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

成员函数	功能描述	参数说明
`setEnabled(bool)`	启用/禁用特效	true：开启刻线；false：关闭，恢复普通渲染
`setWireframeColor(const osg::Vec4&)`	设置轮廓线颜色	RGBA 向量，范围 0.0~1.0，例：红色`osg::Vec4(1,0,0,1)`
`setWireframeLineWidth(float)`	设置轮廓线宽度	单位：像素，建议 1.0~5.0（过大可能导致显卡不兼容）
`setPolygonOffset(float, float)`	设置深度偏移	解决线框闪烁，默认`-1.0,-1.0`即可
`addChild(osg::Node*)`	挂载目标模型	继承自`osg::Group`，添加需要添加特效的模型节点

代码实现

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

1. 主代码（main.cpp）

// OSG 核心头文件#include<osgViewer/Viewer>// 渲染窗口管理器#include<osg/Group>// 场景组节点#include<osgDB/ReadFile>// 模型文件加载#include<osgFX/Scribe>// Scribe 刻线特效#include<osgUtil/Optimizer>// 场景优化器#include<iostream>intmain(){// 1. 创建渲染窗口osg::ref_ptr<osgViewer::Viewer>viewer=newosgViewer::Viewer();// 2. 创建场景根节点osg::ref_ptr<osg::Group>root=newosg::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=newosgFX::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();returnviewer->run();}