ModelGraphics

new Cesium.ModelGraphics ( options )

基于 glTF 的 3D 模型,它是 WebGL、OpenGL ES 和 OpenGL 的运行时资产格式。模型的位置和方向由包含的 Entity 确定。

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

Name Type Description
options ModelGraphics.ConstructorOptions 描述初始化选项的 可选 对象
Demo:

Members

获取或设置要应用于此模型的一组清晰度值。这表示为 PropertyBag ,其中键由关节名称、单个空格和舞台名称组成。
获取或设置布尔属性,指定 glTF 动画是否应在没有关键帧的时间段内保持最后一个姿势。
Default Value: true
指定 ClippingPlaneCollection 的属性,用于选择性地禁用渲染模型。
获取或设置指定与模型渲染颜色混合的 Color 的属性。
Default Value: Color.WHITE
colorBlendMode 为 MIX 时指定颜色强度的数字属性。值 0.0 会导致模型的渲染颜色,而值 1.0 会导致纯色,中间的任何值都会导致两者混合。
Default Value: 0.5
获取或设置 enum 属性,指定颜色如何与模型混合。
Default Value: ColorBlendMode.HIGHLIGHT
获取在更改或修改属性或子属性时引发的事件。

distanceDisplayCondition : Property |undefined

获取或设置 DistanceDisplayCondition 属性,指定该模型将在距相机多远的距离处显示。
获取或设置指定 HeightReference 的 Property。
Default Value: HeightReference.NONE

imageBasedLightingFactor : Property |undefined

指定 Cartesian2 的属性,用于缩放基于漫反射和镜面反射图像的照明对最终颜色的贡献。

incrementallyLoadTextures : Property |undefined

获取或设置布尔属性,指定加载模型后纹理是否可以继续流入。
为模型着色时指定 Cartesian3 灯光颜色的属性。当 undefined 时,将使用场景的浅色。
获取或设置指定模型的最大比例大小的数字属性。此属性用作 ModelGraphics#minimumPixelSize 的上限。
获取或设置指定模型的近似最小像素大小的数字属性,无论缩放如何。这可用于确保模型即使在查看器缩小时也是可见的。当 0.0 时,不强制执行最小大小。
Default Value: 0.0
获取或设置要应用于此模型的节点转换集。这表示为 PropertyBag ,其中键是节点的名称,值是 TranslationRotationScale 属性,描述要应用于该节点的转换。转换在 glTF 中指定的节点现有转换之后应用,并且不会替换节点的现有转换。
获取或设置布尔属性,指定是否应运行 glTF 动画。
Default Value: true
获取或设置指定此模型的统一线性比例的数字属性。大于 1.0 的值会增加模型的大小,而小于 1.0 的值会减小它。
Default Value: 1.0
获取或设置枚举属性,指定模型是投射还是接收来自光源的阴影。
Default Value: ShadowMode.ENABLED
获取或设置指定模型可见性的布尔属性。
Default Value: true
获取或设置指定轮廓 Color 的属性。
Default Value: Color.RED
获取或设置指定轮廓大小(以像素为单位)的数字属性。
Default Value: 0.0
获取或设置字符串属性,指定 glTF 资产的 URI。

Methods

复制此实例。
Name Type Description
result ModelGraphics 可选 存储结果的对象。
Returns:
修改后的结果参数或新实例(如果未提供)。
将此对象上的每个未分配属性分配给提供的源对象上相同属性的值。
Name Type Description
source ModelGraphics 要合并到此对象的对象。

Type Definitions

Cesium.ModelGraphics.ConstructorOptions

ModelGraphics 构造函数的初始化选项
Properties:
Name Type Attributes Default Description
show Property | boolean <optional>
true 一个布尔属性,指定模型的可见性。
uri Property | string | Resource <optional>
一个字符串或资源属性,指定 glTF 资产的 URI。
scale Property | number <optional>
1.0 一个数字属性,指定一个统一的线性比例。
minimumPixelSize Property | number <optional>
0.0 一个数字属性,指定模型的近似最小像素大小,无论缩放如何。
maximumScale Property | number <optional>
模型的最大比例大小。 minimumPixelSize 的上限。
incrementallyLoadTextures Property | boolean <optional>
true 确定加载模型后纹理是否可以继续流入。
runAnimations Property | boolean <optional>
true 一个布尔属性,指定是否应该启动模型中指定的 glTF 动画。
clampAnimations Property | boolean <optional>
true 一个布尔属性,指定 glTF 动画是否应该在没有关键帧的情况下保持最后一个姿势。
shadows Property | ShadowMode <optional>
ShadowMode.ENABLED 一个枚举属性,指定模型是投射还是接收来自光源的阴影。
heightReference Property | HeightReference <optional>
HeightReference.NONE 一个属性,指定高度相对于什么。
silhouetteColor Property | Color <optional>
Color.RED 指定轮廓 Color 的属性。
silhouetteSize Property | number <optional>
0.0 一个数字属性,以像素为单位指定轮廓的大小。
color Property | Color <optional>
Color.WHITE 一个属性,指定与模型的渲染 Color 混合的颜色。
colorBlendMode Property | ColorBlendMode <optional>
ColorBlendMode.HIGHLIGHT 一个枚举属性,指定颜色如何与模型混合。
colorBlendAmount Property | number <optional>
0.5 colorBlendMode MIX 时指定颜色强度的数字属性。值 0.0 会导致模型的渲染颜色,而值 1.0 会导致纯色,介于两者之间的任何值都会导致两者混合。
imageBasedLightingFactor Property | Cartesian2 <optional>
new Cartesian2(1.0, 1.0) 一个属性,指定基于漫反射和镜面反射图像的照明的贡献。
lightColor Property | Color <optional>
为模型着色时指定灯光颜色的属性。当 undefined 时,将使用场景的浅色。
distanceDisplayCondition Property | DistanceDisplayCondition <optional>
一个属性,指定该模型将在距相机多远的距离处显示。
nodeTransformations PropertyBag | Object.<string, TranslationRotationScale > <optional>
一个对象,其中键是节点的名称,值是 TranslationRotationScale 描述要应用于该节点的转换的属性。转换在 glTF 中指定的节点现有转换之后应用,并且不会替换节点的现有转换。
articulations PropertyBag | Object.<string, number> <optional>
一个对象,其中键由发音名称、单个空格和舞台名称组成,值是数字属性。
clippingPlanes Property | ClippingPlaneCollection <optional>
指定 ClippingPlaneCollection 的属性,用于选择性地禁用渲染模型。