CIMCubeSDK v3.34.0

Class: CIMCube

Glodon. CIMCube

CIMCube类，用于创建3D地球和2D地图的主要类

new CIMCube(opts)

CIMCube构造函数
Parameters:
Name Type Description
opts Object CIMCube参数
Properties
Name Type Argument Description
id String DOM element ID
gisResourceUrl String 指定Resource的相对路径
center Object <optional>
 相机位置和姿态
Properties
Name Type Argument Default Description
lon Number <optional>
 116.41667 经度
lat Number <optional>
 39.91667 纬度
height Number <optional>
 2.0e7 高度
heading Number <optional>
 0.0 航向角
pitch Number <optional>
 -45 俯仰角
roll Number <optional>
 0.0 翻滚角
baseMap Object <optional>
 默认底图配置
Properties
Name Type Argument Default Description
id Object <optional>
 底图ID
type String <optional>
 Glodon.CIMCube.Global.Defines.LayerType.IMAGERY 底图类型,仅支持imagery类型
show Boolean <optional>
 true 底图显隐
name String <optional>
 天地图影像 底图名称
imageryType String <optional>
 Glodon.CIMCube.Global.Defines.ImageryLayerType.TDT_IMG 底图影像类型， 支持天地图（TDT_VEC、TDT_IMG、TDT_TER、TDT_CVA、TDT_CIA、TDT_CTA）、高德（GAODE_IMG、GAODE_VEC、GAODE_CIA）、百度（BAIDU_IMG、BAIDU_VEC）等
minimumLevel Number <optional>
 0 底图最小级别
maximumLevel Number <optional>
 17 底图最大级别
accessToken Object <optional>
 底图访问令牌,仅针对天地图等需要访问令牌的底图有效
Properties
Name Type Argument Description
field String <optional>
 默认底图访问令牌字段
value String <optional>
 默认底图访问令牌值
layers Array 图层组
params Object 场景配置参数
Properties
Name Type Argument Default Description
sceneMode SceneMode <optional>
 SceneMode.SCENE3D 视图模式
mapProjection Projection 地图投影; 2.5D|2D场合,默认为地理投影
terrainUrl String 地形URL
requestVertexNormals Boolean 地形服务是否请求顶点法线
shadows Boolean 开启光源投射与接收阴影
shouldAnimate Boolean 是否开启Cesium动画
useDefaultTerrain Boolean <optional>
 true 是否使用默认地形
useDefaultLabel Boolean <optional>
 false 是否开启默认内置注记图层
layerControl Boolean 是否开启内置图层管理器
fullscreenButton Boolean Cesium的全屏按钮可用
homeButton Boolean Cesium的Home按钮可用
navigationHelpButton Boolean Cesium的帮助按钮可用
sceneModePicker Boolean Cesium的二三维切换按钮可用
minSightDistance Boolean <optional>
 1.0 最小视距范围,引擎默认1.0,即离地面1.0m,地下即负值
maxSightDistance Boolean <optional>
 50000000.0 最大视距范围,引擎默认50000000.0,即: 5000万米高空, 地球全貌
atmosphere Boolean 是否开启大气;默认false;
nephogram Boolean 是否开启云图;默认false;
moon Boolean 是否有月亮,默认false;
useDefaultSkyBox String 开启天空盒,默认Default;内置Summer【晴空】、Bluesky【蓝天】、Sunset【晚霞】、Default【默认】四种效果;
geocoder Boolean Cesium的geocoder按钮可用
debugShowPostRender Boolean 是否开启内置三角面与drawCall监测面板
debugShowDrawCalls Boolean 是否开启内置三角面与drawCall监测面板(图层级)
debugShowFramesPerSecond Boolean 是否开启Cesium的帧率监测面板
depthTestAgainstTerrain Boolean <optional>
 false 是否开启地形深度检测
logarithmicDepthBuffer Boolean <optional>
 false 是否开启log深度,默认false
hardwareAA Boolean <optional>
 true 是否开启硬件抗锯齿,默认为true
msaaSamples Number MSAA抗锯齿,取值范围:1,2,4,8;默认为1;硬件抗锯齿开启情况,MSAA无效;
requestRenderMode Boolean 是否开启显式渲染,降低cpu使用率,默认为true;
maximumRenderTimeChange Number 开启显式渲染后,渲染等待时长,默认为20ms;
terrainShadows ShadowMode <optional>
 ShadowMode.RECEIVE_ONLY 确定地形是否投射或接收来自光源的阴影
