Camera相机控制了三维场景的视图。有很多方法可以操作Camera，如旋转(rotate)、缩放(zoom)、平移(pan)和飞到目的地(flyTo)。同时也有鼠标和触摸事件用来处理与Camrea的交互，还有API来以编程方式操作摄像机。
# 1. map中视角相关设置和方法
我们在创建地图时，可以在scene的center参数 (opens new window)中来设置默认视角，如：
var map = new mars3d.Map('mars3dContainer', {
scene: {
center: { lat: 25.389914, lng: 119.084961, alt: 1179575, heading: 346, pitch: -60 }
}
})
2
3
4
5
当前map中与相机有关的方式：
| 方法名 | 说明 |
|---|---|
| map.getCameraView() (opens new window) | 可以获取当前视角 |
| map.setCameraView(cameraView, options) (opens new window) | 将相机本身定位至指定位置 |
| map.setCameraViewList(arr, enfun) (opens new window) | 定位到多个相机视角位置，按数组顺序播放 |
| map.flyHome() (opens new window) | 飞行到默认视角， 一般为config.json中的center参数配置的视角。 |
| map.flyTo(target, options) (opens new window) | 飞行定位至 Cesium相关矢量对象 处 |
| map.flyToGraphic(graphic, options) (opens new window) | 飞行定位至 Graphic矢量对象 处 |
| map.flyToExtent(extent, options) (opens new window) | 飞行定位至 矩形区域 处 |
| map.flyToPositions(positions, options) (opens new window) | 飞行定位至 坐标数组 处 |
| map.flyToPoint(point, options) (opens new window) | 视角中心定位至目标点(非相机位置) |
| map.cancelFlyTo() (opens new window) | 停止视角定位等操作 |
# 2. camera相机对象
map.camera (opens new window) 相机对象,由三维地图内部创建的Camera (opens new window)类， 描述了相机的当前状态，包括：位置（position）,朝向（ orientation）, 参考空间（ reference frame）, 视锥体（view frustum）.
一些最常用的方法如下：
- map.camera.setView(options) (opens new window): 在特定位置和方向立即设置相机。
- map.camera.zoomIn(amount) (opens new window): 沿着视角矢量移动摄像机。
- map.camera.zoomOut(amount) (opens new window): 沿视角矢量向后移动摄像机。
- map.camera.flyTo(options) (opens new window): 创建从当前相机位置到新位置的动画相机飞行。
- map.camera.lookAt(target, offset) (opens new window) : 定位并定位摄像机以给定偏移量瞄准目标点。
- map.camera.move(direction, amount) (opens new window) : 朝任何方向移动摄像机。
- map.camera.rotate(axis, angle) (opens new window) : 绕任意轴旋转相机。
使用setView函数设置Camera的位置和方向。destination可以是Cartesian3或Rectangle，orientation可以是heading/pitch/roll或direction/up。 heading航向角、pitch俯仰角和roll横滚角以弧度定义。
- heading航向角：是从正角度向东增加的局部北向旋转。
- pitch俯仰角：是指从局部的东北平面开始的旋转。正俯仰角在平面上方。负俯仰角在平面以下。
- roll横滚角：是围绕局部东轴应用的第一个旋转。
map.camera.setView({
destination : new Cesium.Cartesian3(x, y, z),
orientation: {
heading : headingAngle,
pitch : pitchAngle,
roll : rollAngle
}
});
2
3
4
5
6
7
8
map.camera.setView({
destination : Cesium.Rectangle.fromDegrees(west, south, east, north),
orientation: {
heading : headingAngle,
pitch : pitchAngle,
roll : rollAngle
}
});
2
3
4
5
6
7
8
上述的所有参数都是可选的。如果未指定，参数值将被设为默认值用户当前Camera的位置和方向。
# 2.1 平移位置
move* 和 zoom*方法，沿着相机方向或者某个给定向量来平移相机的位置,相机朝向不变。
# 2.2 旋转朝向
look* 和 twist* 方法，旋转相机朝向，向前向量(direction)，向上向量(up)，向右向量(right)都会改变,相机位置保持不变。
# 2.3 平移位置+旋转朝向
rotate* 方法，相对一个给定的向量，旋转相机的位置和朝向。
# 2. screenSpaceCameraController 鼠标相机控制器对象
map.scene.screenSpaceCameraController 是ScreenSpaceCameraController (opens new window)类 。 把屏幕画布上的用户输入（鼠标拖拽点击或者触摸事件）来修改相机的位置和方向。 它包含一些属性，可以启用/禁用某种用户输入，修改惯性、最小最大缩放距离等。
默认地，场景支持鼠标（电脑端）和手指触摸（移动端）交互，并且支持以下相机漫游方式：
| 鼠标操作 | 3D视图 | 2D视图 | 2.5D视图 |
|---|---|---|---|
| 左键 + 拖拽 | 旋转 | 平移 | 平移 |
| 右键 + 拖拽 | 缩放 | 缩放 | 缩放 |
| 中键滚轮 | 缩放 | 缩放 | 缩放 |
| 中键 + 拖拽 | 倾斜 | 无操作 | 倾斜地球 |