ModelGraphics

new Cesium.ModelGraphics(options)

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

Cesium 支持 glTF 几何图形、材质、动画和绑定功能。 目前不支持相机和光源。

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

Members

获取或设置应用于此模型的关节值集合。这表示为 PropertyBag,其中键由 关节名称、一个空格和阶段名称组成。
获取或设置布尔属性,指定在没有关键帧的时间段内,glTF 动画是否应保持最后的姿态。
Default Value: true
指定用于选择性禁用模型渲染的 ClippingPlaneCollection 的属性。
获取或设置指定 Color 的属性,该属性与模型渲染颜色混合。
Default Value: Color.WHITE
指定当 colorBlendMode 为 MIX 时的颜色强度的数值属性。 值为 0.0 时呈现模型渲染颜色,值为 1.0 时呈现纯色,介于两者之间的值导致两者的混合。
Default Value: 0.5
获取或设置枚举属性,指定颜色如何与模型混合。
Default Value: ColorBlendMode.HIGHLIGHT
获取或设置要应用于此模型的 CustomShader 属性。当 undefined 时,不使用自定义着色器代码。
当属性或子属性发生更改或修改时触发的事件。

distanceDisplayCondition : Property|undefined

获取或设置 DistanceDisplayCondition 属性,指定从相机的距离以显示该模型。

enableVerticalExaggeration : Property|undefined

获取或设置布尔属性,指定当 Scene.verticalExaggeration 设置为非 1.0 的值时,模型是否在椭球法线方向上夸张。
Default Value: true
获取或设置指定 HeightReference 的属性。
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 optional 存储结果的对象。
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 一个数值属性,指定统一线性缩放。
enableVerticalExaggeration Property | boolean <optional>
true 一个布尔属性,指定当 Scene.verticalExaggeration 设置为非 1.0 的值时,模型是否在椭球法线方向上夸张。
minimumPixelSize Property | number <optional>
0.0 一个数值属性,指定模型的近似最小像素大小,忽略缩放。
maximumScale Property | number <optional>
模型的最大缩放大小,最低像素大小的上限。
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 一个数值属性,指定当 colorBlendModeMIX 时的颜色强度。值为 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
customShader Property | CustomShader <optional>
一个属性,指定应用于该模型的 CustomShader
需要帮助?获得答案的最快方法是来自社区和团队 Cesium Forum.