Camera - SuperMap3D Documentation

new SuperMap3D.Camera(scene)

相机类，它由位置、方向和视锥体定义。视锥体(viewing frustum)由6个(上、下、左、右、近、远)平面限定，每个平面可由Cartesian4对象表示，其中x，y和z分量定义垂直于平面的单位向量，w分量是平面距原点/相机位置的距离。

Name	Type	Description
`scene`	Scene	场景对象。

Example:

//创建相机对象。
var camera = new SuperMap3D.Camera(scene);
camera.position = new SuperMap3D.Cartesian3();
camera.direction = SuperMap3D.Cartesian3.negate(SuperMap3D.Cartesian3.UNIT_Z, new SuperMap3D.Cartesian3());
camera.up = SuperMap3D.Cartesian3.clone(SuperMap3D.Cartesian3.UNIT_Y);
camera.frustum.fov = SuperMap3D.Math.PI_OVER_THREE;
camera.frustum.near = 1.0;
camera.frustum.far = 2.0;

Members

staticSuperMap3D.Camera.DEFAULT_OFFSET : HeadingPitchRange

当相机飞到包含包围球的位置时使用的默认方位/间距/范围。

staticSuperMap3D.Camera.DEFAULT_VIEW_FACTOR : Number

一个标量，用于乘以相机的位置，并在设置相机查看矩形后将其加回来。数值为0表示相机将查看整个Camera#DEFAULT_VIEW_RECTANGLE 矩形，数值大于0表示相机将远离矩形范围，数值小于0表示相机将靠近矩形范围。

staticSuperMap3D.Camera.DEFAULT_VIEW_RECTANGLE : Rectangle

相机在创建时将查看的默认矩形。

readonlychanged : Event

获取当相机被percentagechange更改时将引发的事件。

constrainedAxis : Cartesian3

如果设置，相机将无法在任一方向上绕过此轴进行旋转。

Default Value: undefined

defaultLookAmount : Number

当查看方法为提供参数时，默认旋转相机角度。

Default Value: Math.PI / 60.0

defaultMoveAmount : Number

当移动方法未提供参数时，移动相机的默认值。

Default Value: 100000.0;

defaultRotateAmount : Number

当没有为rotate方法提供参数时，默认移动相机距离。

Default Value: Math.PI / 3600.0

defaultZoomAmount : Number

在缩放方法微提供参数时，旋转相机的默认值。

Default Value: 100000.0;

direction : Cartesian3

相机视图方向。

readonlydirectionWC : Cartesian3

获取相机在地理坐标中的视角方向。

flyCircleLoop : Boolean

设置相机绕点旋转是否开启循环模式。

Example:

var scene = viewer.scene;
var camera = scene.camera;
//设置相机循环模式
camera.flyCircleLoop = true;

flyClampToGround : Boolean

设置是否贴地飞行，默认为flase,设置为true时始终在地形在地形之上飞行，不会钻进地形内部。

frustum : Frustum

视野中的空间区域，即视锥体。

Default Value: PerspectiveFrustum()

See:

readonlyheading : Number

获取相机方位角，单位为弧度。

readonlyinverseTransform : Matrix4

获取相机的反变换。

Default Value: Matrix4.IDENTITY

readonlyinverseViewMatrix : Matrix4

获取反视图矩阵。

See:

Camera#viewMatrix

maximumZoomFactor : Number

乘以地图尺寸的系数，用于确定从表面放大时相机位置的夹持位置。仅对二维地图有效，且地图可旋转。

Default Value: 1.5

readonlymoveEnd : Event

获取当相机停止移动时将引发的事件。

readonlymoveStart : Event

获取将在相机开始移动时引发的事件。

percentageChanged : number

在引发changed事件之前，相机必须改变的数量。取值为[0,1]范围内的百分比。

Default Value: 0.5

readonlypitch : Number

获取相机的俯仰角，单位为弧度。

position : Cartesian3

相机对象的位置。

readonlypositionCartographic : Cartographic

获取相机的 Cartographic 位置，经度和纬度以弧度为单位，高度以米为单位。在二维和哥伦布视图中，当相机位于地图之外时，返回的经度和纬度有可能超出有效的经度和纬度范围。

