cesium-osg

该项目基于 cesium-native 开源项目，实现了将 Cesium 特有的一些 3D 地理空间技术，尤其是 3DTiles 带到了 OSG（OpenSceneGraph）的运用场景中。这有点类似 osgEarth、cesium-unreal 和 cesium-unity三个开源项目。

注：cesium-unreal 和 cesium-unity 分别是 cesium for ue 和 cesium for unity两个插件的官方源码

1. 特性

• 目前支持：

  • ✅ 支持加载本地（包括 file:/// 协议） glTF/glb 模型
  • ✅ 支持加载网络（包括 HTTP/HTTPS 协议） glTF/glb 模型
  • ✅ 支持本地（包括 file:/// 协议） 3DTiles 1.0 / 1.1 模型加载和渲染
  • ✅ 支持加载网络（ HTTP/HTTPS 协议） 3D Tiles 1.0 / 1.1 模型加载和渲染
  • ✅ 支持 PBR 材质简单地映射为 OSG 中的 osg::Material（传统的 Blinn-Phong） 材质
  • ✅ 异步加载与层级细节（LOD）
  • ✅ 与 OpenSceneGraph 渲染管线无缝集成

• TODO:

  • 支持 Cesium quantized-mesh 地形数据的加载和渲染
  • 基于 WGS84 的精确地理投影
  • 支持 WMTS 影像服务数据的加载和渲染
  • 日志系统部分日志不输出
  • 内存使用过多

2. 入门

2.1 前提条件

开发环境需要如下依赖，须要事先准备好（目前仅支持 Windows）：

• CMake >= 3.20
• vcpkg
• Visual Studio 2022
• OSG-version3.6.5
• libcurl

注：你可以从这个网站：https://objexx.com/OpenSceneGraph.html 直接下载编译好的 OSG 库，也可以自己从头编译。须将 OSG （OpenSceneGraph）和 libcurl 两个编译好的库放大1个目录下，然后，在CMake生成C++项目时，通过“-DTHIRD_PARTY_DIR”参数指定该路径。你也可以完全使用vcpkg 来作为三方库的提供者，此时，“-DTHIRD_PARTY_DIR”应该等于vcpkg的安装的根目录“VCPKG_ROOT”.

2.2 克隆仓库（含子模块）

使用如下命令，克隆 cesium-osg 项目及其子项目模块

git clone --recurse-submodules https://github.com/xrui94/cesium-osg.git

如果忘记了“--recurse-submodules”参数，以克隆子项目，cesium-osg 项目，可以在项目的根目录下重新执行如下命令：

git submodule update --init --recursive

🛠 2.3 编译和构建

mkdir build
cd  build
cmake .. -G"Visual Studio 17 2022" -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX="./build/install" -DTHIRD_PARTY_DIR=C:/env/libc++
cmake --build . --config Debug

3. 致谢

cesium-osg项目受到了如下三个项目的启发，并在一定程度上使用了这些项目的部分源代码：

• osgEarth: 3D Maps & Terrain SDK / C++17
• godot-3dtiles: Godot Cesium 3D Tiles plugin
• vsgCs: Cesium client for VSG
• cesium-unreal: Bringing the 3D geospatial ecosystem to Unreal Engine