new ModelGraphics(options)

用于加载和管理三维模型类基于glTF的三维模型，是 WebGL、OpenGL ES 和 OpenGL 的运行时资产格式。模型的位置和方向由包含的Entity 决定。

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

Name Type Description

options

Object

可选

Object 包含如下属性的对象:

Name	Type	Default	Description
`uri`	Property		可选 string或者Resource属性，用于指定gltf资源的URI地址。
`show`	Property	true	可选 boolean属性，指定模型的可见性。
`scale`	Property	1.0	可选 number属性，指定模型的缩放比例。
`minimumPixelSize`	Property	0.0	可选 number属性，指定模型的近似最小像素大小，而不考虑缩放。
`maximumScale`	Property		可选 number属性，指定模型的最大比例尺寸。minimumPixelSize的上限。
`incrementallyLoadTextures`	Property	true	可选 boolean属性，确定纹理是否可以在模型加载后继续流进。
`runAnimations`	Property	true	可选 boolean属性，用于指定gltf资源中的动画是否应该播放。
`clampAnimations`	Property	true	可选 boolean属性，用于指定当没有关键帧的持续时间内，gltf动画是否保持最后一个姿态。
`nodeTransformations`	PropertyBag		可选对象，其中键是节点的名称，值是`TranslationRotationScale`属性，描述应用于该节点的变换换。
`shadows`	Property	ShadowMode.ENABLED	可选枚举属性，用于指定模型从每个光源投射阴影还是接收阴影。
`heightReference`	Property	HeightReference.NONE	可选 `HeightReference`属性，用于指定模型的height的参考点。
`distanceDisplayCondition`	Property		可选 `DistanceDisplayCondition`属性，指定该模型在距离相机多远的位置显示。
`silhouetteColor`	Property	Color.RED	可选 `Color`属性，该属性指定轮廓的颜色。
`silhouetteSize`	Property	0.0	可选 number属性，该属性指定模型轮廓的像素大小。
`color`	Property	Color.WHITE	可选 `Color`属性，用于和模型的渲染颜色做混合。
`colorBlendMode`	Property	ColorBlendMode.HIGHLIGHT	可选 `ColorBlendMode`属性，用于指定`ModelGraphics#color`与模型的渲染颜色做混合时使用的混合模式。
`colorBlendAmount`	Property	0.5	可选 number属性，该属性指定当 `colorBlendMode` 为 MIX 时的`ModelGraphics#color`的混合因子。
`clippingPlanes`	Property		可选 `ClippingPlaneCollection`属性，用于选择性的不渲染模型的一部分。
`imageBasedLightingFactor`	Property	new Cartesian2(1.0, 1.0)	可选 `Cartesian2`属性，指定基于漫反射和镜面反算的图像照明贡献。
`lightColor`	Property		可选 `Cartesian3`属性，该属性指定了渲染模型时的光源颜色。当未指定该值，将使用默认的光源颜色。

Members

clampAnimationsProperty

获取或设置boolean属性，用于指定当没有关键帧的持续时间内，gltf动画是否保持最后一个姿态。

Default Value:

clippingPlanesProperty

获取或指定 ClippingPlaneCollection属性，用于选择性的不渲染模型的一部分。

colorProperty

获取或设置Color属性，用于和模型的渲染颜色做混合。

Default Value:

colorBlendAmountProperty

获取或设置number属性，该属性指定当 colorBlendMode 为 MIX 时的ModelGraphics#color的混合因子。当值为0.0时，模型最终的颜色为渲染颜色。当值为1.0时，模型的最终颜色为ModelGraphics#color. 当值为介于0.0，1.0之间的值时，模型的最终颜色为二者的混合。

Default Value:

colorBlendModeProperty

获取或设置ColorBlendMode属性，用于指定ModelGraphics#color与模型的渲染颜色做混合时使用的混合模式。

Default Value:

readonly definitionChangedEvent

获取事件。该事件在属性或者子属性的值被修改，或者定义被修改时被抛出。

distanceDisplayConditionProperty

获取或设置DistanceDisplayCondition属性，指定该模型在距离相机多远的位置显示。

heightReferenceProperty

获取或设置HeightReference属性。

Default Value:

imageBasedLightingFactorProperty

获取或设置Cartesian2属性，指定基于漫反射和镜面反算的图像照明贡献。

incrementallyLoadTexturesProperty

获取或设置boolean属性，用于指定模型加载后，纹理是否可以在增量式加载。

lightColorProperty

获取或指定 Cartesian3属性，该属性指定了渲染模型时的光源颜色。

maximumScaleProperty

获取或设置number属性，用于指定模型的最大比例尺寸。minimumPixelSize的上限。 ModelGraphics#minimumPixelSize.

minimumPixelSizeProperty

获取或设置number属性，指定模型的近似最小像素大小，而不考虑缩放。

Default Value:

nodeTransformationsPropertyBag

获取或设置要应用于此模型的节点变换集。它被表示为PropertyBag，其中key是节点的名称，值是TranslationRotationScale属性，描述应用于该节点的变换。

runAnimationsProperty

获取或设置boolean属性，用于指定gltf资源中的动画是否应该播放。

Default Value:

scaleProperty

获取或设置boolean属性，指定了模型的统一线性缩放比例。该缩放比大于1会增大模型的尺寸，小于1则缩小模型的尺寸。

Default Value:

shadowsProperty

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

Default Value:

showProperty

获取或设置boolean属性，指定模型的可见性。

Default Value:

silhouetteColorProperty

获取或设置Color属性，该属性指定轮廓的颜色。

Default Value:

silhouetteSizeProperty

获取或设置number属性，该属性指定模型轮廓的像素大小。

Default Value:

uriProperty

获取或设置string属性，用于指定gltf资源的URI地址。

Methods

clone(result){ModelGraphics}

拷贝实例

Name	Type	Description
`result`	ModelGraphics	可选存储拷贝结果的对象.

Returns:

Type	Description
ModelGraphics	如果提供了输入参数，返回修改后的输入参数对象。如果没提供入参，返回一个新的实例。

merge(source)

为本实例所有未指定值的属性赋上source对象对应的属性值。

Name	Type	Description
`source`	ModelGraphics	提供属性值的对象。

Class: ModelGraphics