ModelGraphics

new Cesium.ModelGraphics ( options )

基于 glTF 的3D模型,这是WebGL,Op​​enGL ES和OpenGL的运行时资产格式。模型的位置和方向由包含的 Entity 确定。

Cesium包括对glTF几何,材质,动画和蒙皮的支持。当前不支持照相机和灯光。

Name Type Description
options Object optional Object with the following properties: 时,将使用默认的太阳光颜色。
Name Type Default Description
show Property true 可选 一个布尔属性,指定模型的可见性。
uri Property 可选 指定glTF资产的URI的字符串或资源属性。
scale Property 1.0 可选 一个数字属性,用于指定均匀的线性比例。
minimumPixelSize Property 0.0 可选 一个数字属性,用于指定模型的最小最小像素大小,而不考虑缩放。
maximumScale Property 可选 模型的最大比例尺大小。 minimumPixelSize的上限。
incrementallyLoadTextures Property true 可选 确定在加载模型后纹理是否可以继续流入。
runAnimations Property true 可选 一个布尔属性,指定是否应启动模型中指定的glTF动画。
clampAnimations Property true 可选 一个布尔属性,指定glTF动画是否应在没有关键帧的持续时间内保持最后一个姿势。
shadows Property ShadowMode.ENABLED 可选 一个枚举属性,指定模型是投射还是接收来自每个光源的阴影。
heightReference Property HeightReference.NONE 可选 一个属性,指定高度相对于的高度。
silhouetteColor Property Color.RED 可选 一个属性,指定轮廓的 Color
silhouetteSize Property 0.0 可选 一个数字属性,指定轮廓的大小(以像素为单位)。
color Property Color.WHITE 可选 一个属性,指定与模型的渲染颜色混合的 Color
colorBlendMode Property ColorBlendMode.HIGHLIGHT 可选 一个枚举属性,指定颜色如何与模型融合。
colorBlendAmount Property 0.5 可选 一个数字属性,用于指定 colorBlendMode MIX 时的颜色强度。值0.0会产生模型的着色,而值1.0会导致纯色,介于两者之间的任何值都会导致两者混合。
imageBasedLightingFactor Property new Cartesian2(1.0, 1.0) 可选 一个属性,用于指定基于漫反射和镜面反射的图像照明的贡献。
lightColor Property 可选 一个属性,指定在为模型着色时使用的浅色。 undefined
distanceDisplayCondition Property 可选 一个属性,指定将在距相机的距离处显示此模型。
nodeTransformations PropertyBag 可选 一个对象,其中的键是节点的名称,而值是 TranslationRotationScale 属性,描述了要应用于该节点的转换。转换是在glTF中指定的节点现有转换之后应用的,并且不会替换节点现有转换。
articulations PropertyBag 可选 一个对象,其键由发音名称,单个空格和阶段名称组成,并且值是数字属性。
clippingPlanes Property 可选 指定 ClippingPlaneCollection 的属性,用于有选择地禁用渲染模型。
Demo:
See:

Members

获取或设置要应用于此模型的清晰度值集。这表示为 PropertyBag ,其中的键是由关节的名称,单个空间和舞台的名称组成。
获取或设置布尔属性,该属性指定glTF动画是否应在没有关键帧的持续时间内保持最后一个姿势。
Default Value: true
指定 ClippingPlaneCollection 的属性,用于有选择地禁用渲染模型。
获取或设置指定与模型渲染颜色混合的 Color 的属性。
Default Value: Color.WHITE
一个数字属性,用于指定 colorBlendMode 为MIX时的颜色强度。值0.0会产生模型的渲染颜色,而值1.0会导致纯色,其中两者之间的任何值都会导致两者混合。
Default Value: 0.5
获取或设置枚举属性,该属性指定颜色如何与模型混合。
Default Value: ColorBlendMode.HIGHLIGHT
获取每当更改或修改属性或子属性时引发的事件。
获取或设置 DistanceDisplayCondition 属性,该属性指定将在距相机的距离显示此模型。
获取或设置指定 HeightReference 的属性。
Default Value: HeightReference.NONE
一个属性,用于指定 Cartesian2 ,用于将基于漫反射和镜面反射的基于图像的照明比例缩放到最终颜色。
获取或设置指定是否纹理的布尔属性加载模型后,可能会继续流入。
一个属性,用于在为模型着色时指定光源的 Cartesian3 颜色。
获取或设置数字属性,指定最大比例模型的大小。此属性用作以下内容的上限 ModelGraphics#minimumPixelSize
获取或设置数字属性,指定近似最小值模型的像素大小,与缩放无关。这可以用来确保即使观看者缩小视图,模型仍然可见。当 0.0 时,没有强制执行最小大小。
Default Value: 0.0
获取或设置要应用于此模型的节点转换集。这表示为 PropertyBag ,其中的键是节点的名称,值是 TranslationRotationScale 属性,用于描述要应用于该节点的转换。转换是在glTF中指定的节点现有转换之后应用的,并且不会替换节点现有转换。
获取或设置布尔属性,该属性指定是否应运行glTF动画。
Default Value: true
获取或设置数字属性,指定统一的线性比例对于此模型。大于1.0的值会增加模型的大小,而小于1.0的值会减少它。
Default Value: 1.0
获取或设置枚举属性,指定是否为模型从每个光源投射或接收阴影。
Default Value: ShadowMode.ENABLED
获取或设置指定模型可见性的布尔属性。
Default Value: true
获取或设置指定轮廓的 Color 的属性。
Default Value: Color.RED
获取或设置数字属性,该属性指定轮廓的大小(以像素为单位)。
Default Value: 0.0
获取或设置字符串Property,该字符串指定glTF资产的URI。

Methods

复制此实例。
Name Type Description
result ModelGraphics 可选 将结果存储到的对象。
Returns:
修改后的结果参数或一个新实例(如果未提供)。
将此对象上每个未分配的属性分配给该值提供的源对象具有相同属性。
Name Type Description
source ModelGraphics 要合并到该对象中的对象。