Class: Viewer

//初始化viewer部件
var viewer = new SuperMap3D.Viewer('Container', {
    //使用 STK World Terrain
    terrainProvider : new SuperMap3D.SuperMapTerrainProvider({
        url : 'https://assets.agi.com/stk-terrain/world'
    }),
    //使用OpenStreetMaps
    imageryProvider : SuperMap3D.createOpenStreetMapImageryProvider({
        url : 'https://a.tile.openstreetmap.org/'
    }),
});

//添加基础拖放功能
viewer.extend(SuperMap3D.viewerDragDropMixin);

//处理删除文件时遇到错误，显示弹出式警告。
viewer.dropError.addEventListener(function(dropHandler, name, error) {
    console.log(error);
    window.alert(error);
});

Members

allowDataSourcesToSuspendAnimationBoolean

获取或设置数据源是否可以暂时暂停动画，以避免向用户显示不完整的图片。例如，假如后台正在处理异步函数，在几何图形准备就绪前，时钟不会前进。

readonly animationAnimation

获取动画(Animation)部件。

readonly baseLayerPickerBaseLayerPicker

获取基础图层拾取器(BaseLayerPicker)对象。

readonly bottomContainerElement

获取窗口底部包含CreditDisplay及其他潜在信息的DOM元素。

readonly cameraCamera

获取相机(camera)对象。

readonly canvasCanvas

获取画布(canvas)对象。

readonly cesiumLogoElement

获取Cesium的logo元素。

readonly clockClock

获取时钟(clock)对象。

clockTrackedDataSourceDataSource

获取或设置跟踪viewer时钟的数据源。

readonly clockViewModelClockViewModel

获取时钟视图模型。

readonly containerElement

获取父容器。

readonly dataSourceDisplayDataSourceDisplay

获取用于DataSource的显示。

readonly dataSourcesDataSourceCollection

获取或设置将要被可视化的数据源DataSource实例集合。

readonly entitiesEntityCollection

获取与特定数据源无关的实体集合。这是访问dataSourceDisplay.defaultDataSource.entities的快捷方式。

readonly fullscreenButtonFullscreenButton

获取全屏按钮(FullscreenButton)对象。

readonly geocoderGeocoder

获取地理编码器(Geocoder)对象。

readonly homeButtonHomeButton

获取主页按钮(HomeButton)对象。

readonly imageryLayersImageryLayerCollection

获取将在地球上渲染的影像图层集合。

readonly navigationHelpButtonNavigationHelpButton

获取导航帮助按钮(NavigationHelpButton)对象。

readonly postProcessStagesPostProcessStageCollection

获取后处理阶段。

readonly projectionPickerProjectionPicker

获取投影拾取器。

resolutionScaleNumber

获取或设置渲染分辨率的缩放因子。 值小于1.0时能够在不太强大的设备上提高性能；相反，值大于1.0时将会以更高分辨率渲染，然后按比例缩小，以此提高视觉保真度。 例如窗口部件以640x480的大小布设，将此属性设置为0.5，将导致场景以320x240分辨率渲染，场景按比例放大，而将其设置为2.0将导致场景以1280x960渲染，场景按比例缩小。

Default Value:

1.0

Methods

destroy()

释放对象占用的资源。

extend(mixin, options)

使用提供的mixin来扩展基础viewer功能。 mixin 可以向提供的viewer实例增加额外的属性、功能或者其他行为。

Name	Type	Description
mixin	Viewer~ViewerMixin	指定将要被添加到实例的Viewer mixin对象。
options	Object	可选 指定传递给mixin函数的options对象。

See:

• viewerDragDropMixin

flyTo(target){Promise.<Boolean>}

相机飞向指定的实体、实体集或数据源。如果数据源仍在加载中，或者可视化仍在进行，此方法在执行飞行前需等待数据准备就绪。

offset变量由在局部“东-北-上”参考系（中心点为包围球中心）中的“方位角/俯仰角/范围”表示。方位角和俯仰角的角度在局部“东-北-上”参考系中定义。方位角heading是从y轴开始并朝向x轴增加的角度值。俯仰角pitch是从xy平面开始的旋转角度，俯仰角为正表示位于平面上方，为负表示位于平面下方。距离range表示距中心点的距离，如果range为0，则将计算一个范围使得整个包围球可见。

在二维中必须有自上而下的视图。相机位于俯视目标上方。range为在目标上方的高度；headingy由偏移量确定，若不能根据偏移量确定方位角，heading为北方向。

Name	Type	Default	Description
target	Entity | Array.<Entity> | EntityCollection | DataSource | ImageryLayer | Promise.<(Entity|Array.<Entity>|EntityCollection|DataSource|ImageryLayer)>		指定要查看的实体、实体集、数据源或影像图层。还可以指定一个promise来解析前述类型之一。
options.duration	Number	3.0	可选 飞行持续时间（以秒为单位）。
options.maximumHeight	Number		可选 飞行中的最大高度。
options.offset	HeadingPitchRange		可选 在以目标为中心的局部“东-北-上”参考系中，距离目标的偏移量。

Returns:

Type	Description
Promise.<Boolean>	飞行成功时，promise被解析为true；如果实体未在场景中可视化或飞行取消，promise被解析为false。

forceResize()

强制重调，使得部件重新考虑包括部件大小、credit放置等布局。

isDestroyed(){Boolean}

返回是否释放对象占用的资源。

Returns:

Type	Description
Boolean	true表示已释放占用资源，否则返回false。

render()

渲染场景。除非useDefaultRenderLoop设置为false，否则将自动调用此函数。

resize()

调整部件大小以匹配容器。 此函数将根据需求自动调用，除非useDefaultRenderLoop 设置为false。

zoomTo(target, offset){Promise.<Boolean>}

异步设置相机，以查看指定的实体、实体集或数据源。如果数据源仍在加载中，或者可视化仍在进行，此方法在执行缩放前需等待数据准备就绪。

offset变量由在局部“东-北-上”参考系（中心点为包围球中心）中的“方位角/俯仰角/范围”表示。方位角和俯仰角的角度在局部“东-北-上”参考系中定义。方位角heading是从y轴开始并朝向x轴增加的角度值。俯仰角pitch是从xy平面开始的旋转角度，俯仰角为正表示位于平面上方，为负表示位于平面下方。距离range表示距中心点的距离，如果range为0，则将计算一个范围使得整个包围球可见。

在二维中必须有自上而下的视图。相机位于俯视目标的上方。range 为在目标上方的高度；heading有偏移量确定，不然不能根据偏移量确定方位角，heading为北方向。

Name	Type	Description
target	Entity | Array.<Entity> | EntityCollection | DataSource | ImageryLayer | Promise.<(Entity|Array.<Entity>|EntityCollection|DataSource|ImageryLayer)>	指定要查看的实体、实体集、数据源或影像图层。还可以指定一个promise来解析前述类型之一。
offset	HeadingPitchRange	可选 指定距局部“东-北-上”参考系中心的偏移量。

Returns:

Type	Description
Promise.<Boolean>	缩放成功时，promise被解析为true；如果实体未在场景中可视化或缩放取消，promise被解析为false。

Type Definitions

ViewerMixin(viewer, options)

增加具有附加功能的Viewer实例的函数。

Name	Type	Description
viewer	Viewer	viewer实例对象。
options	Object	传递给mixin函数的options对象。

See:

• Viewer#extend