ModelGraphics

new SuperMap3D.ModelGraphics(options)

基于glTF的三维模型，是 WebGL、OpenGL ES 和 OpenGL 的运行时资产格式。模型的位置和方向由包含的Entity 决定。

SuperMap3D包括对glTF几何、材料、动画和蒙皮的支持。目前不支持摄像头和灯。

Name Type Description
options Object optional 具有以下属性的对象:
Name Type Default Description
uri Property optional 指定glTF资源的URI的字符串属性。
show Property true optional 指定模型可见性的布尔属性。
scale Property 1.0 optional 指定统一线性刻度的数值属性。
minimumPixelSize Property 0.0 optional 数值属性，指定模型的近似最小像素大小，而不考虑缩放。
maximumScale Property optional 模型的最大比例尺寸。minimumPixelSize的上限。
incrementallyLoadTextures Property true optional 确定纹理是否可以在模型加载后继续流进。
runAnimations Property true optional 布尔属性，指定是否应该启动模型中指定的glTF动画。
nodeTransformations Property optional 对象，其中键是节点的名称，值是TranslationRotationScale属性，描述应用于该节点的转换。
shadows Property ShadowMode.ENABLED optional 枚举属性，指定模型是否从每个光源投射或接收阴影。
heightReference Property HeightReference.NONE optional 指定相对高度的属性。
distanceDisplayCondition Property optional 属性，指定在距离相机的距离上显示该模型。
silhouetteColor Property Color.RED optional 指定轮廓Color的属性。
silhouetteSize Property 0.0 optional 数值属性，指定以像素为单位的轮廓大小。
color Property Color.WHITE optional 属性，指定Color与模型的渲染颜色混合。
colorBlendMode Property ColorBlendMode.HIGHLIGHT optional 枚举属性，指定颜色如何与模型混合。
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:
修改后的结果参数，或一个新实例（如果没有提供）。

merge(source)

将此对象上每个未指定的属性赋值给所提供源对象上相同属性的值。
Name Type Description
source ModelGraphics 要合并到该对象中的对象。