#### # new SceneView(options)

视图类

#### 参数:

名称 | 类型 | 默认值 | 描述
--- | --- | --- | ---
`options` | Object |  | 构造参数
`Map` | Map |  | 图层管理器
`viewId` | String |  | 图层容器ID
`enableAnimation` | Boolean | true | 视点跳转或漫游时，是否启用动画
`skyBox` | Boolean | Cesium.SkyBox |  | 天空盒设置，可传入天空盒对象或者布尔值，当该值为false时，不显示天空盒
`skyAtmosphere` | Boolean | Cesium.SkyAtmosphere |  | 大气设置，可传入大气设置对象或者布尔值，当该值为false时，不显示大气层
`sceneMode` | SceneMode | SceneMode.scene3D | 场景模式
`enableShadows` | Boolean | false | 是否启用阴影效果
`terrainShadowMode` | ShadowMode | ShadowMode.receive | 地形阴影模式
`enableGeocoderWidget` | Boolean | false | 启用地理编码器控件
`enableHomeButtonWidget` | Boolean | false | 启用Home按钮控件
`enableSceneModePickerWidget` | Boolean | false | 启用场景控制器控件
`enableBaseLayerPickerWidget` | Boolean | false | 启用基础图层选择器控件
`enableNavigationHelpButtonWidget` | Boolean | false | 启用导航帮助按钮控件
`enableAnimationWidget` | Boolean | false | 启用动画控件
`enableTimeLineWidget` | Boolean | false | 启用时间轴控件
`enableFullScreenButtonWidget` | Boolean | false | 启用全屏按钮控件
`enableVRButtonWidget` | Boolean | false | 启用VR按钮控件
`enableFPSWidget` | Boolean | false | 启用FPS控件
`center` | Point | new Point({coordinates:[0,0]}) | 地图视图中心点
`scale` | Number |  | 地图视图比例尺
`zoom` | Number |  | 地图视图层级
`minZoom` | Number | 0 | 最小层级
`maxZoom` | Number | 19 | 最大层级

查看源代码 cesium/view/SceneView.js, line 20

绑定事件:

- BaseView#event:鼠标点击事件
- BaseView#event:鼠标双击事件
- BaseView#event:鼠标按下事件
- BaseView#event:鼠标抬起事件
- BaseView#event:鼠标右键点击事件
- BaseView#event:鼠标移动事件
- BaseView#event:地图视图改变事件

##### 支持如下方法：

[1、视点跳转]
[2、导出场景视图的配置文件]
[3、通过一个配置生成一个场景视图对象]
[4、屏幕像素坐标点转地理坐标点]
[5、地理坐标点转屏幕像素坐标点]
[6、获取当前视图容器的宽高]
[7、获取当前视图中心点]
[8、获取当前视图的地理范围]
[9、获取当前层级]
[10、获取当前比例尺]
[11、地图比例尺对应的层级]
[12、地图层级对应的比例尺]
`13、注册事件`
`14、移除事件`
[15、获取实际的M3DSet对象]

##### 示例

<h7>初始化三维视图对象</h7>

    // ES5引入方式
    const { Map, SceneView } = Zondy
    // ES6引入方式
    import { Map, SceneView } from "@mapgis/webclient-cesium-plugin"
    // 初始化图层管理容器
    const map = new Map();
    // 初始化地图视图对象
    const sceneView = new SceneView({
      // 视图id
      viewId: "mapgis-3d-viewer",
      // 图层管理容器
      map: map
    });

### 继承关系

- Evented

### 成员变量

类型: Boolean

#### # readonly enableAnimation

视点跳转或漫游时，是否启用动画

查看源代码 cesium/view/SceneView.js, line 94

类型: Boolean

#### # enableAnimationWidget

启用动画控件

查看源代码 cesium/view/SceneView.js, line 173

类型: Boolean

#### # enableBaseLayerPickerWidget

启用基础图层选择器控件

查看源代码 cesium/view/SceneView.js, line 157

类型: Boolean

#### # enableFPSWidget

启用FPS控件

查看源代码 cesium/view/SceneView.js, line 205

类型: Boolean

#### # enableFullScreenButtonWidget

启用全屏按钮控件

查看源代码 cesium/view/SceneView.js, line 189

类型: Boolean

#### # enableGeocoderWidget

启用地理编码器控件

查看源代码 cesium/view/SceneView.js, line 133

类型: Boolean

#### # enableHomeButtonWidget

启用Home按钮控件

查看源代码 cesium/view/SceneView.js, line 141

类型: Boolean

#### # enableNavigationHelpButtonWidget

启用导航帮助按钮控件

查看源代码 cesium/view/SceneView.js, line 165

类型: Boolean

#### # enableSceneModePickerWidget

启用场景控制器控件

查看源代码 cesium/view/SceneView.js, line 149

