基于 glTF（WebGL、OpenGL ES和OpenGL的运行时资源格式）的3D模型。
模型的位置和方向由包含的
Entity 决定。
Cesium支持glTF几何、材质、动画和蒙皮。 当前不支持摄像机和灯光。
| Name | Type | Description |
|---|---|---|
options |
ModelGraphics.ConstructorOptions | optional 描述初始化选项的对象 |
Demo:
Members
articulations : PropertyBag
获取或设置要应用于此模型的关节值集合。这表示为
PropertyBag，其中键由关节名称、单个空格和阶段名称组成。
clampAnimations : Property|undefined
获取或设置指定glTF动画是否在没有关键帧的时间段保持最后一帧姿势的布尔属性。
-
Default Value:
true
clippingPlanes : Property|undefined
指定用于选择性禁用模型渲染的
ClippingPlaneCollection 的属性。
color : Property|undefined
获取或设置指定与模型渲染颜色混合的
Color 的属性。
-
Default Value:
Color.WHITE
colorBlendAmount : Property|undefined
指定当
colorBlendMode 为MIX时的颜色强度的数值属性。
值为0.0时显示模型渲染颜色，值为1.0时显示纯色，中间值则为两者混合。
-
Default Value:
0.5
colorBlendMode : Property|undefined
获取或设置指定颜色如何与模型混合的枚举属性。
-
Default Value:
ColorBlendMode.HIGHLIGHT
customShader : Property|undefined
获取或设置要应用于此模型的
CustomShader。当 undefined 时不使用自定义着色器代码。
readonly definitionChanged : Event
获取每当属性或子属性更改或修改时引发的事件。
distanceDisplayCondition : Property|undefined
获取或设置指定模型在距离相机多远时显示的
DistanceDisplayCondition 属性。
enableVerticalExaggeration : Property|undefined
获取或设置当
Scene.verticalExaggeration 设置为非 1.0 值时，模型是否沿椭圆体法线夸张的布尔属性。
-
Default Value:
true
environmentMapOptions : PropertyBag
获取或设置要应用于此模型的
DynamicEnvironmentMapManager.ConstructorOptions。这表示为 PropertyBag。
heightReference : Property|undefined
获取或设置指定
HeightReference 的属性。
-
Default Value:
HeightReference.NONE
imageBasedLightingFactor : Property|undefined
指定用于缩放漫反射和镜面反射基于图像的照明对最终颜色贡献的
Cartesian2 属性。
incrementallyLoadTextures : Property|undefined
获取或设置指定模型加载后纹理是否继续流式传输的布尔属性。
lightColor : Property|undefined
指定着色模型时的
Cartesian3 灯光颜色的属性。当 undefined 时使用场景的灯光颜色。
maximumScale : Property|undefined
获取或设置指定模型最大缩放大小的数值属性。
此属性用作
ModelGraphics#minimumPixelSize 的上限。
minimumPixelSize : Property|undefined
获取或设置指定模型近似最小像素大小（无论缩放如何）的数值属性。
这可用于确保即使观察者缩小时模型仍然可见。当
0.0 时不强制最小尺寸。
-
Default Value:
0.0
nodeTransformations : PropertyBag
获取或设置要应用于此模型的节点变换集合。这表示为
PropertyBag，其中键是节点名称，值是描述要应用于该节点的变换的 TranslationRotationScale 属性。
该变换在glTF中指定的节点现有变换之后应用，不替换节点的现有变换。
runAnimations : Property|undefined
获取或设置指定是否运行glTF动画的布尔属性。
-
Default Value:
true
scale : Property|undefined
获取或设置指定此模型均匀线性缩放的数值属性。
大于1.0的值会增大模型尺寸，小于1.0的值会减小模型尺寸。
-
Default Value:
1.0
shadows : Property|undefined
获取或设置指定模型是否从光源投射或接收阴影的枚举属性。
-
Default Value:
ShadowMode.ENABLED
show : Property|undefined
获取或设置指定模型可见性的布尔属性。
-
Default Value:
true
silhouetteColor : Property|undefined
获取或设置指定轮廓
Color 的属性。
-
Default Value:
Color.RED
silhouetteSize : Property|undefined
获取或设置指定轮廓大小（像素）的数值属性。
-
Default Value:
0.0
uri : Property|undefined
获取或设置指定glTF资源URI的字符串属性。
Methods
clone(result) → ModelGraphics
复制此实例。
| Name | Type | Description |
|---|---|---|
result |
ModelGraphics | optional 存储结果的对象。 |
Returns:
修改后的结果参数，如果未提供则返回新实例。
将此对象上每个未赋值的属性分配给提供的源对象上相同属性的值。
| Name | Type | Description |
|---|---|---|
source |
ModelGraphics | 要合并到此对象中的对象。 |
Type Definitions
ModelGraphics构造函数的初始化选项
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
show |
Property | boolean |
<optional> |
true | 指定模型可见性的布尔属性。 |
uri |
Property | string | Resource |
<optional> |
指定glTF资源URI的字符串或Resource属性。 | |
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> |
模型的最大缩放大小。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) | 指定漫反射和镜面反射基于图像的照明贡献的属性。 |
environmentMapOptions |
PropertyBag | Object.<string, *> |
<optional> |
用于管理此实体上动态环境贴图的属性。 | |
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 的属性。 |