基于glTF的三维模型,用于WebGL、OpenGL ES和OpenGL的运行时资产格式。
模型的位置和方向由包含的
Entity
确定。
Cesium includes support for glTF geometry, materials, animations, and skinning. Cameras and lights are not currently supported.
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
混合时的颜色强度的数字属性。
值0.0将生成模型的渲染颜色,而值1.0将生成纯色,其中
介于两者之间的任何值都会导致两者的混合。-
Default Value:
0.5
colorBlendMode : Property|undefined
获取或设置指定颜色如何与模型混合的枚举属性。
-
Default Value:
ColorBlendMode.HIGHLIGHT
readonly definitionChanged : Event
获取每当更改或修改属性或子属性时引发的事件。
distanceDisplayCondition : Property|undefined
获取或设置
DistanceDisplayCondition
属性,该属性指定此模型将显示在距摄影机的距离。heightReference : Property|undefined
获取指定属性的6866165或。
-
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 | 指定统一线性比例的数值特性。 |
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 的属性,用于有选择地禁用对模型的呈现。 |