ModelGraphics

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:
See:

Members

设置/获取模型关节。(见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
设置/获取模型路径。

Methods

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