基于 glTF(WebGL、OpenGL ES 和 OpenGL 的运行时资产格式)的 3D 模型。
模型的位置和方向由包含的
Entity 确定。
Cesium 包括对 glTF 几何体、材质、动画和蒙皮的支持。 目前不支持相机和灯光。
| Name | Type | Description |
|---|---|---|
options |
ModelGraphics.ConstructorOptions | optional 描述初始化选项的对象 |
Members
articulations : PropertyBag
获取或设置要应用于此模型的清晰度值集。 这表示为
PropertyBag，其中键是
组合为发音法的名称、单个空格和舞台的名称。
clampAnimations : Property|undefined
获取或设置boolean 属性，指定 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
获取或设置enum 属性，用于指定颜色如何与模型混合。
-
Default Value:
ColorBlendMode.HIGHLIGHT
customShader : Property|undefined
获取或设置
CustomShader 以应用于此模型。undefined，则不使用自定义着色器代码。
readonly definitionChanged : Event
获取在更改或修改属性或子属性时引发的事件。
distanceDisplayCondition : Property|undefined
获取或设置
DistanceDisplayCondition 指定此模型将在距相机多远处显示的属性。
enableVerticalExaggeration : Property|undefined
获取或设置boolean 属性，指定当
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，则使用场景的 light 颜色。
maximumScale : Property|undefined
获取或设置指定最大比例的 numeric 属性
模型的大小。此属性用作
ModelGraphics#minimumPixelSize.
minimumPixelSize : Property|undefined
获取或设置numeric 指定近似最小值的属性
无论缩放如何，模型的像素大小。这可用于确保
即使查看器缩小，模型也可见。 当
0.0 时，
没有强制要求最小大小。
-
Default Value:
0.0
nodeTransformations : PropertyBag
获取或设置要应用于此模型的节点转换集。 这表示为
PropertyBag，其中键是
节点名称和值是 TranslationRotationScale 属性，用于描述要应用于该节点的转换。
转换在 glTF 中指定的节点现有转换之后应用，并且不会替换节点的现有转换。
runAnimations : Property|undefined
获取或设置boolean 属性，指定是否应运行 glTF 动画。
-
Default Value:
true
scale : Property|undefined
获取或设置numeric 属性，用于指定均匀线性刻度
对于此型号。大于 1.0 的值会增加模型的大小，而
小于 1.0 的值会降低它。
-
Default Value:
1.0
shadows : Property|undefined
获取或设置 enum 属性，指定模型是否
从光源投射或接收阴影。
-
Default Value:
ShadowMode.ENABLED
show : Property|undefined
获取或设置boolean 指定模型可见性的属性。
-
Default Value:
true
silhouetteColor : Property|undefined
获取或设置指定轮廓的
Color 的属性。
-
Default Value:
Color.RED
silhouetteSize : Property|undefined
获取或设置numeric 指定轮廓大小(以像素为单位)的属性。
-
Default Value:
0.0
uri : Property|undefined
获取或设置string 属性，用于指定 glTF 资源的 URI。
Methods
clone(result) → ModelGraphics
复制实例。
| Name | Type | Description |
|---|---|---|
result |
ModelGraphics | optional 要在其上存储结果的对象。 |
Returns:
修改后的结果参数或者一个新实例(如果未提供)。
将此对象上每个未分配的属性分配给值
的 API 值。
| Name | Type | Description |
|---|---|---|
source |
ModelGraphics | 要合并到此对象中的对象。 |
Type Definitions
ModelGraphics 构造函数的初始化选项
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
show |
Property | boolean |
<optional> |
true | 一个布尔属性，用于指定模型的可见性。 |
uri |
Property | string | Resource |
<optional> |
一个字符串或 Resource Property，用于指定 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> |
模型的最大缩放大小。minimumPixelSize 的上限。 | |
incrementallyLoadTextures |
Property | boolean |
<optional> |
true | 确定加载模型后纹理是否可以继续流入。 |
runAnimations |
Property | boolean |
<optional> |
true | 一个布尔属性，指定是否应启动模型中指定的 glTF 动画。 |
clampAnimations |
Property | boolean |
<optional> |
true | 一个布尔属性，指定 glTF 动画是否应在没有关键帧的持续时间内保持最后一个姿势。 |
shadows |
Property | ShadowMode |
<optional> |
ShadowMode.ENABLED | 一个枚举 Property，指定模型是投射还是接收来自光源的阴影。 |
heightReference |
Property | HeightReference |
<optional> |
HeightReference.NONE | 指定高度相对于什么的 Property。 |
silhouetteColor |
Property | Color |
<optional> |
Color.RED | 指定轮廓的 Color 的属性。 |
silhouetteSize |
Property | number |
<optional> |
0.0 | 一个数字属性，用于指定轮廓的大小(以像素为单位)。 |
color |
Property | Color |
<optional> |
Color.WHITE | 一个 Property，用于指定与模型的渲染颜色混合的 Color。 |
colorBlendMode |
Property | ColorBlendMode |
<optional> |
ColorBlendMode.HIGHLIGHT | 一个 enum Property，指定颜色如何与模型混合。 |
colorBlendAmount |
Property | number |
<optional> |
0.5 | 一个数字 Property，用于指定 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> |
指定在对模型进行着色时光源颜色的属性。如果未定义，则使用场景的 light 颜色。 |
|
distanceDisplayCondition |
Property | DistanceDisplayCondition |
<optional> |
一个 Property (属性)，指定此模型将在距离相机多远处显示。 | |
nodeTransformations |
PropertyBag | Object.<string, TranslationRotationScale> |
<optional> |
一个对象，其中键是节点的名称，值是 TranslationRotationScale 属性，用于描述要应用于该节点的转换。该转换在 glTF 中指定的节点现有转换之后应用，并且不会替换节点的现有转换。 |
|
articulations |
PropertyBag | Object.<string, number> |
<optional> |
一个对象，其中键由发音法名称、单个空格和舞台名称组成，值是数字属性。 | |
clippingPlanes |
Property | ClippingPlaneCollection |
<optional> |
一个属性，用于指定 ClippingPlaneCollection，用于选择性地禁用模型渲染。 |
|
customShader |
Property | CustomShader |
<optional> |
指定要应用于此模型的 CustomShader 的属性。 |