ScreenSpaceCameraController

new Cesium.ScreenSpaceCameraController(scene)

相机方位类。
Name Type Description
scene Scene 场景。

Members

bounceAnimationTime : Number

设置2D和Columbus视图中弹回动画的持续时间,单位为秒。
Default Value: 3.0

enableCollisionDetection : Boolean

启用或禁用camera与terrain的碰撞检测。
Default Value: true

enableIndoorColliDetection : Boolean

开启或者关闭相机在室内的碰撞检测。
Default Value: false

enableInputs : Boolean

如果为true,则在enableTranslate、enableZoom、enableRotate、enableTilt和enableLook 标志的条件下允许输入。如果为false,则禁用所有输入。 注意:此设置用于临时使用场景,例如相机飞行和 拖拽选择区域(参见Picking演示)。通常在此类事件开始时设为false, 在完成时设为true。要在相机飞行结束后仍保持输入禁用, 必须使用其他布尔值(enableTranslate、enableZoom、enableRotate、enableTilt和enableLook)。
Default Value: true

enableLook : Boolean

如果为true,允许用户使用自由观察。如果为false,camera的观察方向只能通过平移 或旋转来改变。此标志仅适用于3D和Columbus视图模式。
Default Value: true

enableRotate : Boolean

如果为true,允许用户旋转camera。如果为false,camera将锁定到当前的heading。 此标志仅适用于2D和3D模式。
Default Value: true

enableTilt : Boolean

如果为true,允许用户倾斜camera。如果为false,camera将锁定到当前的heading。 此标志仅适用于3D和Columbus视图模式。
Default Value: true

enableTranslate : Boolean

如果为true,允许用户在地图上平移。如果为false,相机将锁定在当前位置。 此标志仅适用于2D和Columbus视图模式。
Default Value: true

enableZoom : Boolean

如果为true,允许用户缩放。如果为false,相机将锁定到距离ellipsoid的当前距离。
Default Value: true

inertiaSpin : Number

范围在[0, 1)内的参数,用于确定camera因惯性 继续旋转的时长。值为零时,camera将没有惯性。
Default Value: 0.9

inertiaTranslate : Number

范围在[0, 1)内的参数,用于确定camera因惯性 继续平移的时长。值为零时,camera将没有惯性。
Default Value: 0.9

inertiaZoom : Number

范围在[0, 1)内的参数,用于确定camera因惯性 继续缩放的时长。值为零时,camera将没有惯性。
Default Value: 0.8

lookEventTypes : CameraEventType|Array|undefined

允许用户改变camera观察方向的输入。仅适用于3D和Columbus视图模式。

类型可以是CameraEventType、undefined、具有eventType 和modifier属性的对象(类型分别为CameraEventType和KeyboardEventModifier), 或上述任意类型的数组。

Default Value: { eventType : CameraEventType.LEFT_DRAG, modifier : KeyboardEventModifier.SHIFT }

maximumMovementRatio : Number

范围在[0, 1)内的参数,用于将各种用户输入的范围 限制为每个动画帧窗口宽度/高度的百分比。 这有助于在低帧率情况下保持camera可控。
Default Value: 0.1

maximumZoomDistance : Number

缩放时camera位置的最大量值,单位为米。默认值为正无穷。
Default Value: Number.POSITIVE_INFINITY

minimumCollisionTerrainHeight : Number

camera检测与terrain碰撞之前必须达到的最低高度。
Default Value: 10000.0

minimumDetectDistance : Number

最小碰撞检测距离

minimumPickingTerrainHeight : Number

camera拾取terrain而非ellipsoid之前必须达到的最低高度。
Default Value: 150000.0

minimumTrackBallHeight : Number

当点击起源于天空或太空时,camera从轨迹球旋转切换到 自由观察之前必须达到的最低高度。
Default Value: 7500000.0

minimumWalkingDetectDistance : Number

最小室内碰撞检测距离

minimumZoomDistance : Number

缩放时camera位置的最小量值,单位为米。默认值为1.0。
Default Value: 1.0

rotateEventTypes : CameraEventType|Array|undefined

允许用户围绕globe或其他对象旋转的输入。仅适用于3D和Columbus视图模式。

类型可以是CameraEventType、undefined、具有eventType 和modifier属性的对象(类型分别为CameraEventType和KeyboardEventModifier), 或上述任意类型的数组。

Default Value: CameraEventType.LEFT_DRAG

tiltEventTypes : CameraEventType|Array|undefined

允许用户在3D和Columbus视图中倾斜或在2D中扭转的输入。

类型可以是CameraEventType、undefined、具有eventType 和modifier属性的对象(类型分别为CameraEventType和KeyboardEventModifier), 或上述任意类型的数组。

Default Value: [CameraEventType.MIDDLE_DRAG, CameraEventType.PINCH, { eventType : CameraEventType.LEFT_DRAG, modifier : KeyboardEventModifier.CTRL }, { eventType : CameraEventType.RIGHT_DRAG, modifier : KeyboardEventModifier.CTRL }]

translateEventTypes : CameraEventType|Array|undefined

允许用户在地图上平移的输入。仅适用于2D和Columbus视图模式。

类型可以是CameraEventType、undefined、具有eventType 和modifier属性的对象(类型分别为CameraEventType和KeyboardEventModifier), 或上述任意类型的数组。

Default Value: CameraEventType.LEFT_DRAG

walkParameters : Object

行走模式的参数,包括速度和高度。
Default Value: {speed:1,height:5}

zoomEventTypes : CameraEventType|Array|undefined

允许用户缩放的输入。

类型可以是CameraEventType、undefined、具有eventType 和modifier属性的对象(类型分别为CameraEventType和KeyboardEventModifier), 或上述任意类型的数组。

Default Value: [CameraEventType.RIGHT_DRAG, CameraEventType.WHEEL, CameraEventType.PINCH]

zoomFactor : Number

获取或设置相机缩放速度,默认值为5.0。

Methods

destroy() → undefined

移除此对象持有的鼠标监听器。

一旦对象被销毁,不应再使用;调用除 isDestroyed之外的任何函数将导致DeveloperError异常。因此, 应将返回值(undefined)赋给该对象,如示例所示。
Returns:
Throws:
  • DeveloperError : 此对象已被销毁,即destroy()已被调用。
Example:
controller = controller && controller.destroy();
See:

isDestroyed() → Boolean

如果此对象已被销毁则返回true;否则返回false。

如果此对象已被销毁,则不应再使用;调用除 isDestroyed之外的任何函数将导致DeveloperError异常。
Returns:
如果此对象已被销毁则返回true;否则返回false。
See: