【OSG学习笔记】Day 9: Switch类

OSwitch 开关节点

在 OpenSceneGraph（OSG）的场景管理体系中，osg::Switch（开关节点）是实现「子节点显隐控制」的核心组件------它能灵活控制场景中任意子节点的渲染状态（显示/隐藏），无需删除/重建节点，是实现「按需渲染」的轻量化方案。

本文将从核心特性、继承关系、实战代码三个维度，全面解析 Switch 节点的使用方法。

Switch 节点核心定位

osg::Switch 本质是 osg::Group 的子类，核心能力是为每个子节点绑定一个「布尔开关」：

开关为 true：子节点参与场景渲染、遍历，正常显示；
开关为 false：子节点被完全屏蔽（不渲染、不参与场景遍历）；
核心价值：动态控制节点可见性，无需修改场景树结构，性能开销极低（仅修改状态标记）。

典型应用场景：

3D 场景中物体的「显示/隐藏」（如开关模型、UI 元素）；
多模型切换（如奶牛/滑翔机二选一显示）；
调试阶段临时屏蔽部分节点（如隐藏复杂模型，聚焦核心逻辑）。

Switch 节点继承关系

Switch 属于 OSG 组节点体系，完整继承链如下：

vbnet 复制代码

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：加载待控制的模型节点

cpp 复制代码

// 加载奶牛模型（待隐藏）
osg::ref_ptr<osg::Node> node1 = osgDB::readNodeFile("cow.osg");
// 加载滑翔机模型（待显示）
osg::ref_ptr<osg::Node> node2 = osgDB::readNodeFile("glider.osg");

先加载需要切换显隐的两个模型，作为 Switch 节点的子节点。

步骤2：创建 Switch 节点并绑定子节点

cpp 复制代码

// 创建 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 节点加入场景树

cpp 复制代码

// 根节点添加 Switch 节点（Switch 本身也是 Node 子类）
root->addChild(switchNode.get());

Switch 节点作为「控制容器」，只需将其加入场景树，即可自动管理子节点的显隐。

步骤4：运行程序验证效果

编译运行后，窗口中仅显示滑翔机，奶牛模型被完全隐藏------这正是 Switch 节点的核心作用：无需删除奶牛节点，仅通过开关状态屏蔽其渲染。

扩展：动态切换显隐（核心进阶用法）

若需在程序运行中切换模型显隐（如按键盘触发），只需调用 setChildValue：

cpp 复制代码

// 示例：隐藏滑翔机，显示奶牛
switchNode->setChildValue(node2.get(), false); // 隐藏滑翔机
switchNode->setChildValue(node1.get(), true);  // 显示奶牛

无需重建场景树，仅修改开关状态，即可实时切换模型显示，性能无损耗。

关键对比：Switch 节点 vs 手动删除节点

很多新手会问：「直接删除/添加节点也能控制显隐，为什么用 Switch？」我们做核心对比：

维度	osg::Switch 节点	手动删除/添加节点
性能开销	极低（仅修改状态标记）	高（需重建场景树、重新优化）
复用性	子节点始终存在，可随时恢复显示	节点被删除后需重新加载/创建
开发成本	一行代码切换状态	需编写删除/添加逻辑，易出错
内存占用	子节点内存始终保留（按需渲染）	删除节点后内存释放，但恢复需重新加载

结论

短期隐藏、需复用的节点：用 osg::Switch（最优选择）；
永久删除、无需复用的节点：手动删除（节省内存）。

完整可运行代码

源码路径：gitee switch

cpp 复制代码

#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 场景管理中最常用的「轻量化控制工具」，掌握它能大幅简化「节点显隐」的开发逻辑，避免不必要的场景树修改，提升程序稳定性与性能。