readonlypositionWC : Cartesian3

获取相机在地理坐标中的位置。

right : Cartesian3

相机的正确方向。

readonlyrightWC : Cartesian3

以地理坐标获取相机的正确方向。

readonlyroll : Number

获取相机旋转角度，单位为弧度。

sensitivePositionRatio : Number

获取或设置地形敏感点比例，范围为0-1之间。

speedRatio : Number

设置绕点旋转速率。

readonlytransform : Matrix4

获取相机的参考帧。此变换的逆值会附加到视图矩阵中。

Default Value: Matrix4.IDENTITY

up : Cartesian3

相机的上方向。

readonlyupWC : Cartesian3

以地理坐标获取相机的向上方向。

readonlyviewMatrix : Matrix4

获取视图矩阵。

See:

Camera#inverseViewMatrix

Methods

cameraToWorldCoordinates(cartesian, result) → Cartesian4

将矢量或点从相机的参照系转换为地理坐标。

Name	Type	Description
`cartesian`	Cartesian4	要变换的矢量或点。
`result`	Cartesian4	optional 存储结果的对象。

Returns:

变换后的矢量或点。

cameraToWorldCoordinatesPoint(cartesian, result) → Cartesian3

将一个点从相机的参照系转换为地理坐标。

Name	Type	Description
`cartesian`	Cartesian3	转变的要点。
`result`	Cartesian3	optional 存储结果的对象。

Returns:

转换点。

cameraToWorldCoordinatesVector(cartesian, result) → Cartesian3

将矢量从相机的参照系转换为地理坐标。

Name	Type	Description
`cartesian`	Cartesian3	要转换的矢量。
`result`	Cartesian3	optional 存储结果的对象。

Returns:

转换后的向量。

cancelFlight()

取消当前正在进行的相机飞行。相机将留在当前位置。

computeViewRectangle(ellipsoid, result) → Rectangle|undefined

计算椭球体上可见矩形的近似值。

Name	Type	Default	Description
`ellipsoid`	Ellipsoid	`Ellipsoid.WGS84`	optional 可见区域的椭球体。
`result`	Rectangle		optional 存储结果的矩形。

Returns:

可见矩形，如果椭圆体根本不可见，则未定义。

disableReflection()

禁用先前使用enableReflection打开的反射修改。

distanceToBoundingSphere(boundingSphere) → Number

返回相机到包围球前方的距离。

Name	Type	Description
`boundingSphere`	BoundingSphere	地理坐标中的包围球。

Returns:

到包围球的距离。

enableReflection(plane)

修改这个截锥体，使它总是通过指定平面的自身反射来渲染。

Name	Type	Description
`plane`	Plane	optional 平面反射。

flyCircle(center)

相机绕中心点旋转。

Name	Type	Description
`center`	Number	在场景中所绘制点的三维空间坐标值。

Example:

var scene = viewer.scene;
var camera = scene.camera;
var handlerPoint = new SuperMap3D.DrawHandler(viewer,SuperMap3D.DrawMode.Point);
    handlerPoint.drawEvt.addEventListener(function(result){
    center = result.object.position;
//相机绕中心点旋转。
    camera.flyCircle(center);
    });

flyHome(duration)