类型: Boolean

#### # readonly enableShadows

是否启用阴影效果

查看源代码 cesium/view/SceneView.js, line 118

类型: Boolean

#### # enableTimeLineWidget

启用时间轴控件

查看源代码 cesium/view/SceneView.js, line 181

类型: Boolean

#### # enableVRButtonWidget

启用VR按钮控件

查看源代码 cesium/view/SceneView.js, line 197

类型: SceneMode

#### # readonly sceneMode

场景模式

查看源代码 cesium/view/SceneView.js, line 112

类型: Boolean | Cesium.SkyAtmosphere

#### # readonly skyAtmosphere

大气设置，可传入大气设置对象或者布尔值，当该值为false时，不显示大气层

查看源代码 cesium/view/SceneView.js, line 106

类型: Boolean | Cesium.SkyBox

#### # readonly skyBox

天空盒设置，可传入天空盒对象或者布尔值，当该值为false时，不显示天空盒

查看源代码 cesium/view/SceneView.js, line 100

类型: ShadowMode

#### # readonly terrainShadowMode

地形阴影模式

查看源代码 cesium/view/SceneView.js, line 124

### 方法

#### # static fromJSON(json)

通过一个配置生成一个场景视图对象

#### 参数:

名称 | 类型 | 描述
--- | --- | ---
`json` | Object | 场景视图配置

查看源代码 cesium/view/SceneView.js, line 937

返回值:
类型: SceneView

#### # flyTo(options)

视点跳转

#### 参数:

名称 | 类型 | 默认值 | 描述
--- | --- | --- | ---
`options` |  |  | 跳转参数
`center` | Array |  | 相机要跳转的中心点，单位度，[精度，纬度，高程]
`duration` | Number | 2 | 相机飞行到终点时的持续时间，单位秒
`extent` | Extent |  | 相机要飞行的某个范围
`orientation` | Object |  | 相机飞行到终点时的视角朝向，包含偏航角、俯仰角和翻滚角
`complete` | function |  | 相机飞行到终点时触发的函数
`cancel` | function |  | 相机取消飞行时触发的函数
`endTransform` | Object |  | 相机飞行到终点时的矩阵
`maximumHeight` | Number |  | 相机飞行的最大高度
`pitchAdjustHeight` | Number |  | 如果相机的飞行高度高于该值，则调整飞行过程中的俯仰角使相机视角向下看，并将地球保持在相机视窗中
`flyOverLongitude` | Number |  | 强制让相机绕着地球飞行指定经度，直到到达终点位置
`flyOverLongitudeWeight` | Number |  |

查看源代码 cesium/view/SceneView.js, line 473

##### 示例

<h7>按范围跳转</h7>

    // ES5引入方式
    const { Map, SceneView } = Zondy
    const { IGSMapImageLayer } = Zondy.Layer
    const { LayerEventType } = Zondy.Enum
    const { Extent } = Zondy.Geometry
    // ES6引入方式
    import { Map, SceneView, IGSMapImageLayer, LayerEventType, Extent } from "@mapgis/webclient-cesium-plugin"
    // 初始化图层管理容器
    const map = new Map();
    // 初始化地图视图对象
    const sceneView = new SceneView({
      // 视图id
      viewId: "mapgis-3d-viewer",
      // 图层管理容器
      map: map
    });
    // 添加一个地图图层
    const igsMapImageLayer = new IGSMapImageLayer({
      url: 'http://webclient.smaryun.com:8089/igs/rest/services/Map/Hubei4326/MapServer'
    });
    map.add(igsMapImageLayer);
    // 图层加载完毕
    igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
      console.log("加载完毕:", result.layer)
      // 视点跳转
      sceneView.flyTo({
        extent: new Extent({
          xmin: 108.34341,
          ymin: 29.01258222765238,
          xmax: 116.15093956121316,
          ymax: 33.29320177370206
        })
      })
    })

<h7>跳转中心点</h7>

    // ES5引入方式
    const { Map, SceneView } = Zondy
    const { IGSMapImageLayer } = Zondy.Layer
    const { LayerEventType } = Zondy.Enum
    // ES6引入方式
    import { Map, SceneView, IGSMapImageLayer, LayerEventType } from "@mapgis/webclient-cesium-plugin"
    // 初始化图层管理容器
    const map = new Map();
    // 初始化地图视图对象
    const sceneView = new SceneView({
      // 视图id
      viewId: "mapgis-3d-viewer",
      // 图层管理容器
      map: map
    });
    // 添加一个地图图层
    const igsMapImageLayer = new IGSMapImageLayer({
      url: 'http://webclient.smaryun.com:8089/igs/rest/services/Map/Hubei4326/MapServer'
    });
    map.add(igsMapImageLayer);
    // 图层加载完毕
    igsMapImageLayer.on(LayerEventType.layerViewCreated, function (result) {
      console.log("加载完毕:", result.layer)
      // 视点跳转
      sceneView.flyTo({
        center: [113, 30, 1000000]
      })
    })