decreaseRequestingWhileFlying Boolean <optional>
 true 是否允许相机在飞向目的地的过程中降低数据的请求数量；
usePostProcessWater Boolean <optional>
 true 是否使用后处理的水面效果 true: 引擎会自动向postProcessStages中加入水面的后期处理
shadowQuality String <optional>
 'medium' 实时阴影质量, 可选值'high' | 'medium' | 'low'
shadowRange Boolean <optional>
 3000.0 实时阴影的覆盖距离范围, 理论上这个值越小, 阴影效果越好, 取值范围(0, +∞)
shadowIntensity Boolean <optional>
 0.5 实时阴影的强度, 取值范围[0, 1]
shadowColor String | Cesium.Color <optional>
 #000000 实时阴影的颜色
fixedLightDirection Boolean <optional>
 true 是否使用固定的光照方向
fixedLightTime String <optional>
 '11:00:00' 固定光照的时刻 有两种形式:如'11:00:00'或'2024:10:16:11:00:00'
shadowOptimizeWhenMoving Boolean <optional>
 true 相机移动时是否开启阴影性能优化
shadowOptimizeWhenIdling Boolean <optional>
 true 相机静止时是否开启阴影性能优化
shadowUpdateFrequency Boolean <optional>
 10 shadowOptimizeWhenIdling为true时，阴影的更新频率，单位为帧
aoOptimizeWhenMoving Boolean <optional>
 true 相机移动时是否开启AO性能优化
enableLocalCache Boolean <optional>
 true 开启本地缓存，如果为false，那么资源全部走HTTP请求；
enableLocalCacheByIndex Boolean <optional>
 false 开启使用索引的本地缓存（需要enableLocalCache为true时才能生效）。如果为false，那么查询本地数据时批量处理；
layerOutlineColor Boolean <optional>
 [0,255,255,255] 红绿蓝透明；
colorMode Boolean <optional>
 "HSB" 色彩模式,默认为HSB;
castShadowAlphaThreshold Number <optional>
 0.0 全局参数: 当物体的alpha小于等于此阈值时不会投射阴影, 取值范围[0.0, 1.0]
autoUpdateGlobeTransparency Number <optional>
 true 全局参数: 引擎内部是否自动更新Globe的透明属性(相机进出地下的场景)
Example
const map = new Glodon.CIMCube({
            id: "cesiumContainer",
            gisResourceUrl: "../CIMCubeRender/",
            baseMap: {
                show: true,
                name: "高德影像",
                imageryType: Glodon.CIMCube.Global.Defines.ImageryLayerType.GAODE_IMG
            },
            params: {
                debugShowFramesPerSecond: true,
                debugShowPostRender: true,
                shadows: true,
                layerControl: true,
                useDefaultTerrain: false,
                depthTestAgainstTerrain: true
            }
        });

Extends

Classes

Camera
CIMCubeSDKLoader
Globe
Scene

Namespaces

Analysis
Animation
Controls
Global
Graphic
Layer
Simulation
Utils
Widgets

Members

<static, constant> exports.VersionInfo

baseMap :Object

底图设置
Type:
  • Object
Deprecated:
  • This property is deprecated and will be removed in CIMCube.

<readonly> camera :Glodon.CIMCube.Camera

相机
Type:

<readonly> globe :Glodon.CIMCube.Globe

球体
Type:

hardwareAA :Boolean

硬件抗锯齿开启/关闭
Type:
  • Boolean
Deprecated:
  • This property is deprecated and will be removed in CIMCube.

<readonly> layerManager :Glodon.CIMCube.Layer.LayerManager

图层管理
Type:

logarithmicDepthBuffer :Boolean

log深度开启
Type:
  • Boolean
Deprecated:
  • This property is deprecated and will be removed in CIMCube.

<readonly> scene :Glodon.CIMCube.Scene

场景
Type:

screenSpaceEventHandler :Glodon.CIMCube.ScreenSpaceEventHandler

屏幕空间事件处理
Type:
  • Glodon.CIMCube.ScreenSpaceEventHandler
