麻辣GIS微信平台

更多 GIS 干货

微信关注不错过

Cesium API - ModelGraphics 中文文档

本文介绍下Cesium中 ModelGraphics API的详细使用说明。

ModelGraphics API 调用方法

new Cesium.ModelGraphics(options)
基于 glTF 的3D模型,这是WebGL,Op​​enGL ES和OpenGL的运行时资产格式。 模型的位置和方向由包含它的 Entity 确定。

Cesium包括对glTF几何,材质,动画和蒙皮的支持。当前不支持照相机和灯光。

Name Type Description
options Object optional 此对象拥有以下属性:
Name Type Default Description
show Property true optional 指定显隐性。
uri Property optional glTF资源路径。
scale Property 1.0 optional 放大比例。
minimumPixelSize Property 0.0 optional 一个数字属性,用于指定模型的最小像素大小,而不考虑缩放。
maximumScale Property optional 模型最大比例尺大小. 在这个比例尺内模型模型大小缩放受minimumPixelSize限制,超过这个比例尺,不受minimumPixelSize限制
incrementallyLoadTextures Property true optional 设置在加载模型后纹理是否可以继续流入,默认是true,据说是在动态修改贴图的时候使用的。
runAnimations Property true optional 指定是否应该启动模型中指定的gltf动画。
clampAnimations Property true optional 指定glTF动画是否应在没有关键帧的持续时间内保持最后一个姿势。
shadows Property ShadowMode.ENABLED optional 枚举属性。从每个光源投射或接收阴影的模式。
heightReference Property HeightReference.NONE optional 相对于地形的位置。
silhouetteColor Property Color.RED optional 指定的模型边框颜色 Color
silhouetteSize Property 0.0 optional 边框大小(像素)。
color Property Color.WHITE optional 指定ColorColor与模型的渲染颜色混合的属性 Color
colorBlendMode Property ColorBlendMode.HIGHLIGHT optional 一个枚举属性,指定颜色混合模式。
colorBlendAmount Property 0.5 optional 混合模式的强度值。当colorBlendMode为Cesium.ColorBlendMode.MIX时有效,范围0-1,0表示不和颜色混合,1则表示替换。
imageBasedLightingFactor Property new Cartesian2(1.0, 1.0) optional 指定基于漫反射和镜面反射图像的照明的属性.
lightColor Property optional 指定光源颜色。默认为 undefined
distanceDisplayCondition Property optional 指定在距相机某个距离内显示。
nodeTransformations PropertyBag optional 一个对象,其中的键是节点的名称,而值是 TranslationRotationScale 属性,描述了要应用于该节点的转换。 转换是在glTF中指定的节点现有转换之后应用的,并且不会替换节点现有转换。(轮胎转动就需要该属性。)
articulations PropertyBag optional 模型关节(见CZML Model articulation 示例)它的键由关节名称,单个空格和阶段名称组成,值是数字属性。
clippingPlanes Property optional 指定 ClippingPlaneCollection 属性,用于有选择地禁用渲染模型。
演示Demo:
参考:

成员变量

设置/获取模型关节。(见CZML Model articulation 示例)它的键由关节名称,单个空格和阶段名称组成,值是数字属性。
设置/获取指定glTF动画是否应在没有关键帧的持续时间内保持最后一个姿势。
Default Value: true
设置/获取ClippingPlaneCollection 属性。用于有选择地禁用渲染模型。
设置/获取指定ColorColor与模型的渲染颜色混合的属性。
Default Value: Color.WHITE
设置/获取混合模式的强度值(0-1)。
Default Value: 0.5
设置/获取颜色混合模式。
Default Value: ColorBlendMode.HIGHLIGHT
readonlydefinitionChanged : Event
获取每当更改或修改属性或子属性时引发的事件。
distanceDisplayCondition : Property
设置/获取显示条件DistanceDisplayCondition,即在距相机某个距离内显示。
设置/获取相对于地形的位置HeightReference
Default Value: HeightReference.NONE
imageBasedLightingFactor : Property
指定基于漫反射和镜面反射图像的照明的属性Cartesian2
incrementallyLoadTextures : Property
在加载模型后纹理是否可以继续流入,默认是true,据说是在动态修改贴图的时候使用的。
指定光源颜色Cartesian3
设置/获取模型最大比例尺大小. 在这个比例尺内模型模型大小缩放受ModelGraphics#minimumPixelSize限制, 超过这个比例尺,不受ModelGraphics#minimumPixelSize限制. .
设置/获取 模型的最小像素大小,而不考虑缩放。
Default Value: 0.0
置要应用于此模型的节点转换集。这表示为 PropertyBag ,其中的键是节点的名称, 值是 TranslationRotationScale 属性,用于描述要应用于该节点的转换。 转换是在glTF中指定的节点现有转换之后应用的,并且不会替换节点现有转换。
设置/获取指定是否应该启动模型中指定的gltf动画。
Default Value: true
设置/获取放大比例。
Default Value: 1.0
设置/获取 从每个光源投射或接收阴影的模式。
Default Value: ShadowMode.ENABLED
设置/获取显隐性。
Default Value: true
设置/获取指定的模型边框颜色 Color
Default Value: Color.RED
设置/获取边框大小(像素)。
Default Value: 0.0
设置/获取模型路径。

内置方法

复制实例。
Name Type Description
result ModelGraphics optional 用来存储结果的对象。
返回值:
修改后的结果参数或一个新实例(如果未提供)。
合并两个对象的属性,最终合并出的属性有以下特点: 就某个属性来说,如果A的属性已定义,则合并出的C的属性即为A的属性,反之C中将为B的属性。
Name Type Description
source ModelGraphics 要被合并到这个对象的对象。

其他API

Cesium中文API文档手册(v1.63.1版本)参考:《Cesium中文API文档手册(v1.63.1版本)

相关阅读

麻辣GIS-Sailor

作者:

GIS爱好者,学GIS,更爱玩GIS。

声明

1.本文所分享的所有需要用户下载使用的内容(包括但不限于软件、数据、图片)来自于网络或者麻辣GIS粉丝自行分享,版权归该下载资源的合法拥有者所有,如有侵权请第一时间联系本站删除。

2.下载内容仅限个人学习使用,请切勿用作商用等其他用途,否则后果自负。

手机阅读
公众号关注
知识星球
手机阅读
麻辣GIS微信公众号关注
最新GIS干货
关注麻辣GIS知识星球
私享圈子

留言板(小编看到第一时间回复)