【OSG学习笔记】Day 13: CoordinateSystemNode（坐标系节点）

Bynull

329人浏览 · 2026-03-25 11:58:34

Bynull · 2026-03-25 11:58:34 发布

在这里插入图片描述

`CoordinateSystemNode`

在基于 OSG 开发三维地球、GIS 地理信息系统、仿真导航等项目时，统一、标准的空间坐标体系是项目的基石。osg::CoordinateSystemNode 正是 OSG 中用于定义全局空间参考、绑定地球椭球体模型的核心节点，它让普通的三维模型升级为符合真实地理标准的地理空间模型。

本文结合地球渲染实战代码，深度讲解 CoordinateSystemNode 的作用、类继承关系、使用场景，让你彻底理解它在 OSG 地理可视化中的核心价值。

什么是 `CoordinateSystemNode`？

osg::CoordinateSystemNode 是 OSG 提供的空间坐标系统管理节点，它的核心作用是：

定义场景的全局坐标系
绑定标准地球椭球体模型（如 WGS84）
为 GIS 功能（经纬度、坐标转换、地形加载）提供底层支撑
不改变模型视觉外观，只提供数学与空间参考

简单说：

没有它，你的地球只是普通球体
加上它，你的场景就是标准地理空间

`CoordinateSystemNode` 类继承关系

OSG 采用单根继承结构，CoordinateSystemNode 的继承链非常清晰：

osg::Object
  └── osg::Node
       └── osg::Group
            └── osg::CoordinateSystemNode

层级含义

osg::Object：OSG 所有对象的基类，提供引用计数、内存自动管理
osg::Node：场景节点基类，提供包围盒、节点名称、状态集能力
osg::Group：组节点，可以挂载子节点（地球模型、模型、瓦片都能挂）
osg::CoordinateSystemNode：坐标系统节点，新增椭球体、坐标系管理接口

核心依赖类

osg::EllipsoidModel：WGS84 椭球体模型，定义真实地球形状
osg::Vec3：空间坐标
osg::Node：所有挂载在坐标系统下的子节点

`CoordinateSystemNode` 核心作用

统一空间参考
让整个场景使用一套标准坐标，避免坐标错乱。
绑定 WGS84 地球椭球体
内置赤道半径、极半径、扁平率，完全匹配 GPS/北斗/谷歌地图使用的地球模型。
支撑 GIS 功能
经纬度定位、坐标转换、地图瓦片加载、测量距离与面积。
作为地理场景根节点
所有地理数据（地球、建筑、航线）都挂载在它下面。

结合地球代码实战解析

下面使用我们前面编写的标准地球渲染代码，讲解 CoordinateSystemNode 的真实用法。

完整示例代码

#include <osgViewer/Viewer>
#include <osg/Node>
#include <osg/Geode>
#include <osg/ShapeDrawable>
#include <osgDB/ReadFile>
#include <osg/CoordinateSystemNode>  // CoordinateSystemNode 头文件
#include <osgUtil/Optimizer>
#include <string>

// 创建带坐标系的地球模型
osg::ref_ptr<osg::Node> createEarth() 
{
    // 1. 创建几何体节点，装载球体
    osg::ref_ptr<osg::Geode> geode = new osg::Geode();
    osg::ref_ptr<osg::ShapeDrawable> drawable = new osg::ShapeDrawable(
        new osg::Sphere(osg::Vec3(0,0,0), 6378137.0)  // WGS84 赤道半径
    );
    geode->addDrawable(drawable);

    // 加载地球纹理（可选）
    osg::ref_ptr<osg::Image> image = osgDB::readImageFile("../../Images/land_shallow_topo_2048.jpg");
    if (image) {
        osg::ref_ptr<osg::Texture2D> tex = new osg::Texture2D(image);
        geode->getOrCreateStateSet()->setTextureAttributeAndModes(0, tex);
    }

    // ==================== CoordinateSystemNode 核心用法 ====================
    // 2. 创建坐标系统节点
    osg::ref_ptr<osg::CoordinateSystemNode> csn = new osg::CoordinateSystemNode;

    // 3. 绑定 WGS84 标准椭球体
    csn->setEllipsoidModel(new osg::EllipsoidModel());

    // 4. 将地球模型作为子节点挂载到坐标系统下
    csn->addChild(geode.get());

    // 5. 返回坐标系节点（作为地理场景根）
    return csn.get();
}

int main() 
{
    osg::ref_ptr<osg::Group> root = new osg::Group();
    root->addChild(createEarth());  // 添加地理坐标系场景

    osg::ref_ptr<osgViewer::Viewer> viewer = new osgViewer::Viewer();
    osgUtil::Optimizer optimizer;
    optimizer.optimize(root.get());
    
    viewer->setSceneData(root.get());
    viewer->realize();
    return viewer->run();
}