#### # getCenter()

获取当前视图中心点

查看源代码 cesium/view/SceneView.js, line 671

返回值:

当前视图容器的宽高对象

类型: Object

#### # getExtent()

获取当前视图的地理范围

查看源代码 cesium/view/SceneView.js, line 716

返回值:

获取当前视图的地理范围

类型: Extent

#### # getInnerLayer(layer)

#### 参数:

名称 | 类型 | 描述
--- | --- | ---
`layer` | IGSSceneLayer | IGSSceneSubLayer | 场景图层或场景图的子图层

查看源代码 cesium/view/SceneView.js, line 736

返回值:

MapGISM3DSet数组或MapGISM3DSet对象或空对象

类型: Array.<MapGISM3DSet> | MapGISM3DSet | undefined

#### # getScale()

获取当前比例尺

查看源代码 cesium/view/SceneView.js, line 849

返回值:

比例尺 实际10000米:地图1米

类型: Number

#### # getSize()

获取当前视图容器的宽高，单位像素

查看源代码 cesium/view/SceneView.js, line 659

返回值:

当前视图容器的宽高对象

类型: Object

#### # getZoom()

获取当前层级

查看源代码 cesium/view/SceneView.js, line 822

返回值:

层级

类型: Number

#### # off(typesopt, fnopt, contextopt)

移除事件
示例如下:
[1、移除一个事件的指定回调函数]
[2、移除一个事件的所有回调函数]
[3、移除多个事件的同一个指定的回调函数]
[4、移除多个指定事件的回调函数]
[5、删除时指定上下文 - types类型为字符串]
[6、删除时指定上下文 - types类型为对象]

#### 参数:

名称 | 类型 | 描述
--- | --- | ---
`types` | string | 移除指定事件类型上绑定的回调函数 当类型为字符串时，可以移除单个或多个事件类型绑定的回调函数，单个事件："click"，多个事件：以空格分割:"click double-click"； 当types为对象时，使用如下方式移除事件：{'click': onClickFun, 'mouse-move': onMouseMoveFun}
`fn` | function | 事件回调函数，当types为字符串，且不指定要删除的回调函数时，删除该事件上的所有回调函数
`context` | Object | 事件回调函数的this关键字将指向的对象

Inherited From:
  - Evented#off

查看源代码 common/base/Evented.js, line 269

返回值:

当前实例

类型: Object

##### 示例

##### 移除一个事件的指定回调函数

    // 一个事件的回调函数
    const clickFunction = function (event) {
      console.log("点击事件:", event)
    }
    // 调用MapView或SceneView的off方法移除一个事件的回调函数
    view.off('click', clickFunction)

##### 移除一个事件的所有回调函数

    // 一个事件的回调函数1
    const clickFunction1 = function (event) {
      console.log("点击事件1:", event)
    }

    // 一个事件的回调函数2
    const clickFunction2 = function (event) {
      console.log("点击事件2:", event)
    }

    // 调用MapView或SceneView的off方法移除一个事件的所有回调函数
    // 不指定回调函数，则移除该事件上的所有绑定的回调函数
    view.off('click')

##### 移除多个事件的同一个指定的回调函数

    // 多个事件的同一个回调函数
    const eventFunction = function (event) {
      console.log("事件:", event)
    }
    // 调用MapView或SceneView的off方法移除多个事件的同一个指定的回调函数
    view.off('click double-click', eventFunction)

##### 移除多个指定事件的回调函数

    // 一个事件的回调函数
    const clickFunction = function (event) {
      console.log("click事件:", event)
    }
    // 调用MapView或SceneView的off方法移除多个指定事件的回调函数
    view.off({
       // 移除click事件上一个指定的函数
      "click": clickFunction,
      // 移除double-click上所有指定的函数
      "double-click": undefined
    })

##### 删除时指定上下文 - types类型为字符串

    // 一个事件的回调函数
    const clickFunction = function (event) {
      console.log("点击事件:", event)
    }
    // 调用MapView或SceneView的off方法移除一个事件的回调函数
    view.off('click', clickFunction, view)
    // 调用MapView或SceneView的off方法移除一个事件的所有回调函数
    view.off('click', undefined, view)

##### 删除时指定上下文 - types类型为对象

    // 一个事件的回调函数
    const clickFunction = function (event) {
      console.log("click事件:", event)
    }
    // 调用MapView或SceneView的off方法移除多个指定事件的回调函数
    view.off({
       // 移除click事件上一个指定的函数
      "click": clickFunction,
      // 移除double-click上所有指定的函数
      "double-click": undefined
    }, view)

#### # on(typesopt, fnopt, contextopt)

