Cesium 核心类Viewer - cytggit/Map-openlayers GitHub Wiki

Viewer类是cesium的核心类，是地图可视化展示的主窗口，cesium程序应用的切入口，扮演必不可少的核心角色。

• destroy()

  移除viewer viewer.destroy();

• isDestroyed() → Boolean

  是否移除了viewer的flag alert(viewer.isDestroyed());

  Returns: true if the object has been destroyed, false otherwise.

• extend(mixin, options)

  扩展插件

• flyTo(target, options) → Promise.

  通过动画方式转移到某个位置

    target 	Entity | Array.<Entity> | EntityCollection | DataSource | ImageryLayer | Promise.<(Entity|Array.<Entity>|EntityCollection|DataSource|ImageryLayer)> 	The entity, array of entities, entity collection, data source or imagery layer to view. You can also pass a promise that resolves to one of the previously mentioned types.
    options 	Object 	optional Object with the following properties:
            duration 	Number 	3.0 	optional The duration of the flight in seconds.  飞行的时间以秒为单位。
            maximumHeight 	Number 		optional The maximum height at the peak of the flight.   最大峰值的高度飞行。
            offset 	HeadingPitchRange 	optional The offset from the target in the local east-north-up reference frame centered at the target   偏移量从目标在当地east-north-up参考系为中心的目标。
  

• zoomTo(target, offset) → Promise.

  直接转移到某个位置

    target 	Entity | Array.<Entity> | EntityCollection | DataSource | ImageryLayer | Promise.<(Entity|Array.<Entity>|EntityCollection|DataSource|ImageryLayer)> 	The entity, array of entities, entity collection, data source or imagery layer to view. You can also pass a promise that resolves to one of the previously mentioned types.
    offset 	HeadingPitchRange 	optional The offset from the center of the entity in the local east-north-up reference frame.
  

• forceResize()

  不知道

• resize()

  useDefaultRenderLoop为true时自动调用本函数

• render()

  useDefaultRenderLoop为true时自动渲染场景 用在刷新时？？？

new Cesium.Viewer(container, options);

• container：

  type：Element |String

  描述：一般是地图主窗口div的ID

• options：API Reference（加粗是常用参数）

  1、animation: false,//控制是否显示视图动画控件(左下角)。 默认true

  2、baseLayerPicker: false,//控制是否显示底图切换控件。底图和投影选择。默认true

  3、fullscreenButton: false,//控制是否显示全屏控件。默认true

  4、vrButton: true,//控制是否显示VR（双屏）模式控件。默认false

  5、geocoder: false,//控制是否显示地名查找控件。默认true

  6、homeButton: false,//控制是否显示主页控件。控制viewer回到初始状态（比例尺和中心点）。默认true

  7、infoBox: true,//控制是否显示cesium默认气泡窗口控件。点击要素之后显示的信息（气泡窗口）。默认true

  8、sceneModePicker: true,//控制2D,3D,2.5D。默认true

  9、selectionIndicator:true,//控制是否显示选中地图要素标识控件。默认true

  10、timeline:false,//控制是否显示时间轴控件。指示当前时间，并允许用户跳转到特定时间。默认true

  11、navigationHelpButton:false,//控制是否显示帮助按钮(mouse or touch如何拖拽)。默认true

  12、navigationInstructionsInitiallyVisible: false,//帮助按钮相关，不懂！！！

  13、scene3DOnly: true,//3D,true时sceneModePicker为false。默认false

  14、clockViewModel://控制时间的模型

  15、selectedImageryProviderViewModel://不解释

  16、imageryProviderViewModels: /设置自己的地图服务-影像图/,//设置地图切换控件绑定底图数据源，跟baseLayerPicker属性设置true配合使用。这里的imagerProviderViewModels参数要是不设置的话，默认会自动创建一组在线地图底图服务的数据源，假如想要配置一些自己服务器发布的地图服务的话，应该自己设置一组地图服务数据源来替换。

  17、selectedTerrainProviderViewModel://不解释

  18、terrainProviderViewModels:/设置自己的地图服务-地形图/,//设置地图切换控件绑定底图数据源，跟baseLayerPicker属性设置true配合使用。这里的terrainProviderViewModels参数要是不设置的话，默认会自动创建一组在线地形图服务的数据源，假如想要配置一些自己服务器发布的地形图服务的话，应该自己设置一组地形图数据源来替换；

  19、imageryProvider://不解释

  20、terrainProvider://不解释

  21、skyBox://天空（星星）的渲染，3D时有效

  22、skyAtmosphere://地球周围的光芒，3D时有效

  23、fullscreenElement: 'cesiumContainer',//全屏时被放进全屏的页面元素，fullscreenButton为true时有效。默认document.body

  24、useDefaultRenderLoop:true,//控制渲染循环，false的时候不出图。默认true

  25、targetFrameRate://使用默认render loop时的帧率 //不懂！！！

  26、showRenderLoopErrors://渲染循环发生错误时提示error

  27、automaticallyTrackDataSourceClocks://自动追踪最近添加的数据源的时钟设置 不懂！！！

  28、contextOptions://上下文和WebGL创建属性对应options传递给Scene。不懂！！！

  29、sceneMode: Cesium.SceneMode.SCENE2D,//控制默认3D模式，可设置默认为2D\3D\2.5D模式

  30、mapProjection://地图投影，2D、哥伦布视图有效

  31、globe://地球渲染，

  32、orderIndependentTranslucency://不懂！！！如果配置支持则使用独立的半透明

  33、creditContainer: 'map',//底部信息展示的窗口，没有指定的话，默认在控件本身的底部

  34、dataSources://需要进行可视化的数据源的集合

  35、terrainExaggeration:1.0,//用来夸大地形的标量。

  36、shadows: true,//是否投下阴影。没试出来效果

  37、terrainShadows://确定地形或接收来自太阳的阴影。

  38、mapMode2D:Cesium.MapMode2D.ROTATE,//控制地图缩放和旋转，默认可滚动缩放，不可旋转。2D时有效

  39、projectionPicker:true,//控制投影。默认false