当前位置：首页 > news >正文

【OSG学习笔记】Day 43: ClipPlane(裁剪)

news 2026/6/18 23:22:45

OSG 裁剪平面（ClipPlane）

在 OpenSceneGraph（OSG）三维开发中，裁剪平面（ClipPlane）是实现模型剖切、截面显示、空间可视区域筛选的核心工具。

它基于 OpenGL 裁剪平面机制，通过定义三维空间中的数学平面，对场景中的几何体进行动态裁剪，广泛应用于医疗可视化、工业仿真、建筑展示等领域。

本文将结合完整可运行代码，系统讲解 OSG ClipPlane 的继承关系、核心原理、使用方法与经典应用场景，帮助你快速掌握这一关键功能。

核心继承关系

OSG 采用面向对象的场景图架构，osg::ClipPlane并非独立类，而是严格遵循 OSG 渲染状态体系的派生类，其完整继承链如下：

osg::Object └── osg::StateAttribute └── osg::ClipPlane

关键类作用解析

osg::Object：OSG 所有对象的基类，提供引用计数、智能指针管理（ref_ptr）、对象命名等基础能力，保证内存安全。
osg::StateAttribute：渲染状态属性基类，是 OSG 控制 OpenGL 渲染状态的核心接口。裁剪平面、材质、纹理、光照等均派生自此类，统一通过StateSet管理和启用。
osg::ClipPlane：裁剪平面具体实现类，封装了 OpenGL 裁剪平面的所有功能，提供平面定义、编号设置、参数修改等接口。

核心特性：ClipPlane 属于渲染状态，必须绑定到节点的osg::StateSet上才能生效，这也是 OSG 统一管理渲染状态的设计规范。

核心原理

1. 数学基础：平面方程

ClipPlane 基于三维空间平面方程：
Ax+By+Cz+D=0Ax + By + Cz + D = 0Ax+By+Cz+D=0

A、B、C：平面法向量，决定平面的朝向和裁剪方向
D：平面偏移量，决定平面在空间中的位置

2. OSG 裁剪规则（必记）

OSG 会自动保留平面正面，裁剪平面背面：

保留区域：Ax+By+Cz+D>0Ax + By + Cz + D > 0Ax+By+Cz+D>0
裁剪区域：Ax+By+Cz+D<0Ax + By + Cz + D < 0Ax+By+Cz+D<0

简单理解：法向量指向的一侧被保留，反方向被裁剪。

3. 核心接口

// 设置裁剪平面方程 (A,B,C,D)voidsetClipPlane(doublea,doubleb,doublec,doubled);// 设置裁剪平面编号（GPU 支持 0~5 共6个裁剪平面）voidsetClipPlaneNum(unsignedintnum);

完整实战代码

以下代码实现双裁剪平面对模型的动态剖切，可直接编译运行，注释清晰易懂：

#include<osgViewer/Viewer>#include<osg/Node>#include<osg/Group>#include<osg/ClipPlane>#include<osg/StateAttribute>#include<osgDB/ReadFile>#include<osgUtil/Optimizer>intmain(){// 1. 创建OSG渲染窗口osg::ref_ptr<osgViewer::Viewer>viewer=newosgViewer::Viewer();// 2. 创建第一个裁剪平面：0x + 1y + 1z + 1 = 0（斜向裁剪）osg::ref_ptr<osg::ClipPlane>cp1=newosg::ClipPlane();cp1->setClipPlane(0,1,1,1);// 平面方程cp1->setClipPlaneNum(0);// 绑定硬件第0号裁剪平面// 3. 创建第二个裁剪平面：1x + 0y + 0z + 1 = 0（X轴方向裁剪）osg::ref_ptr<osg::ClipPlane>cp2=newosg::ClipPlane();cp2->setClipPlane(1,0,0,1);cp2->setClipPlaneNum(1);// 绑定硬件第1号裁剪平面// 4. 创建场景根节点osg::ref_ptr<osg::Group>root=newosg::Group();// 5. 加载模型（替换为你的模型路径）osg::ref_ptr<osg::Node>model=osgDB::readNodeFile("cow.osg");if(!model){OSG_WARN<<"模型加载失败！"<<std::endl;return1;}root->addChild(model);// 6. 启用裁剪平面（核心：将状态绑定到节点）root->getOrCreateStateSet()->setAttributeAndModes(cp1,osg::StateAttribute::ON);root->getOrCreateStateSet()->setAttributeAndModes(cp2,osg::StateAttribute::ON);// 7. 优化场景提升渲染效率osgUtil::Optimizer optimizer;optimizer.optimize(root);// 8. 启动渲染viewer->setSceneData(root);viewer->realize();returnviewer->run();}