注册一个新的监听事件;
示例如下：
[1、注册一个事件]
[2、一次注册多个事件 - 同一个回调函数]
[3、一次注册多个事件 - 分别指回调应函数]
[4、当types为字符串时 - 指定上下文]
[5、当types为对象时 - 指定上下文]

#### 参数:

名称 | 类型 | 默认值 | 描述
--- | --- | --- | ---
`types` | String | Object | null | 事件类型 当types为字符串时，可以定义单个或多个事件，单个事件："click"，多个事件：以空格分割:"click double-click"； 当types为对象时，使用如下方式指定事件：{'click': onClickFun, 'mouse-move': onMouseMoveFun}
`fn` | function | null | 事件回调函数
`context` | Object | null | 事件回调函数的this关键字将指向的对象

Inherited From:
  - Evented#on

查看源代码 common/base/Evented.js, line 173

返回值:

当前实例

类型: Object

##### 示例

##### 注册一个事件

    // 初始化一个点击事件回调函数
    const clickFunction = function (event) {
      console.log("点击事件:", event)
    }
    // 调用MapView或SceneView的on方法注册一个点击事件
    view.on('click', clickFunction)

##### 一次注册多个事件 - 同一个回调函数

    // 初始化一个事件回调函数
    const eventFunction = function (event) {
      console.log("事件:", event)
    }

    // 调用MapView或SceneView的on方法注册多个事件
    // 多个事件类型使用同一个回调函数
    view.on('click right-click-down', eventFunction)

##### 一次注册多个事件 - 分别指回调应函数

    // 初始化一个左键点击事件回调函数
    const clickFunction = function (event) {
      console.log("click事件:", event)
    }

    // 初始化一个右键按下事件回调函数
    const rightClickFunction = function (event) {
      console.log("right-click-down事件:", event)
    }

    // 调用MapView或SceneView的on方法注册多个事件
    // 每一个事件类型，使用单独的回调函数
    // 注意使用此种方式，一种类型的事件仅能指定一个回调函数
    view.on({
      "click": clickFunction,
      "right-click-down": rightClickFunction
    })

##### 指定上下文 - types类型为字符串

    // 初始化一个点击事件回调函数
    const clickFunction = function (event) {
      console.log("点击事件:", event)
      console.log("上下文对象:", this)
    }
    // 调用MapView或SceneView的on方法注册一个点击事件
    // 指定view为回调函数的上下文对象
    view.on('click', clickFunction, view)

##### 指定上下文 - types类型为对象

    // 初始化一个点击事件回调函数
    const clickFunction = function (event) {
      console.log("点击事件:", event)
      console.log("上下文对象:", this)
    }
    // 调用MapView或SceneView的on方法注册一个点击事件
    // 指定view为回调函数的上下文对象
    view.on({
      "click": clickFunction,
      "right-click-down": clickFunction
    }, view)

#### # toJSON()

导出场景视图的配置文件

查看源代码 cesium/view/SceneView.js, line 556

返回值:

导出的配置文件

类型: Object

#### # toMap(screenPoint)

屏幕像素坐标点转地理坐标点

#### 参数:

名称 | 类型 | 描述
--- | --- | ---
`screenPoint` | Object | 屏幕像素坐标点，例如{ x: 900, y: 500 }

查看源代码 cesium/view/SceneView.js, line 598

返回值:

地理坐标点

类型: Point

##### 示例

##### 屏幕像素坐标点转地理坐标示例

    // ES6引入方式
    import { SceneView } from "@mapgis/webclient-cesium-plugin"
    import { Map, Point } from "@mapgis/webclient-common"
    // 初始化图层管理容器
    const map = new Map();
    // 初始化地图视图对象
    const sceneView = new SceneView({
     // 视图id
     viewId: "mapgis-3d-viewer",
     // 图层管理容器
     map: map,
    })
    const screenPoint = { x: 900, y: 500 }
    sceneView.toMap(screenPoint)

#### # toScreen(point)

地理坐标点转屏幕像素坐标点

#### 参数:

名称 | 类型 | 描述
--- | --- | ---
`point` | Point | 地理坐标点

查看源代码 cesium/view/SceneView.js, line 641

返回值:

屏幕像素坐标点

类型: Object

##### 示例

##### 地理坐标点转屏幕像素坐标示例

    // ES6引入方式
    import { MapView } from "@mapgis/webclient-leaflet-plugin"
    import { Map, Point, Extent } from "@mapgis/webclient-common"
    // 初始化图层管理容器
    const map = new Map();
    // 初始化地图视图对象
    const mapView = new MapView({
      // 视图id
      viewId: "mapgis-2d-viewer",
      // 图层管理容器
      map: map
    });
    const geoPoint = new Point({ coordinates: [123, 23, 0] })
    sceneView.toScreen(geoPoint)