OSwitch 开关节点
在 OpenSceneGraph（OSG）的场景管理体系中，osg::Switch（开关节点）是实现「子节点显隐控制」的核心组件——它能灵活控制场景中任意子节点的渲染状态（显示/隐藏），无需删除/重建节点，是实现「按需渲染」的轻量化方案。
本文将从核心特性、继承关系、实战代码三个维度，全面解析 Switch 节点的使用方法。
Switch 节点核心定位
osg::Switch 本质是 osg::Group 的子类，核心能力是为每个子节点绑定一个「布尔开关」：
- 开关为
true：子节点参与场景渲染、遍历，正常显示； - 开关为
false：子节点被完全屏蔽（不渲染、不参与场景遍历）； - 核心价值：动态控制节点可见性，无需修改场景树结构，性能开销极低（仅修改状态标记）。
典型应用场景：
- 3D 场景中物体的「显示/隐藏」（如开关模型、UI 元素）；
- 多模型切换（如奶牛/滑翔机二选一显示）；
- 调试阶段临时屏蔽部分节点（如隐藏复杂模型，聚焦核心逻辑）。
Switch 节点继承关系
Switch 属于 OSG 组节点体系，完整继承链如下：
osg::Object
↓ （所有OSG对象的根基类）
osg::Node
↓ （所有场景节点的基类）
osg::Group
↓ （组节点，可包含多个子节点）
osg::Switch
（开关节点，新增子节点显隐控制能力）
关键继承逻辑
- 从
osg::Group继承： 完全复用Group的核心能力（addChild()/removeChild()管理子节点），仅新增「开关状态管理」； - 从
osg::Node继承： 可直接加入场景树（如root->addChild(switch.get())），符合 OSG 场景管理的统一规则； - 轻量级扩展：
Switch 仅在
Group基础上增加「布尔状态数组」，内存/性能开销可忽略。
Switch 核心 API（常用操作）
| API 方法 | 作用 | 示例 |
|---|---|---|
addChild(Node* child, bool visible) | 添加子节点并设置初始可见性 | switch->addChild(cow.get(), false)（隐藏奶牛） |
setChildValue(Node* child, bool visible) | 动态修改子节点可见性 | switch->setChildValue(glider.get(), true)（显示滑翔机） |
getChildValue(Node* child) | 获取子节点当前可见性 | bool isShow = switch->getChildValue(cow.get()) |
setSingleChildOn(int index) | 仅显示指定索引的子节点（其余隐藏） | switch->setSingleChildOn(1)（仅显示第2个子节点） |
setAllChildrenOn() | 显示所有子节点 | switch->setAllChildrenOn() |
setAllChildrenOff() | 隐藏所有子节点 | switch->setAllChildrenOff() |
实战解析：Switch 节点控制奶牛/滑翔机显隐
结合前文的完整代码，我们拆解 Switch 节点的核心使用流程：
步骤1：加载待控制的模型节点
// 加载奶牛模型（待隐藏）
osg::ref_ptr<osg::Node> node1 = osgDB::readNodeFile("cow.osg");
// 加载滑翔机模型（待显示）
osg::ref_ptr<osg::Node> node2 = osgDB::readNodeFile("glider.osg");
- 先加载需要切换显隐的两个模型，作为 Switch 节点的子节点。
步骤2：创建 Switch 节点并绑定子节点
// 创建 Switch 核心节点
osg::ref_ptr<osg::Switch> switchNode = new osg::Switch();
// 添加奶牛模型，设置为「隐藏」（第二个参数 false）
switchNode->addChild(node1.get(), false);
// 添加滑翔机模型，设置为「显示」（第二个参数 true）
switchNode->addChild(node2.get(), true);
- 核心参数：
addChild的第二个布尔值直接决定子节点初始状态； get()作用：从osg::ref_ptr中提取裸指针，满足addChild的参数要求（接收osg::Node*）。
步骤3：将 Switch 节点加入场景树
// 根节点添加 Switch 节点（Switch 本身也是 Node 子类）
root->addChild(switchNode.get());
- Switch 节点作为「控制容器」，只需将其加入场景树，即可自动管理子节点的显隐。
步骤4：运行程序验证效果
编译运行后，窗口中仅显示滑翔机，奶牛模型被完全隐藏——这正是 Switch 节点的核心作用：无需删除奶牛节点，仅通过开关状态屏蔽其渲染。
扩展：动态切换显隐（核心进阶用法）
若需在程序运行中切换模型显隐（如按键盘触发），只需调用 setChildValue：
// 示例：隐藏滑翔机，显示奶牛
switchNode->setChildValue(node2.get(), false); // 隐藏滑翔机
switchNode->setChildValue(node1.get(), true); // 显示奶牛
- 无需重建场景树，仅修改开关状态，即可实时切换模型显示，性能无损耗。
关键对比：Switch 节点 vs 手动删除节点
很多新手会问：「直接删除/添加节点也能控制显隐，为什么用 Switch？」我们做核心对比：
| 维度 | osg::Switch 节点 | 手动删除/添加节点 |
|---|---|---|
| 性能开销 | 极低（仅修改状态标记） | 高（需重建场景树、重新优化） |
| 复用性 | 子节点始终存在，可随时恢复显示 | 节点被删除后需重新加载/创建 |
| 开发成本 | 一行代码切换状态 | 需编写删除/添加逻辑，易出错 |
| 内存占用 | 子节点内存始终保留（按需渲染） | 删除节点后内存释放，但恢复需重新加载 |
结论
- 短期隐藏、需复用的节点：用
osg::Switch（最优选择）； - 永久删除、无需复用的节点：手动删除（节省内存）。
完整可运行代码
源码路径：gitee switch
#include <osgViewer/Viewer>
#include <osg/Group>
#include <osg/Switch>
#include <osgDB/ReadFile>
#include <osgUtil/Optimizer>
int main() {
osg::ref_ptr<osgViewer::Viewer> viewer = new osgViewer::Viewer();
osg::ref_ptr<osg::Group> root = new osg::Group();
// 加载模型
osg::ref_ptr<osg::Node> cow = osgDB::readNodeFile("cow.osg");
osg::ref_ptr<osg::Node> glider = osgDB::readNodeFile("glider.osg");
// 创建 Switch 节点并控制显隐
osg::ref_ptr<osg::Switch> switchNode = new osg::Switch();
switchNode->addChild(cow.get(), false); // 隐藏奶牛
switchNode->addChild(glider.get(), true); // 显示滑翔机
// 构建场景
root->addChild(switchNode.get());
osgUtil::Optimizer optimizer;
optimizer.optimize(root.get());
// 渲染
viewer->setSceneData(root.get());
return viewer->run();
}
总结
- 核心定位：
osg::Switch是osg::Group的子类，通过「布尔开关」轻量级控制子节点显隐； - 核心价值：无需修改场景树结构，动态切换节点可见性，性能开销极低；
- 实战关键：
addChild(child, visible)设置初始状态，setChildValue动态切换状态； - 使用场景：模型切换、UI 显隐、调试屏蔽节点等「按需渲染」场景。
Switch 节点是 OSG 场景管理中最常用的「轻量化控制工具」，掌握它能大幅简化「节点显隐」的开发逻辑，避免不必要的场景树修改，提升程序稳定性与性能。
