基于
glTF
的3D模型,这是WebGL,OpenGL ES和OpenGL的运行时资产格式。模型的位置和方向由包含的
Entity
确定。
Cesium包含对glTF几何,材质,动画和蒙皮的支持。当前不支持照相机和灯光。
Name | Type | Description |
---|---|---|
options
|
ModelGraphics.ConstructorOptions | 可选 描述初始化选项的对象 |
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
readonly definitionChanged : Event
获取每当属性或子属性发生更改或修改时引发的事件。
distanceDisplayCondition : Property |undefined
获取或设置
DistanceDisplayCondition
属性,该属性指定将在距相机的距离显示此模型。
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
获取或设置字符串Property,该字符串指定glTF资产的URI。
Methods
clone ( result ) → ModelGraphics
复制此实例。
Name | Type | Description |
---|---|---|
result
|
ModelGraphics | 可选 将结果存储到的对象。 |
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>
|
模型的最大比例尺大小。 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) | 一个属性,用于指定基于漫反射和镜面反射的图像照明的贡献。 |
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
的属性,用于有选择地禁用渲染模型。
|