Cesium官方教程7–三维模型 三维模型 (3D Models)

原文地址: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 变量。

var scene = viewer.scene;

下来,使用Cesium.Model.fromGltf 加载汽车模型 ,添加下面的代码:

var modelMatrix = Cesium.Transforms.eastNorthUpToFixedFrame(
    Cesium.Cartesian3.fromDegrees(-75.62898254394531, 40.02804946899414, 0.0));
var model = scene.primitives.add(Cesium.Model.fromGltf({
    url : '../../../../Apps/SampleData/models/GroundVehicle/GroundVehicle.glb',
    modelMatrix : modelMatrix,
    scale : 200.0
}));

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.6289825439453140.02804946899414)为原点的enu(east-north-up )局部坐标系。为了移动模型,可以随时修改模型的 modelMatrix 属性。

为了能看见坐标系统,使用Cesium的调试工具, 在第4行的var viewer = ...之后添加如下代码:

viewer.extend(Cesium.viewerCesiumInspectorMixin);

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调用后,添加下面的代码:

Cesium.when(model.readyPromise).then(function(model) {
    model.activeAnimations.addAll({
        loop : Cesium.ModelAnimationLoop.REPEAT
    });
});

因为动画也是存储在glTF模型里,所以需要等待readyPromise执行后才能访问他们。addAll 方法调用后播放模型的所有动画。Cesium.ModelAnimationLoop.REPEAT参数设置后,会一直循环播放动画,直到activeAnimations集合里删除了对应的动画。如果要播放某一个特定动画,那么使用 add 方法,传一个动画 id (glTF文件内部定义的)。

除了loop 选项,addAlladd 函数提供了一些列的参数选项,用来控制动画的开始、结束、播放速度,以及播放方向。比如下面的代码设定动画逆向按照半速(相对Cesium时钟)播放:

model.activeAnimations.addAll({
    loop : Cesium.ModelAnimationLoop.REPEAT,
    speedup : 0.5,
    reverse : true
});

add 函数返回一个 ModelAnimation 类实例 (addAll 返回一个该类的实例数组), 这个类包含了动画的开始、停止、每帧更新的事件。比如可以用来控制一个动画在另一个结束后开始播放。具体查看 start, stop, 和update 事件.

动画是和Cesium时钟同步的,所以可以在动画播放控件上按下播放按钮控制它。也可以通过该控件和时间线的加速、减速、逆向播放功能来控制动画的状态。

时间线(Timeline)

为了让场景中的动画自动播放,可以用下面的代码来初始化Viewer

var viewer = new Cesium.Viewer('cesiumContainer', {
    shouldAnimate : true
});

拾取

和Cesium的所有图元一样, 如果模型被选中了,那么 Scene.pick 的返回值将包括 Model 类的实例。同时,glTF中的节点(node)id 和 三角网(mesh)id 也会被返回。用这个可以判定精确的模型点击部位。下面的代码在控制台输出了鼠标所在位置对应的glTF模型中的节点和三角网。

var handler = new Cesium.ScreenSpaceEventHandler(scene.canvas);
handler.setInputAction(
    function (movement) {
        var pick = scene.pick(movement.endPosition);
        if (Cesium.defined(pick) && Cesium.defined(pick.node) && Cehack.mesh)) {
            console.log('node: ' + pick.node.name + '. mesh: ' + pick.mesh.name);
        }
    },
    Cesium.ScreenSpaceEventType.MOUSE_MOVE
);

把 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中展示

如果还是无法预览,那就是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文件。我们也知道不是所有人都愿意共享它的模型数据,但是如果你共享了,那么对于解决问题很有帮助。
  • 当模型加载的时候 浏览器控制台窗口输出的所有异常信息 。

You may also like...