把相机调到主视图。使用{@链接相机#。DEFAULT_VIEW_RECTANGLE}设置三维场景的默认视图。主视图为二维和哥伦布视图显示整个地图。

Name	Type	Description
`duration`	Number	optional 飞行时间以秒为单位。如果省略，SuperMap3D将尝试根据飞行的距离计算理想的持续时间。参见`Camera#flyTo`

flyTo(options)

相机从当前位置飞行到新的空间位置。

Name Type Description

options

Object

对象具有以下属性:

Name	Type	Description
`destination`	Cartesian3 \| Rectangle	相机在WGS84地理坐标系中的最终位置，或是自顶向下视图中可见的矩形区域。
`orientation`	Object	optional 包含了方位(direction)、上方向(up)以及方位角(heading)、俯仰角(pitch)、滚动角(roll)属性的对象。默认情况下，3D中方位(direction)指向框架中心，在Columbus视图中指向负z方向。在3D中上方向(up)指向本地北方向，而在Columbus视图中指向正y方向。在无限滚动模式下，二维视图不使用方向(orientation)。
`duration`	Number	optional 飞行持续时间（以秒为单位）。如果省略，由飞行距离计算合理的持续时间。
`complete`	Camera~FlightCompleteCallback	optional 飞行完成时执行的功能。
`cancel`	Camera~FlightCancelledCallback	optional 飞行取消时执行的功能。
`endTransform`	Matrix4	optional 飞行完成时相机将处于的参考系的变换矩阵。
`maximumHeight`	Number	optional 飞行中的最大高度。
`easingFunction`	EasingFunction \| EasingFunction~Callback	optional 释放时调用功能。
`pitchAdjustHeight`	Number	optional 如果相机飞行高度高于该值，则调整俯仰角，使其向下俯视，并将地球保持在视口中。
`flyOverLongitude`	Number	optional 地球上两点之间总有两条路。该选项会强制相机选择一个方向飞越该经度。
`flyOverLongitudeWeight`	Number	optional 只有当飞越的经度不超过飞越经度权重的短途时间时，才会飞越通过飞越经度指定的经度。

Throws:

DeveloperError : 若提供了方向(direction )、上方向(up)两者之一，则两者都需要提供。

Example:

// 1. 飞向通过top-down视图表示的位置
viewer.camera.flyTo({
    destination : SuperMap3D.Cartesian3.fromDegrees(-117.16, 32.71, 15000.0)
});

// 2. 飞向通过top-down视图表示的矩形
viewer.camera.flyTo({
    destination : SuperMap3D.Rectangle.fromDegrees(west, south, east, north)
});

// 3. 飞向利用单位向量表示方向(orientatin)的位置
viewer.camera.flyTo({
    destination : SuperMap3D.Cartesian3.fromDegrees(-122.19, 46.25, 5000.0),
    orientation : {
        direction : new SuperMap3D.Cartesian3(-0.04231243104240401, -0.20123236049443421, -0.97862924300734),
        up : new SuperMap3D.Cartesian3(-0.47934589305293746, -0.8553216253114552, 0.1966022179118339)
    }
});

// 4. 飞向利用方位角(heading)、俯仰角(pitch)、滚动角(roll)表示方向(orientatin)的位置
viewer.camera.flyTo({
    destination : SuperMap3D.Cartesian3.fromDegrees(-122.19, 46.25, 5000.0),
    orientation : {
        heading : SuperMap3D.Math.toRadians(175.0),
        pitch : SuperMap3D.Math.toRadians(-35.0),
        roll : 0.0
    }
});

flyToBoundingSphere(options, boundingSphere)

将相机移动到当前视图包含所提供的包围球的位置。

偏移量是在以包围球中心为中心的本地东-北-上参考系中的方位/俯仰/范围。方位和俯仰角在当地的东-北-上参考系中定义。方位是从y轴到x轴的角度。螺距是x平面的旋转。正俯仰角在平面以下。负俯仰角在平面上方。距离是到中心的距离。如果范围为0，则计算一个范围，使整个包围球可见。

在二维和Columbus视图中，必须有一个自顶向下的视图。相机将放置在目标上方向下看。目标上方的高度就是距离。标题将对准当地的北方。

Name	Type	Description
`options`	Object	optional 具有以下对象的属性:
`boundingSphere`	BoundingSphere	要查看的包围球，以地理坐标表示。
`options.duration`	Number	optional 飞行持续时间（以秒为单位）。如果省略，SuperMap3D 会根据飞行距离计算出理想的持续时间。
`options.offset`	HeadingPitchRange	optional 在以目标为中心的本地东-北-上参照系中与目标的偏移量。
`options.complete`	Camera~FlightCompleteCallback	optional 飞行完成后执行的函数。
`options.cancel`	Camera~FlightCancelledCallback	optional 飞行取消时要执行的函数。
`options.endTransform`	Matrix4	optional 变换矩阵，表示飞行结束时相机所处的参考帧。
`options.maximumHeight`	Number	optional 飞行峰值时的最大高度。
`options.pitchAdjustHeight`	Number	optional 如果相机飞行高度高于该值，则调整俯仰角，使其向下俯视，并将地球保持在视口中。
`options.flyOverLongitude`	Number	optional 地球上两点之间总有两条路。该选项会强制相机选择一个方向飞越该经度。
`options.flyOverLongitudeWeight`	Number	optional 只有当飞越的经度不超过飞越经度权重的短途时间时，才会飞越通过飞越经度指定的经度。
`options.easingFunction`	EasingFunction \| EasingFunction~Callback	optional 控制在飞行过程中如何插值时间。

getMagnitude() → Number

获取相机位置的大小。在三维中，这是矢量的大小。二维和哥伦布视图中，这是到地图的距离。

Returns:

位置的大小。

getPickRay(windowPosition, result) → Ray

以地理坐标为单位，创建一条从相机位置穿过窗口位置像素的射线。

Name	Type	Description
`windowPosition`	Cartesian2	像素的 x 和 y 坐标。
`result`	Ray	optional 存储结果的对象。

Returns:

返回射线的 Cartesian3 位置和方向。

getPixelSize(boundingSphere, drawingBufferWidth, drawingBufferHeight) → Number

以米为单位返回像素大小。

Name	Type	Description
`boundingSphere`	BoundingSphere	地理坐标中的包围球。
`drawingBufferWidth`	Number	绘图buffer宽度。
`drawingBufferHeight`	Number	绘图buffer高度。

Returns:

以米为单位的像素大小。

getRectangleCameraCoordinates(rectangle, result) → Cartesian3

获取在椭球体或地图上查看矩形所需的相机位置

Name	Type	Description
`rectangle`	Rectangle	要查看的矩形。
`result`	Cartesian3	optional 查看矩形所需的相机位置。

Returns:

查看矩形所需的相机位置。

look(axis, angle)

围绕轴旋转每个相机的方向向量角度

Name	Type	Description
`axis`	Cartesian3	要旋转的轴。
`angle`	Number	optional 旋转的角度，以弧度为单位。默认值为`defaultLookAmount`。

See:

lookAt(target, offset)

通过目标(target)和偏移(offset)设置相机位置、方向。目标(target)以地理坐标方式表示；偏移(offset)是在以目标为中心的本地“东-北-上”参考系中的Cartesian坐标或“方位角/俯仰角/范围（heading/pitch/range）”。如果偏移(offset)由Cartesian坐标表示，它表示距离由变换矩阵定义的参考系中心的偏移量。如果偏移(offset)由“heading/pitch/range”表示，方位角(heading)和俯仰角(pitch)的角度由根据变换矩阵定义的参考系确定，方位角(heading)从y轴开始朝向x轴增加，俯仰角(pitch)为从xy平面的旋转角度，正的俯仰角位于平面下方，负的俯仰角位于平面上方。范围(range)为距中心点的距离。在2D中必须为自上而下视图，相机位于俯视目标的上方，目标上方的高度值是偏移量的大小。方位角根据偏移确定，如果不能从偏移确定方位角，则方位角为北方向。

Name	Type	Description
`target`	Cartesian3	目标在地理坐标中的空间位置。
`offset`	Cartesian3 \| HeadingPitchRange	距以目标为中心的本地“东-北-上”参考系的偏移。

Throws:

DeveloperError : 变形时不支持lookAt方法。

Example:

// 1. 利用Cartesian坐标设置偏移
var center = SuperMap3D.Cartesian3.fromDegrees(-98.0, 40.0);
viewer.camera.lookAt(center, new SuperMap3D.Cartesian3(0.0, -4790000.0, 3930000.0));

// 2. 利用HeadingPitchRange设置偏移
var center = SuperMap3D.Cartesian3.fromDegrees(-72.0, 40.0);
var heading = SuperMap3D.Math.toRadians(50.0);
var pitch = SuperMap3D.Math.toRadians(-20.0);
var range = 5000.0;
viewer.camera.lookAt(center, new SuperMap3D.HeadingPitchRange(heading, pitch, range));

lookAtTransform(transform, offset)

使用目标和变换矩阵设置相机的位置和方向。偏移量可以是Cartesian偏移量，也可以是方位/间距/范围偏移量。如果偏移量是Cartesian偏移量，则是从变换矩阵定义的参考帧中心偏移。如果偏移量是方位/俯仰/翻滚，那么方位角和俯仰角是在变换矩阵定义的参照系中定义的。方位是指从 Y 轴开始向 X 轴增加的角度。俯仰角是从 xy 平面开始的旋转。正俯仰角在平面以下。负俯仰角在平面之上。范围是与中心的距离。在二维中，必须有一个自上而下的视图。相机将被放置在参考系的中心上方。目标上方的高度将是偏移量的大小。标题将根据偏移量确定。如果不能从偏移量确定方位，则方位将为北。

Name	Type	Description
`transform`	Matrix4	定义参照系的变换矩阵。
`offset`	Cartesian3 \| HeadingPitchRange	optional 在以目标为中心的参考系中与目标的偏移量。

Throws:

DeveloperError : 变形时不支持lookAtTransform。

Example:

// 1. Using a cartesian offset
var transform = SuperMap3D.Transforms.eastNorthUpToFixedFrame(SuperMap3D.Cartesian3.fromDegrees(-98.0, 40.0));
viewer.camera.lookAtTransform(transform, new SuperMap3D.Cartesian3(0.0, -4790000.0, 3930000.0));

// 2. Using a HeadingPitchRange offset
var transform = SuperMap3D.Transforms.eastNorthUpToFixedFrame(SuperMap3D.Cartesian3.fromDegrees(-72.0, 40.0));
var heading = SuperMap3D.Math.toRadians(50.0);
var pitch = SuperMap3D.Math.toRadians(-20.0);
var range = 5000.0;
viewer.camera.lookAtTransform(transform, new SuperMap3D.HeadingPitchRange(heading, pitch, range));

lookDown(amount)

以弧度为单位，在与其上矢量相反的方向上，围绕其右矢量旋转相机。

Name	Type	Description
`amount`	Number	optional 以弧度为单位的旋转量。默认值为`defaultLookAmount`。

See:

Camera#lookUp

lookLeft(amount)

以弧度为单位，沿着与右向量相反的方向，围绕其上向量旋转相机。

Name	Type	Description
`amount`	Number	optional 以弧度为单位的旋转量。默认值为`defaultLookAmount`。

See:

Camera#lookRight

lookRight(amount)

以弧度为单位，沿着右向量的方向，围绕其上向量旋转相机。

Name	Type	Description
`amount`	Number	optional 以弧度为单位的旋转量。默认值为`defaultLookAmount`。

See:

Camera#lookLeft

lookUp(amount)

以弧度为单位，沿着向上向量的方向，围绕其右向量旋转相机。

Name	Type	Description
`amount`	Number	optional 以弧度为单位的旋转量。默认值为`defaultLookAmount`。

See:

Camera#lookDown

move(direction, amount)

按一定量沿方向平移相机的位置。

Name	Type	Description
`direction`	Cartesian3	前进的方向。
`amount`	Number	optional 移动的量，以米为单位。默认为defaultMoveAmount

See:

moveBackward(amount)

通过amount沿着与相机视图向量相反的方向平移相机的位置。

Name	Type	Description
`amount`	Number	optional 移动的量，以米为单位。默认为`defaultMoveAmount`。

See:

Camera#moveForward

moveDown(amount)

通过amount沿着与相机向上矢量相反的方向平移相机的位置。

Name	Type	Description
`amount`	Number	optional 移动的量，以米为单位。默认为`defaultMoveAmount`。

See:

Camera#moveUp

moveForward(amount)

通过amount沿着相机的视图向量转换相机的位置。

Name	Type	Description
`amount`	Number	optional 移动的量，以米为单位。默认为`defaultMoveAmount`。

See:

Camera#moveBackward

moveLeft(amount)

通过amount沿着与相机右矢量相反的方向平移相机的位置。

Name	Type	Description
`amount`	Number	optional 移动的量，以米为单位。默认为`defaultMoveAmount`。

See:

Camera#moveRight

moveRight(amount)

通过amount沿着相机的右向量平移相机的位置。

Name	Type	Description
`amount`	Number	optional 移动的量，以米为单位。默认为`defaultMoveAmount`。

See:

Camera#moveLeft

moveUp(amount)

通过amount沿着相机的向上矢量平移相机的位置。

Name	Type	Description
`amount`	Number	optional 移动的量，以米为单位。默认为`defaultMoveAmount`。

See:

Camera#moveDown

pickEllipsoid(windowPosition, ellipsoid, result) → Cartesian3

选择一个椭球或地图。

Name	Type	Default	Description
`windowPosition`	Cartesian2		像素的x和y坐标。
`ellipsoid`	Ellipsoid	`Ellipsoid.WGS84`	optional 要选择的椭球体。
`result`	Cartesian3		optional 存储结果的对象。

Returns:

如果选中了椭球面或地图，则返回椭球面或地图表面上的点的地理坐标。如果未选中椭球体或地图，则返回未定义。

rotate(axis, angle)

以角度围绕轴旋转相机。相机位置到相机参照系中心的距离保持不变。

Name	Type	Description
`axis`	Cartesian3	在给定的地理坐标中旋转的轴。
`angle`	Number	optional 旋转的角度，以弧度为单位。默认值为`defaultRotateAmount`。

See:

rotateDown(angle)

将相机围绕相机的参考系中心向下旋转一个角度。

Name	Type	Description
`angle`	Number	optional 旋转的角度，以弧度为单位。默认值为`defaultRotateAmount`。

See:

rotateLeft(angle)

将相机围绕相机参考帧的中心向左旋转一个角度。

Name	Type	Description
`angle`	Number	optional 旋转的角度，以弧度为单位。默认值为`defaultRotateAmount`。

See:

rotateRight(angle)

将相机围绕相机参考系的中心向右旋转一个角度。

Name	Type	Description
`angle`	Number	optional 旋转的角度，以弧度为单位。默认值为`defaultRotateAmount`。

See:

rotateUp(angle)

将相机围绕相机的参考系中心向上旋转一个角度。

Name	Type	Description
`angle`	Number	optional 旋转的角度，以弧度为单位。默认值为`defaultRotateAmount`。

See:

setView(options)

设置相机位置、方向和变换。

Name Type Description

options

Object

对象具有以下属性:

Name	Type	Description
`destination`	Cartesian3 \| Rectangle	optional 相机在WGS84地理坐标系中的最终位置，或是自顶向下视图中可见的矩形区域。
`orientation`	Object	optional 包含了方位(direction)、上方向(up)以及方位角(heading)、俯仰角(pitch)、滚动角(roll)属性的对象。默认情况下，3D中方位(direction)指向框架中心，在Columbus视图中指向负z方向。在3D中上方向(up)指向本地北方向，而在Columbus视图中指向正y方向。在无限滚动模式下，二维视图不使用方向(orientation)。
`endTransform`	Matrix4	optional 表示相机参考坐标系的变换矩阵。
`convert`	Boolean	optional 是否将相机最终位置从地理坐标转换为场景坐标，默认值True。

Example:

// 1. 通过top-down视图设置位置。
viewer.camera.setView({
    destination : SuperMap3D.Cartesian3.fromDegrees(-117.16, 32.71, 15000.0)
});

// 2 通过方位角、俯仰角、滚动角设置视图。
viewer.camera.setView({
    destination : cartesianPosition,
    orientation: {
        heading : SuperMap3D.Math.toRadians(90.0), // east, default value is 0.0 (north)
        pitch : SuperMap3D.Math.toRadians(-90),    // default value (looking down)
        roll : 0.0                             // default value
    }
});

// 3. 相机空间位置不变，改变方位角、俯仰角和滚动角。.
viewer.camera.setView({
    orientation: {
        heading : SuperMap3D.Math.toRadians(90.0), // east, default value is 0.0 (north)
        pitch : SuperMap3D.Math.toRadians(-90),    // default value (looking down)
        roll : 0.0                             // default value
    }
});


// 4. 通过自顶向下视图查看矩形。
viewer.camera.setView({
    destination : SuperMap3D.Rectangle.fromDegrees(west, south, east, north)
});

// 5. 通过使用单位向量的方向(orientation)设置相机位置。
viewer.camera.setView({
    destination : SuperMap3D.Cartesian3.fromDegrees(-122.19, 46.25, 5000.0),
    orientation : {
        direction : new SuperMap3D.Cartesian3(-0.04231243104240401, -0.20123236049443421, -0.97862924300734),
        up : new SuperMap3D.Cartesian3(-0.47934589305293746, -0.8553216253114552, 0.1966022179118339)
    }
});

stopFlyCircle()

停止相机绕中心点旋转。

switchToOrthographicFrustum()

将缩放/投影切换为正投影。该函数在二维中是无效的，因为二维总是正交的。

switchToPerspectiveFrustum()

将缩放/投影切换为透视。在必须始终保持正交的二维空间中，该函数不起作用。

twistLeft(amount)

以弧度为单位，逆时针旋转相机的方向矢量。

Name	Type	Description
`amount`	Number	optional 以弧度为单位的旋转量。默认值为`defaultLookAmount`。

See:

Camera#twistRight

twistRight(amount)

以弧度为单位，顺时针旋转相机的方向矢量。

Name	Type	Description
`amount`	Number	optional 以弧度为单位的旋转量。默认值为`defaultLookAmount`。

See:

Camera#twistLeft

viewBoundingSphere(boundingSphere, offset)

设置相机，使当前视图包含所提供的包围球。

偏移量是位于包围球中心的局部东西北参考系中的方位/俯仰/范围。方位角和俯仰角定义在局部东西北参考系中。方位角是从y轴到x轴的角度，俯仰角是围绕xy平面的旋转。正值的俯仰角位于平面下方。负值的俯仰角位于平面上方。范围是从中心点的距离。如果范围是0，将计算一个范围，以使整个包围球可见。

在二维模式中，必须采用俯视视角。相机将置于目标上方，向下俯视。目标上方的高度将是范围。根据偏移量确定方位。如果无法根据偏移量确定方位，则方位为北。

Name	Type	Description
`boundingSphere`	BoundingSphere	要查看的包围球，以地理坐标为单位。
`offset`	HeadingPitchRange	optional 在以目标为中心的本地东-北-上参照系中与目标的偏移量。

Throws:

DeveloperError : 变形时不支持视图包围球。

worldToCameraCoordinates(cartesian, result) → Cartesian4

将矢量或点从地理坐标转换为相机的参考系。

Name	Type	Description
`cartesian`	Cartesian4	T要变换的向量或点。
`result`	Cartesian4	optional 存储结果的对象。

Returns:

变换后的矢量或点。

worldToCameraCoordinatesPoint(cartesian, result) → Cartesian3

将一个点从地理坐标转换到相机的参照系。

Name	Type	Description
`cartesian`	Cartesian3	转变的要点。
`result`	Cartesian3	optional 存储结果的对象。

Returns:

转换点。

worldToCameraCoordinatesVector(cartesian, result) → Cartesian3

将一个向量从地理坐标转换到相机的参照系。

Name	Type	Description
`cartesian`	Cartesian3	要转换的矢量。
`result`	Cartesian3	optional 存储结果的对象。

Returns:

转换后的向量。

zoomIn(amount)

沿着相机的视图矢量缩放amount。

Name	Type	Description
`amount`	Number	optional 移动的数量。默认为`defaultZoomAmount`。

See:

Camera#zoomOut

zoomOut(amount)

缩放amount沿着与相机视图矢量相反的方向。

Name	Type	Description
`amount`	Number	optional 移动的数量。默认为`defaultZoomAmount`。

See:

Camera#zoomIn

Type Definitions

FlightCancelledCallback()

当飞行取消时将执行的函数。

FlightCompleteCallback()

飞行完成时执行的函数。