1、版本
1.79.1
2、new Cesium.Viewer(container,options)
参数名称 | 类型 | 描述 |
---|---|---|
container | html元素或html元素id | 地图容器 |
options | Viewer.ConstructorOptions | 描述初始化选项的对象 |
3、Cesium.Viewer.ConstructorOptions
名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
animation | bool | true | 如果设置为false,则不会创建动画小部件 |
baseLayerPicker | bool | true | 如果设置为false,则不会创建底图切换小部件 |
fullscreenButton | bool | true | 如果设置为false,则不会创建全屏小部件 |
vrButton | bool | false | 如果设置为true,将创建VRButton小部件 |
geocoder | bool或Array | true | 如果设置为false,将不会创建地理位置搜索小部件 |
homeButton | bool | true | 如果设置为false,将不会创建全图小部件 |
infoBox | bool | true | 如果设置为false,将不会创建标注小部件 |
sceneModePicker | bool | true | 如果设置为false,将不会创建切换2D、3D和CV模式的小部件 |
timeline | bool | true | 如果设置为false,将不会创建展示当前时间和允许用户在进度条上拖到到任何一个指定的时间的小部件 |
navigationHelpButton | bool | true | 如果设置为false,将不会创建帮助提示,如何操作数字地球的小部件 |
navigationInstructionsInitiallyVisible | bool | true | 如果导航指令最初可见,则为True;如果在用户明确单击按钮之前不应显示,则为false |
scene3DOnly | bool | false | 如果为true,则每个几何体实例将仅在三维中渲染以节省GPU内存 |
shouldAnimate | bool | false | 如果时钟在默认情况下尝试提前模拟时间,则为true,否则为false。此选项优先于设置查看器#clockViewModel |
clockViewModel | ClockViewModel | new ClockViewModel(clock) | 用于控制当前时间的时钟视图模型 |
selectedImageryProviderViewModel | ProviderViewModel | 当前基础图像层的视图模型,如果未提供,则使用第一个可用的基础层。仅当“baseLayerPicker”设置为true时,此值才有效。 | |
imageryProviderViewModels | Array.ProviderViewModel | createDefaultImageryProviderViewModels() | 要从BaseLayerPicker中选择的ProviderViewModels数组。仅当“baseLayerPicker”设置为true时,此值才有效。 |
selectedTerrainProviderViewModel | ProviderViewModel | 当前基本地形图层的视图模型,如果未提供,则使用第一个可用的基本图层。仅当“baseLayerPicker”设置为true时,此值才有效。 | |
terrainProviderViewModels | Array.ProviderViewModel | createDefaultTerrainProviderViewModels() | 要从BaseLayerPicker中选择的ProviderViewModels数组。仅当“baseLayerPicker”设置为true时,此值才有效。 |
imageryProvider | ImageryProvider | createWorldImagery() | 要使用的图像提供程序。仅当“baseLayerPicker”设置为false时,此值才有效。 |
terrainProvider | TerrainProvider | new EllipsoidTerrainProvider() | 要使用的地形提供程序 |
skyBox | SkyBox 或 false | 用来渲染星星的天空盒子。未定义时,使用默认星号。如果设置为false,则不会添加天空盒、太阳或月亮。 | |
skyAtmosphere | SkyAtmosphere或 false | 蔚蓝的天空,还有环绕地球边缘的光芒。设置为false可将其关闭。 | |
fullscreenElement | html元素或html元素id | document.body | 按下全屏按钮时要置于全屏模式的元素或id |
useDefaultRenderLoop | bool | true | 如果此小部件应控制渲染循环,则为True,否则为false |
targetFrameRate | Number | 使用默认渲染循环时的目标帧速率。 | |
showRenderLoopErrors | bool | true | 如果为true,则如果出现渲染循环错误,此小部件将自动向用户显示包含错误的HTML面板。 |
useBrowserRecommendedResolution | bool | true | 如果为true,则以浏览器建议的分辨率渲染并忽略window.devicePixelRatio设备 |
automaticallyTrackDataSourceClocks | bool | true | 如果为true,此小部件将自动跟踪新添加的数据源的时钟设置,并在数据源的时钟更改时进行更新。如果要单独配置时钟,请将其设置为false。 |
contextOptions | Object | 与传递到场景的选项相对应的上下文和WebGL创建属性。 | |
sceneMode | SceneMode | SceneMode.SCENE3D | 初始场景模式。 |
mapProjection | MapProjection | new GeographicProjection() | 在二维和哥伦布视图模式下使用的地图投影。 |
globe | Globe 或 false | new Globe(mapProjection.ellipsoid) | 场景中要使用的地球仪。如果设置为false,则不会添加任何全局。 |
orderIndependentTranslucency | bool | true | 如果为true且配置支持,请使用顺序无关的半透明 |
creditContainer | html元素或html元素id | 包含CreditDisplay的DOM元素或ID。如果未指定,数据源将添加到小部件本身的底部。 | |
creditViewport | html元素或html元素id | 包含CreditDisplay的DOM元素或ID。如果未指定,展示商标版权将添加到小部件本身的底部。 | |
dataSources | DataSourceCollection | new DataSourceCollection() | 由小部件可视化的数据源集合。如果提供了此参数,则假定实例归调用方所有,并且在销毁查看器时不会销毁实例 |
terrainExaggeration | Number | 1.0 | 用来夸大地形的标量。请注意,地形放大不会修改任何其他基本体,因为它们是相对于椭球体定位的。 |
shadows | bool | false | 确定阴影是否由光源投射。 |
terrainShadows | ShadowMode | ShadowMode.RECEIVE_ONLY | 确定地形是否从光源投射或接收阴影 |
mapMode2D | MapMode2D | MapMode2D.INFINITE_SCROLL | 确定2D贴图是可旋转的还是可以在水平方向上无限滚动 |
projectionPicker | bool | false | 如果设置为true,将创建ProjectionPicker小部件。 |
requestRenderMode | bool | false | 如果为true,则仅当场景中的更改决定需要时才会渲染帧。启用可减少应用程序的CPU/GPU使用量,并在移动设备上使用更少的电池,但需要使用Scene#requestRender在此模式下显式渲染新帧。在许多情况下,在API的其他部分对场景进行更改之后,这是必需的。请参见使用显式渲染提高性能。 |
maximumRenderTimeChange | Number | 0.0 | 如果requestRenderMode为true,则此值定义请求渲染前允许的最大模拟时间更改。请参见使用显式渲染提高性能。 |
4、实例
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Document</title>
<script src="https://cesium.com/downloads/cesiumjs/releases/1.79.1/Build/Cesium/Cesium.js"></script>
<link href="https://cesium.com/downloads/cesiumjs/releases/1.79.1/Build/Cesium/Widgets/widgets.css"
rel="stylesheet">
</head>
<div id="cesiumContainer" style="height: 100%;"></div>
<body>
<script>
Cesium.Ion.defaultAccessToken =
`eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIwZGNiMzg5Ni04NTE1LTRiOGUtYTBhYy0xYzNjMGJiMTg3MTYiLCJpZCI6NDYxNDcsImlhdCI6MTYxNTg4MzE4N30.ncSbujoeyHOQR8yngSeeugyAqcKqINS7dRQUOT--c7I`
let viewer = new Cesium.Viewer('cesiumContainer', {
scene3DOnly: true,
baseLayerPicker: false
})
</script>
</body>
</html>