Cesium官方教程7--三维模型

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Cesium官方教程7--三维模型相关的知识,希望对你有一定的参考价值。

原文地址:https://cesiumjs.org/tutorials/3D-Models-Tutorial/
三维模型 (3D Models)
这篇教程给大家介绍,如何在Cesium中通过Primitive API来转换、加载、使用三维模型。如果你是新手,建议你先看下这篇 空间数据可视化教程 的三维模型部分。
Cesium支持包含关键帧(key-frame)动画、骨骼(skinning)动画 的glTF格式的三维模型,并且支持模型节点(node)的拾取。 glTF是 Khronos Group 定义的一个基于web上的新兴三维模型格式行业标准。Khronos Group是WebGL和 COLLADA的背后财团。Cesium提供了一个 在线的工具 ,可以把COLLADA(.dae)模型转换为专为Cesium优化的glTF格式。
快速开始
Cesium内置了一些随时可用的glTF模型:

带螺旋桨动画的飞机模型
带轮子动画的汽车模型
带行走骨骼动画的人物模型
热气球模型
牛奶卡车 Draco压缩
技术分享图片
飞机
技术分享图片
卡车
技术分享图片
人物
技术分享图片
牛奶车
这些模型都在 Apps/SampleData/models目录下有各自的存放目录。一部分还包含一个COLLADA (.dae)格式的源文件(Cesium中不需要),一个glTF格式(.gltf)、一个二进制glTF格式 (.glb)。
下来我们写示例代码. 打开Sandcastle Hello World 示例。在 var viewer = ... 之后第4行,增加一个 scene 变量。
技术分享图片
下来,使用Cesium.Model.fromGltf 加载汽车模型 ,添加下面的代码:
技术分享图片
按F8运行,使用右上角的位置查询工具,定位到 Exton, PA。
技术分享图片
地理位置查询定位

现在我们垂直俯视观察这个汽车了。使用鼠标右键拉近一点,然后鼠标中键按下旋转视角放平一点。
技术分享图片
拉近视角

Cesium.Model.fromGltf方法异步载入了glTF 以及它的一些外部资源文件,完全载入(响应了 readyPromise)之后进行了渲染。只需要gltf文件的url路径,示例中就是这个../../../../Apps/SampleData/models/GroundVehicle/GroundVehicle.glb。
fromGltf有个可选的参数scale 可以用来放大缩小模型。很多实际大小的模型都相对地球来说太小了,为了测试可以用 scale把模型放大一些,有时候甚至可以非常大,比如200000.0:
技术分享图片
放大模型
fromGltf也可以设置一个 modelMatrix 去放置或者旋转模型。这个参数会用来创建模型的局部坐标系。我们这里使用了 Cesium.Transforms.eastNorthUpToFixedFrame去创建了一个以经纬度(-75.62898254394531,40.02804946899414)为原点的enu(east-north-up )局部坐标系。为了移动模型,可以随时修改模型的 modelMatrix 属性。
为了能看见坐标系统,使用Cesium的调试工具, 在第4行的var viewer = ...之后添加如下代码:
技术分享图片
按 F8运行,调试工具已经显示在右上角了。展开 Primitives面板,点击Pick a Primitive,然后在场景中点击汽车模型,然后勾选show reference frame。
技术分享图片
参考坐标系

这里x 轴(正东向)是红色的, y 轴(正北向)是绿色的,z 轴(垂直向上)是蓝色的。
如果加载飞机或者人物的模型,那么只需要修改代码里的 url参数为 ‘../../../../Apps/SampleData/models/CesiumAir/Cesium_Air.glb‘ 或者‘../../../../Apps/SampleData/models/CesiumMan/Cesium_Man.glb‘。完整的配置参数 查看用户手册Cesium.Model.fromGltf 。
动画
上面的模型都自带了模型数据制作者内置的关键帧动画,数据制作者定义了一些关键位置的模型姿态,Cesium会实时插值做变换展示一个平滑的动画效果。 为了能播放动画,在 Cesium.Model.fromGltf调用后,添加下面的代码:
技术分享图片
因为动画也是存储在glTF模型里,所以需要等待readyPromise执行后才能访问他们。addAll 方法调用后播放模型的所有动画。Cesium.ModelAnimationLoop.REPEAT参数设置后,会一直循环播放动画,直到activeAnimations集合里删除了对应的动画。如果要播放某一个特定动画,那么使用 add 方法,传一个动画 id (glTF文件内部定义的)。
除了loop 选项,addAll和 add 函数提供了一些列的参数选项,用来控制动画的开始、结束、播放速度,以及播放方向。比如下面的代码设定动画逆向按照半速(相对Cesium时钟)播放:
技术分享图片
add 函数返回一个 ModelAnimation 类实例 (addAll 返回一个该类的实例数组), 这个类包含了动画的开始、停止、每帧更新的事件。比如可以用来控制一个动画在另一个结束后开始播放。具体查看 start, stop, 和update 事件.
动画是和Cesium时钟同步的,所以可以在动画播放控件上按下播放按钮控制它。也可以通过该控件和时间线的加速、减速、逆向播放功能来控制动画的状态。
技术分享图片
时间线(Timeline)
为了让场景中的动画自动播放,可以用下面的代码来初始化Viewer:
技术分享图片
拾取
和Cesium的所有图元一样, 如果模型被选中了,那么 Scene.pick 的返回值将包括 Model 类的实例。同时,glTF中的节点(node)id 和 三角网(mesh)id 也会被返回。用这个可以判定精确的模型点击部位。下面的代码在控制台输出了鼠标所在位置对应的glTF模型中的节点和三角网。
技术分享图片
把 COLLADA(dae)转 glTF
可以使用Cesium的 在线工具. 把 .dae 和图片文件转为一个内嵌图片资源的.gltf文件。
问题
如果Cesium加载三维模型有问题,那么首先定位问题出现在哪个阶段:

