用于加载和管理三维模型类
基于glTF的三维模型,是 WebGL、OpenGL ES 和 OpenGL 的运行时资产格式。
模型的位置和方向由包含的
Entity
决定。
支持 glTF 的几何体、材质、动画和蒙皮。目前不支持相机和灯光。
Name | Type | Default | Description |
---|---|---|---|
options.uri |
Property | optional 指定glTF资源的URI的字符串属性。 | |
options.show |
Property |
true
|
optional 指定模型可见性的布尔属性。 |
options.scale |
Property |
1.0
|
optional 指定统一线性刻度的数值属性。 |
options.minimumPixelSize |
Property |
0.0
|
optional 数值属性,指定模型的近似最小像素大小,而不考虑缩放。 |
options.maximumScale |
Property | optional 模型的最大比例尺寸。minimumPixelSize的上限。 | |
options.incrementallyLoadTextures |
Property |
true
|
optional 确定纹理是否可以在模型加载后继续流进。 |
options.runAnimations |
Property |
true
|
optional 布尔属性,指定是否应该启动模型中指定的glTF动画。 |
options.nodeTransformations |
Property |
optional
对象,其中键是节点的名称,值是TranslationRotationScale 属性,描述应用于该节点的转换。 |
|
options.shadows |
Property |
ShadowMode.ENABLED
|
optional 枚举属性,指定模型是否从每个光源投射或接收阴影。 |
options.heightReference |
Property |
HeightReference.NONE
|
optional 指定相对高度的属性。 |
options.distanceDisplayCondition |
Property | optional 属性,指定在距离相机的距离上显示该模型。 | |
options.silhouetteColor |
Property |
Color.RED
|
optional
指定轮廓Color 的属性。 |
options.silhouetteSize |
Property |
0.0
|
optional 数值属性,指定以像素为单位的轮廓大小。 |
options.color |
Property |
Color.WHITE
|
optional
属性,指定Color 与模型的渲染颜色混合。 |
options.colorBlendMode |
Property |
ColorBlendMode.HIGHLIGHT
|
optional 枚举属性,指定颜色如何与模型混合。 |
options.colorBlendAmount |
Property |
0.5
|
optional
当colorBlendMode 为MIX 时,指定颜色强度的数值属性。值0.0会导致模型的渲染颜色,而值1.0会导致纯色,任何介于两者之间的值都会导致两者的混合。 |
Members
-
color : Property
-
获取或设置指定与模型渲染颜色混合的
Color
的属性。-
Default Value:
Color.WHITE
-
colorBlendAmount : Property
-
数值属性,指定当
colorBlendMode
为 MIX 时的颜色强度。数值 0.0 会产生模型的渲染颜色,数值 1.0 会产生纯色,任何介于两者之间的数值都会产生两者的混合色。-
Default Value:
0.5
-
colorBlendMode : Property
-
获取或设置指定颜色与模型混合方式的枚举属性。
-
Default Value:
ColorBlendMode.HIGHLIGHT
-
readonlydefinitionChanged : Event
-
获取每当更改或修改属性或子属性时引发的事件。
-
distanceDisplayCondition : Property
-
获取或设置
DistanceDisplayCondition
属性,指定此模型将在距离相机多远的位置显示。 -
heightReference : Property
-
获取或设置指定
HeightReference
的属性。-
Default Value:
HeightReference.NONE
-
incrementallyLoadTextures : Property
-
获取或设置布尔属性,指定在模型加载后纹理是否可以继续流进。
-
maximumScale : Property
-
获取或设置指定模型的最大比例大小的数值属性。此属性用作
ModelGraphics#minimumPixelSize
的上限。 -
minimumPixelSize : Property
-
获取或设置数字属性,该属性指定模型的近似最小像素大小,而不考虑缩放。这可以用来确保一个模型是可见的,即使当查看器缩小。当
0.0
时,没有强制执行最小大小。-
Default Value:
0.0
-
nodeTransformations : PropertyBag
-
获取或设置要应用于此模型的节点转换集。它被表示为
PropertyBag
,其中key是节点的名称,值是TranslationRotationScale
属性,描述应用于该节点的转换。 -
runAnimations : Property
-
获取或设置布尔属性,指定是否运行 glTF 动画。
-
Default Value:
true
-
scale : Property
-
获取或设置为该模型指定统一线性比例的数值属性。大于1.0的值会增大模型的尺寸,而小于1.0的值会减小模型的尺寸。
-
Default Value:
1.0
-
shadows : Property
-
获取或设置枚举属性,指定模型是投射还是接收来自每个光源的阴影。
-
Default Value:
ShadowMode.ENABLED
-
show : Property
-
获取或设置指定模型可见性的布尔属性。
-
Default Value:
true
-
silhouetteColor : Property
-
获取或设置指定轮廓的
Color
的属性。-
Default Value:
Color.RED
-
silhouetteSize : Property
-
获取或设置指定以像素为单位的轮廓大小的数值属性。
-
Default Value:
0.0
-
uri : Property
-
获取或设置字符串属性,指定 glTF 资产的 URI。
Methods
-
clone(result) → ModelGraphics
-
复制此实例。
Name Type Description result
ModelGraphics optional 存储结果的对象。 Returns:
修改后的结果参数,或一个新实例(如果没有提供)。 -
将此对象上每个未指定的属性赋值给所提供源对象上相同属性的值。
Name Type Description source
ModelGraphics 要合并到该对象中的对象。