ModelGraphics

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

Bigemap GL包括对GLTF几何体、材质、动画和蒙皮的支持。目前不支持摄像头和灯。

new ModelGraphics(options)

Parameters:

options (Object)

Name	Description
options.show `Property` default `true`	指定模型可见性的布尔属性。
options.uri `Property`	指定GLTF资源的URI的字符串或资源属性。
options.scale `Property` default `1.0`	指定统一线性比例的数值属性。
options.minimumPixelSize `Property` default `0.0`	指定模型的近似最小像素大小（不考虑缩放）的数值属性。
options.maximumScale `Property`	模型的最大比例大小。最小像素化的上限。
options.incrementallyLoadTextures `Property` default `true`	确定加载模型后纹理是否可以继续流入。
options.runAnimations `Property` default `true`	一个布尔属性，指定是否应启动模型中指定的GLTF动画。
options.clampAnimations `Property` default `true`	一个布尔属性，指定GLTF动画是否应在没有关键帧的情况下保持最后一个姿势。
options.shadows `Property` default `ShadowMode.ENABLED`	指定模型是从每个光源投射还是接收阴影的枚举属性。
options.heightReference `Property` default `HeightReference.NONE`	指定高度相对高度的属性。
options.silhouetteColor `Property` default `Color.RED`	指定轮廓`Color`的属性。
options.silhouetteSize `Property` default `0.0`	以像素为单位指定轮廓大小的数字属性。
options.color `Property` default `Color.WHITE`	指定与模型的渲染颜色混合的`Color`的属性。
options.colorBlendMode `Property` default `ColorBlendMode.HIGHLIGHT`	指定颜色如何与模型混合的枚举属性。
options.colorBlendAmount `Property` default `0.5`	当`colorBlendMode`为`MIX`时指定颜色强度的数值属性。值为0.0将生成模型的渲染颜色，值为1.0将生成纯色，两者之间的任何值都将导致二者的混合。
options.imageBasedLightingFactor `Property` default `new Cartesian2(1.0, 1.0)`	指定基于漫反射和镜面反射图像的照明的贡献的属性。
options.lightColor `Property`	指定在为模型着色时使用的灯光颜色的属性。当`undefined`时，将使用默认的日光颜色。
options.distanceDisplayCondition `Property`	一个属性，指定此模型将显示在与相机的距离。
options.nodeTransformations `PropertyBag`	一个对象，其中键是节点的名称，值是描述要应用于该节点的转换的`TranslationRotationScale`属性。转换将在GLTF中指定的节点的现有转换之后应用，并且不会替换节点的现有转换。
options.articulations `PropertyBag`	一种对象，其中键由一个连接名、一个空格和一个阶段名组成，值是数字属性。
options.clippingPlanes `Property`	指定`ClippingPlaneCollection`的属性，用于选择性地禁用呈现模型。

Members

articulations : PropertyBag

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

clampAnimations : Property

获取或设置用于指定GLTF动画是否应在没有关键帧的情况下保持最后一个姿势的布尔属性。

Default Value: true

clippingPlanes : Property

指定ClippingPlaneCollection的属性，用于选择性地禁用呈现模型。

color : Property

获取或设置指定与模型的呈现颜色混合的Color的属性。

Default Value: Color.WHITE

colorBlendAmount : Property

当colorBlendMode混合时指定颜色强度的数值属性。值为0.0将生成模型的渲染颜色，值为1.0将生成纯色，两者之间的任何值都将导致二者的混合。

Default Value: 0.5

colorBlendMode : Property

获取或设置枚举属性，该属性指定颜色如何与模型混合。

Default Value: ColorBlendMode.HIGHLIGHT

(readonly) definitionChanged : Event

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

distanceDisplayCondition : Property

获取或设置DistanceDisplayCondition属性，指定此模型将显示在距相机的距离。

heightReference : Property

获取或设置指定HeightReference的属性。

Default Value: HeightReference.NONE

imageBasedLightingFactor : Property

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

incrementallyLoadTextures : Property

获取或设置布尔属性，指定在加载模型后纹理是否可以继续流入。

lightColor : Property

在为模型着色时指定光源的Cartesian3颜色的属性。

maximumScale : Property

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

minimumPixelSize : Property

获取或设置数值属性，该属性指定模型的最小像素大小（不考虑缩放）。这可以用来确保模型即使在查看器缩小时也可见。当0.0时，不强制使用最小尺寸。

Default Value: 0.0

nodeTransformations : PropertyBag

获取或设置要应用于此模型的节点转换集。这表示为PropertyBag，其中键是节点的名称，值是TranslationRotationScale描述要应用于该节点的转换的属性。转换将在GLTF中指定的节点的现有转换之后应用，并且不会替换节点的现有转换。

runAnimations : Property

获取或设置用于指定是否应运行GLTF动画的布尔属性。

Default Value: true

scale : Property

获取或设置为此模型指定统一线性刻度的数值属性。大于1.0的值会增大模型的大小，而小于1.0的值则会减小模型的大小。

Default Value: 1.0

shadows : Property

获取或设置枚举属性，指定模型是从每个光源投射还是接收阴影。

Default Value: ShadowMode.ENABLED

show : Property

获取或设置用于指定模型可见性的布尔属性。

Default Value: true

silhouetteColor : Property

获取或设置指定轮廓的Color的属性。

Default Value: Color.RED

silhouetteSize : Property

获取或设置以像素为单位指定轮廓大小的数字属性。

Default Value: 0.0

uri : Property

获取或设置指定GLTF资源的URI的字符串属性。

Methods

clone(result) → {ModelGraphics}

复制此实例。

Parameters:

result (ModelGraphics) 存储结果的对象。

merge(source)

将此对象上的每个未分配属性分配给所提供源对象上相同属性的值。

Parameters:

source (ModelGraphics) 要合并到此对象中的对象。