Max,Maya, Modo, SketchUp 等建模工具的 COLLADA 导出器有没有问题
COLLADA-to-glTF转换工具有没有问题
Cesium glTF 渲染代码有没有问题

Mac 上解决问题
在Mac系统上,判定一个COLLADA 文件是否导出正常,双击.dae 文件,它应该会显示在预览窗口上。如果模型带动画,那么鼠标移动到这个窗口上会显示一个动画控制的工具栏。
技术分享图片
Mac 模型预览窗口

如果COLLADA 文件有问题,那么预览界面会提示错误。这一般是由于建模工具的导出器有bug。
技术分享图片
模型预览错误
为了解决这个问题,安装 Xcode,然后右键单机这个.dae 文件,选择 Open With -> Xcode。
技术分享图片
Xcode 打开

Xcode 如同预览窗口一样显示模型,但是它有更多额外功能,比如选择一个独立的节点。Xcode实际上对于预览窗口上显示不了的dae有很多解决办法。如果模型可以在Xcode 中加载,那么选择File - Save 保存一下就能解决问题,这时候预览就没有问题了。
Xcode 打开
技术分享图片
Xcode中展示

如果还是无法预览,那就是COLLADA 导出器有严重问题了。首先确认你使用的最新版的建模工具,然后试下 这篇文章。如果还不能解决,那么给建模工具提bug去吧。也可以试下先导出.fbx 格式,然后在其他工具中导入fbx,再导出dae。
Windows 上解决问题
Windows上,VS2013(包括免费的社区版本)包含一个模型编辑器,他可以加载COLLADA模型。判断一个COLLADA文件是否导出正常,把 .dae 文件拖拽到VS窗口里,如果正常显示,就是正常的。否则,可能有一些bug。试下 这篇文章。果还不能解决,那么给建模工具提bug去吧。也可以试下先导出.fbx 格式,然后在其他工具中导入fbx,再导出dae。
技术分享图片
Visual Studio

如果你没有Visual Studio,Autodesk 提供了一个基于WebGL的可视化工具 。可以把模型拖拽进去,无需登陆就能测试。但是这个工具不支持动画,如果模型包含图片,那么上传一个zip压缩包,把dae和图片都打进去。
Cesium 上解决问题
COLLADA 文件准备好之后,那么使用[在线工具 ] (https://cesiumjs.org/convertmodel.html)转下格式再在Cesium中加载。如果没于加载成功,那么说明这个转换工具或者Cesium有bug。为了获取更多信息,打开浏览器的调试工具 (Chrome快捷键Ctrl-Shift-I ) ,并且选中 Pause on all exceptions (Chrome在 Sources面板里 ), 然后刷新页面.
技术分享图片

Pause On All Exceptions

也可以在Cesium论坛 上发一个帖子,我们修正bug后会提供一个解决方法。如果你发帖子,请包含下面内容:

COLLADA 源文件 和转换后的 glTF文件。我们也知道不是所有人都愿意共享它的模型数据,但是如果你共享了,那么对于解决问题很有帮助。
当模型加载的时候 浏览器控制台窗口输出的所有异常信息 。

控制台异常

其他资源
再看下Sandcastle 中 3D models 示例。 Model 类和ModelAnimationCollection类的官方文档。
技术分享图片

以上是关于Cesium官方教程7--三维模型的主要内容,如果未能解决你的问题,请参考以下文章

基于 React hooks + Typescript + Cesium 的 三维 webgis 实战系列教程

Cesium三维地图入门教程

Cesium官方教程13--Cesium和Webpack

cesium初探之加载三维模型

基于Cesium的实景三维模型动态更新-以3Dtiles为例

基于Cesium的实景三维模型动态更新-以3Dtiles为例