基于 glTF 的 3D 模型,glTF 是 WebGL、OpenGL ES 和 OpenGL 的运行时资产格式。
模型的位置和方向由包含的
Entity 决定。
Cesium 支持 glTF 几何图形、材质、动画和绑定功能。 目前不支持相机和光源。
| Name | Type | Description |
|---|---|---|
options |
ModelGraphics.ConstructorOptions | optional 描述初始化选项的对象 |
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
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。 | |
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> |
模型的最大缩放大小,最低像素大小的上限。 | |
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) | 一个属性,指定来自漫反射和高光基于图像的光照的贡献。 |
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。 |