Deprecated:
  • This property is deprecated and will be removed in CIMCube.

shadowQuality :Glodon.CIMCube.Global.Defines.ShadowQuality

阴影质量
Type:
  • Glodon.CIMCube.Global.Defines.ShadowQuality
Deprecated:
  • This property is deprecated and will be removed in CIMCube.

shadowRange :Number

阴影范围
Type:
  • Number
Deprecated:
  • This property is deprecated and will be removed in CIMCube.

terrainShadows :Glodon.CIMCube.Global.Defines.ShadowMode

阴影模式
Type:
Deprecated:
  • This property is deprecated and will be removed in CIMCube.

useDefaultLabel :Boolean

使用默认注记
Type:
  • Boolean
Deprecated:
  • This property is deprecated and will be removed in CIMCube.

useDefaultTerrain :Boolean

使用默认地形
Type:
  • Boolean
Deprecated:
  • This property is deprecated and will be removed in CIMCube.

usePostProcessWater :Boolean

是否使用后期水效果
Type:
  • Boolean
Deprecated:
  • This property is deprecated and will be removed in CIMCube.

Methods

<static> createScene(map, options)

通过配置信息构造地球
Parameters:
Name Type Description
map CIMCube | Object 地图对象
options Object 选项对象
Properties
Name Type Description
defaultView Object 默认视角
globalSettings Object 场景信息
mapLayers Object 图层信息
Returns:
地图对象
Type
CIMCube

<static> setMultiThreadRequestingEnabled(value)

设置多线程数据请求是否开启，该功能默认关闭
Parameters:
Name Type Description
value Boolean true表示开启，反之表示关闭

<static> setOcclusionCullingEnabled(value)

设置遮挡剔除功能是否全局启用，默认全局开启；
Parameters:
Name Type Description
value Boolean true表示开启，反之表示关闭

addEventListener(type, listener [, thisArg])

在此事件派发器上添加事件监听.
Parameters:
Name Type Argument Description
type string 事件类型.
listener function 事件监听器.
thisArg Object <optional>
 事件监听器的this指针(可选).
Inherited From:
Overrides:
Returns:
调用时将删除此事件侦听器的函数.
Type
function

disableDefaultTerrain()

关闭默认地形
Deprecated:
  • This function is deprecated and will be removed in CIMCube.

dispatchEvent(event)

在此事件派发器上派发事件.
Parameters:
Name Type Description
event Object 待派发的事件.
Inherited From:
Overrides:

dispose()

释放资源

enableDefaultTerrain()

开启默认地形
Deprecated:
  • This function is deprecated and will be removed in CIMCube.

flyTo()

飞行定位

getFeaturesAtPixel(windowPosition [, options])

通过屏幕坐标拾取对象
Parameters:
Name Type Argument Description
windowPosition Array 屏幕坐标
options Object <optional>
 选项参数
Properties
Name Type Argument Default Description
tolerance Number <optional>
 3 容差，默认为3，值应大于0，单位为像素
layers Array <optional>
 指定图层数组，值为图层的ID

hasEventListener(type [, listener])

检查此事件派发器上是否存在事件监听,如果不传递事件监听器,则判断是否存在指定事件类型的事件监听.
Parameters:
Name Type Argument Description
type string 事件类型
listener function <optional>
 事件监听器(可选).
Inherited From:
Overrides:
Returns:
是否存在指定类型及指定事件监听器的事件监听.
Type
boolean

on()

语法糖. on == addEventListener off == removeEventListeners|removeEventListener fire == dispatchEvent
Inherited From:
Overrides:

releaseCachedResources()

释放基于浏览器缓存机制保存的数据（并非http协议下的缓存文件）

removeEventListener(type, listener)

从此事件派发器上删除指定事件监听.
Parameters:
Name Type Description
type string 事件类型.
listener function 事件监听器.
Inherited From:
Overrides:

removeEventListeners(type)

从此事件派发器上删除事件监听,如果不提供事件类型,则删除全部事件监听.
Parameters:
Name Type Description
type string 事件类型.
Inherited From:
Overrides:

setDebugShowPostRender(value)

检测三角面数与顶点数
Parameters:
Name Type Description
value Boolean 开启/关闭
Deprecated:
  • This function is deprecated and will be removed in CIMCube.