ModelGraphics

new Cesium.ModelGraphics(options)

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

Cesium includes support for glTF geometry, materials, animations, and skinning. Cameras and lights are not currently supported.

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

Members

获取或设置要应用于此模型的联接值集。它表示为PropertyBag,其中键 由发音的名称、单个空格和舞台的名称组成。

clampAnimations : Property|undefined

获取或设置布尔属性,该属性指定glTF动画是否应在没有关键帧的持续时间内保持最后一个姿势。
Default Value: true

clippingPlanes : Property|undefined

指定ClippingPlaneCollection的属性,用于有选择地禁用对模型的呈现。
获取或设置指定与模型呈现颜色混合的Color属性。
Default Value: Color.WHITE

colorBlendAmount : Property|undefined

指定colorBlendMode混合时的颜色强度的数字属性。 值0.0将生成模型的渲染颜色,而值1.0将生成纯色,其中 介于两者之间的任何值都会导致两者的混合。
Default Value: 0.5

colorBlendMode : Property|undefined

获取或设置指定颜色如何与模型混合的枚举属性。
Default Value: ColorBlendMode.HIGHLIGHT

readonly definitionChanged : Event

获取每当更改或修改属性或子属性时引发的事件。

distanceDisplayCondition : Property|undefined

获取或设置DistanceDisplayCondition属性,该属性指定此模型将显示在距摄影机的距离。

heightReference : Property|undefined

获取指定属性的6866165或。
Default Value: HeightReference.NONE

imageBasedLightingFactor : Property|undefined

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

incrementallyLoadTextures : Property|undefined

获取或设置指定纹理 可能在加载模型后继续流式输入。
为模型着色时指定Cartesian3灯光颜色的属性。当undefined时,将使用场景的浅色。

maximumScale : Property|undefined

获取或设置指定最大刻度的数值属性 模型的大小。此属性用作的上限 ModelGraphics#minimumPixelSize

minimumPixelSize : Property|undefined

获取或设置指定近似最小值的数值属性 模型的像素大小与缩放无关。这可以用来确保 即使在查看器缩小时,模型也是可见的。当0.0, 没有强制最小大小。
Default Value: 0.0
获取或设置要应用于此模型的一组节点转换。它表示为PropertyBag,其中键 节点名和值是TranslationRotationScale属性,用于描述要应用于该节点的转换。 转换将在glTF中指定的节点的现有转换之后应用,并且不会替换节点的现有转换。

runAnimations : Property|undefined

获取或设置用于指定是否应运行glTF动画的布尔属性。
Default Value: true
获取或设置指定统一线性刻度的数值属性 对于这个型号。大于1.0的值会增加模型的大小,而 小于1.0的值会减小该值。
Default Value: 1.0
获取或设置指定模型 从光源投射或接收阴影。
Default Value: ShadowMode.ENABLED
获取或设置用于指定模型可见性的布尔属性。
Default Value: true

silhouetteColor : Property|undefined

获取或设置指定架构的Color的属性。
Default Value: Color.RED

silhouetteSize : Property|undefined

获取或设置指定轮廓大小(以像素为单位)的数值属性。
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 指定统一线性比例的数值特性。
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的属性,用于有选择地禁用对模型的呈现。