Model 类型代表地球上的一个可见对象,通常是一个3D模型或一个地面贴图。
new Cesium.Model({
id : id, // 可选的字符串
uri : uri, // 必需的字符串
allowPicking : allowPicking, // 可选的布尔值,默认为 true
asynchronous : asynchronous, // 可选的布尔值,默认为 true
basePath : basePath, // 可选的字符串
clampAnimations : clampAnimations, // 可选的布尔值,默认为 false
debugShowBoundingVolume : debugShowBoundingVolume, // 可选的布尔值,默认为 false
debugWireframe : debugWireframe, // 可选的布尔值,默认为 false
scale : scale, // 可选的数字,默认为 1.0
minimumPixelSize : minimumPixelSize,// 可选的数字,默认为 0.0
maximumScale : maximumScale, // 可选的数字,默认为无限大
distanceDisplayCondition : distanceDisplayCondition, // 可选的 DistanceDisplayCondition 对象
modelMatrix : modelMatrix, // 可选的 Matrix4 对象,默认为 IDENTIY
color : color, // 可选的颜色对象,默认为白色
colorBlendMode : colorBlendMode, // 可选的 ColorBlendMode 枚举值,默认为 HIGHLIGHT
colorBlendAmount : colorBlendAmount,// 可选的数字,范围在 [0, 1] 之间,默认为 0.5
silhouetteColor : silhouetteColor, // 可选的颜色对象,默认为黑色
silhouetteSize : silhouetteSize, // 可选的数字,默认为 0.0
shadeless : shadeless, // 可选的布尔值,默认为 false
lightColor : lightColor, // 可选的颜色对象,默认为白色
luminosityAtZenith : luminosityAtZenith, // 可选的数字,默认为 1.0
specularEnvironmentMaps : specularEnvironmentMaps, // 可选的布尔值,默认为 false
backFaceCulling : backFaceCulling, // 可选的布尔值,默认为 true
castShadows : castShadows, // 可选的布尔值,默认为 true
receiveShadows : receiveShadows, // 可选的布尔值,默认为 true
shadows : shadows // 可选的 ShadowMode 枚举值,默认为 ENABLED
});
id 可选的字符串(默认值:undefined):标识符用于查询相关的属性。uri 必需的字符串:模型的地址,可以是本地文件或远程文件。allowPicking 可选的布尔值(默认值:true):确定模型是否应响应输入事件。asynchronous 可选的布尔值(默认值:true):确定模型文件是否应异步加载。basePath 可选的字符串(默认值:undefined):用于解决模型文件中引用的任何相对路径的基本 URL。clampAnimations 可选的布尔值(默认值:false):确定动画是否应该被限制为 minimumPixelSize 以下的实体。debugShowBoundingVolume 可选的布尔值(默认值:false):确定模型边界是否应该被渲染。debugWireframe 可选的布尔值(默认值:false):确定模型是否应该以线框形式渲染。scale 可选的数字(默认值:1.0):确定模型对象的缩放比例。minimumPixelSize 可选的数字(默认值:0.0):以屏幕像素为单位的最小尺寸,如果小于此尺寸,则使用 pixelSize 属性代替。maximumScale 可选的数字(默认值:无限大):确定模型对象的最大缩放比例。distanceDisplayCondition 可选的 DistanceDisplayCondition 对象(默认值:undefined):如果定义,该实体仅在距相机视野范围以内时可见。modelMatrix 可选的 Matrix4 对象(默认值:单位矩阵 IDENTITY):确定模型对象的空间变换。color 可选的颜色对象(默认值:白色):亮度将应用于模型的每个部分。colorBlendMode 可选的 ColorBlendMode 枚举值(默认值:ColorBlendMode.HIGHLIGHT):确定如何混合模型颜色和其他颜色(如 primitive.show)。colorBlendAmount 可选的数字(默认值:0.5):指定模型对象的颜色混合量,范围在 [0, 1] 之间。silhouetteColor 可选的颜色对象(默认值:黑色):指定边框颜色。silhouetteSize 可选的数字(默认值:0.0):以屏幕像素为单位指定边框的大小。shadeless 可选的布尔值(默认值:false):确定模型是否应渲染为单色,不考虑光照。lightColor 可选的颜色对象(默认值:白色):指定模型的全局光颜色。luminosityAtZenith 可选的数字(默认值:1.0):指定与相机朝向完全相反的方向的表面亮度。specularEnvironmentMaps 可选的布尔值(默认值:false):确定材质是否使用镜面反射。注意:默认情况下,只有当 shadows 属性设置为 "CAST_ONLY" 此选项才会生效。backFaceCulling 可选的布尔值(默认值:true):确定是否剔除后向面。castShadows 可选的布尔值(默认值:true):确定模型是否应该投射阴影。receiveShadows 可选的布尔值(默认值:true):确定模型是否应该接收阴影。shadows 可选的 ShadowMode 枚举值(默认值:ShadowMode.ENABLED):确定阴影是已启用,已禁用还是仅投射。update()每帧更新实体的位置、姿态以及其他变换。
isDestroyed() → Boolean确定实体是否已经被销毁。
destroy()销毁该实体。 这一步操作无法撤消并同时也会销毁其包含的 webgl 上下文等资源,因此请考虑使用 Cesium3DTileset 的 tileset.unloadTile(tile), Cesium.Model 的 Cesium.ModelCollection 中的 modelCollection.remove(model),或者如 DataSourceCollection 的 dataSourceCollection.destroy() 等逐步销毁资源的方法。
allowPicking可选的布尔值(默认值:true):确定模型是否应响应输入事件。
asynchronous可选的布尔值(默认值:true):确定模型文件是否应异步加载。
basePath可选的字符串(默认值:undefined):用于解决模型文件中引用的任何相对路径的基本 URL。
boundingSphere用于确定拒绝测试优化的模型的常量包围球。
cesiumAnimations模型上定义的所有动画名称的字符串数组。
color可选的颜色对象(默认值:白色):亮度将应用于模型的每个部分。
colorBlendAmount可选的数字(默认值:0.5):指定模型对象的颜色混合量,范围在 [0, 1] 之间。
colorBlendMode可选的 ColorBlendMode 枚举值(默认值:ColorBlendMode.HIGHLIGHT):确定如何混合模型颜色和其他颜色(如 primitive.show)。
credit实体的信用数据类,包含来源和版权信息。
debugShowBoundingVolume可选的布尔值(默认值:false):确定模型边界是否应该被 Render。
debugWireframe可选的布尔值(默认值:false):确定模型是否应该以线框形式渲染。
distanceDisplayCondition可选的 DistanceDisplayCondition 对象(默认值:undefined):如果定义,该实体仅在距相机视野范围以内时可见。
id可选的字符串(默认值:undefined):标识符用于查询相关的属性。
isDestroyed只读的布尔值,指示实体是否已经被销毁。
maximumScale可选的数字(默认值:无限大):确定模型对象的最大缩放比例。
mesh枚举对象,用于确定发布的模型数据如何呈现。
minimumPixelSize可选的数字(默认值:0.0):以屏幕像素为单位的最小尺寸,如果小于此尺寸,则使用 pixelSize 属性代替。
modelMatrix可选的 Matrix4 对象(默认值:单位矩阵 IDENTITY):确定模型对象的空间变换。
ready只读的 Promise,表示模型是否已准备好呈现。
readyPromise只读的 Promise,表示模型是否已准备好呈现。
scale可选的数字(默认值:1.0):确定模型对象的缩放比例。
shadows可选的 ShadowMode 枚举值(默认值:ShadowMode.ENABLED):确定阴影是已启用,已禁用还是仅投射。
show模型是否显示。
silhouetteColor可选的颜色对象(默认值:黑色):指定边框颜色。
silhouetteSize可选的数字(默认值:0.0):以屏幕像素为单位指定边框的大小。
uri模型的地址,可以是本地文件或远程文件。
debugColorizeTiles可选的布尔值(默认值:false):确定是否将每个瓦片转换为其层次深度,以帮助调试 GPU 瓶颈。
debugFreezeFrame可选的数字(默认值:0):以毫秒为单位的时间,在此之后,每个动画都会由一个位置进行渲染。
restrictToBoundingSphere可选的布尔值(默认值:false):设为 true 以优化瓦片剖分,从而限制瓦片显示内容至该模型的 boundingSphere 属性的包围球范围之内。
appearanceChanged具有新值的事件,指示模型 appearance 属性已更改。
ready表示模型已准备好进行呈现的事件。
show, modelMatrix, distanceDisplayCondition, id, color, allowPicking, scale, minimumPixelSize, maximumScale, silhouetteColor, silhouetteSize, debugShowBoundingVolume, debugWireframe, shadows, colorBlendMode, colorBlendAmount, specularEnvironmentMaps, shadeless, castShadows, receiveShadows属性已更改的事件。
destroyed当实体已被销毁时发出的事件。
参阅使用示例页面.