ScreenSpaceCameraController

new Cesium.ScreenSpaceCameraController(scene)

根据鼠标输入到画布上来修改摄像机位置和方向。
Name Type Description
scene Scene The scene.

Members

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

enableCollisionDetection : boolean

禁用后,将忽略 maximumZoomDistanceminimumZoomDistance 的值。
Default Value: true
如果为 true,则使用标志 enableTranslate、enableZoom、 enableRotate、enableTilt 和 enableLook 的 enableLook。 如果为 false,则禁用所有输入。 注意:此设置适用于临时使用案例,例如相机飞行和 拖动选择区域(请参阅 Picking 演示)。 它通常在 开始此类事件,并在完成时设置 true。 保持输入处于禁用状态 在相机飞行结束后,您必须使用其他布尔值 (enableTranslate, enableZoom、enableRotate、enableTilt 和 enableLook)。
Default Value: true
如果为 true,则允许用户使用 free-look。如果为 false,则只能通过平移来更改相机视图方向 或旋转。此标志仅适用于 3D 和 Columbus 视图模式。
Default Value: true
如果为 true,则允许用户旋转世界,从而平移用户的位置。 此标志仅适用于 2D 和 3D。
Default Value: true
如果为 true,则允许用户倾斜相机。 如果为 false,则相机将锁定到当前航向。 此标志仅适用于 3D 和 Columbus 视图。
Default Value: true
如果为 true,则允许用户在地图上平移。 如果为 false,则摄像机将锁定在当前位置。 此标志仅适用于 2D 和 Columbus 视图模式。
Default Value: true
如果为 true,则允许用户放大和缩小。 如果为 false,则照相机将锁定到与椭球体的当前距离。
Default Value: true
范围 [0, 1) 中的参数,用于确定多长时间 由于惯性,相机将继续旋转。 值为 0 时,相机将没有惯性。
Default Value: 0.9
范围 [0, 1) 中的参数,用于确定多长时间 由于惯性,相机将继续平移。 值为 0 时,相机将没有惯性。
Default Value: 0.9
范围 [0, 1)中的参数,用于确定多长时间 由于惯性,相机将继续变焦。 值为 0 时,相机将没有惯性。
Default Value: 0.8
允许用户更改摄像机查看方向的输入。这仅适用于 3D 和 Columbus 视图模式。

类型可以是 CameraEventTypeundefinedeventType 以及类型为 CameraEventTypeKeyboardEventModifier修饰符属性, 或前面任何一个数组。

Default Value: { eventType : CameraEventType.LEFT_DRAG, modifier : KeyboardEventModifier.SHIFT }
范围 [0, 1) 中的参数,用于限制范围 每个动画帧的窗口宽度/高度的百分比。 这有助于在低帧率情况下控制摄像机。
Default Value: 0.1

maximumTiltAngle : number|undefined

相对于椭球法线的角度,限制了用户可以倾斜相机的最大数量。如果未定义,则摄像机倾斜的角度不受限制。
Default Value: undefined
Example:
//防止相机倾斜到椭球体表面以下
viewer.scene.screenSpaceCameraController.maximumTiltAngle = Math.PI / 2.0;
缩放时摄像机位置的最大幅值(以米为单位)。默认为正无穷大。
Default Value: Number.POSITIVE_INFINITY

minimumCollisionTerrainHeight : number

在测试与地形碰撞之前,摄像机必须达到的最小高度。当使用除 WGS84 以外的其他椭球体时,默认为 scene.ellipsoid.minimumRadius * 0.0025。
Default Value: 15000.0 or scene.ellipsoid.minimumRadius * 0.0025.

minimumPickingTerrainDistanceWithInertia : number

在惯性变焦时,在测试与地形碰撞之前,摄像机必须保持的最小距离。当使用除 WGS84 以外的其他椭球时,默认为 scene.ellipsoid.minimumRadius * 0.00063。
Default Value: 4000.0 or scene.ellipsoid.minimumRadius * 0.00063

minimumPickingTerrainHeight : number

在选择地形或场景内容(而不是椭球体)之前,摄像机必须达到的最小高度。当使用 WGS84 以外的其他椭球时,默认为 scene.ellipsoid.minimumRadius * 0.025。
Default Value: 150000.0 or scene.ellipsoid.minimumRadius * 0.025
在将轨迹球旋转切换到 当点击源自天空或太空时,自由查看。当使用 WGS84 以外的其他椭球体时,默认为 ellipsoid.minimumRadius * 1.175。
Default Value: 7500000.0 or scene.ellipsoid.minimumRadius * 1.175
缩放时摄像机位置的最小幅度(以米为单位)。默认为 1.0。
Default Value: 1.0
允许用户围绕地球或其他对象旋转的输入。这仅适用于 3D 和 Columbus 视图模式。

类型可以是 CameraEventTypeundefinedeventType 以及类型为 CameraEventTypeKeyboardEventModifier修饰符属性, 或前面任何一个数组。

Default Value: CameraEventType.LEFT_DRAG
允许用户在 3D 和哥伦布视图中倾斜或在 2D 中扭曲的输入。

类型可以是 CameraEventTypeundefinedeventType 以及类型为 CameraEventTypeKeyboardEventModifier修饰符属性, 或前面任何一个数组。

Default Value: [CameraEventType.MIDDLE_DRAG, CameraEventType.PINCH, { eventType : CameraEventType.LEFT_DRAG, modifier : KeyboardEventModifier.CTRL }, { eventType : CameraEventType.RIGHT_DRAG, modifier : KeyboardEventModifier.CTRL }]
允许用户在地图上平移的输入。这仅适用于 2D 和 Columbus 视图模式。

类型可以是 CameraEventTypeundefinedeventType 以及类型为 CameraEventTypeKeyboardEventModifier修饰符属性, 或前面任何一个数组。

Default Value: CameraEventType.LEFT_DRAG
允许用户放大/缩小的输入。

类型可以是 CameraEventTypeundefinedeventType 以及类型为 CameraEventTypeKeyboardEventModifier修饰符属性, 或前面任何一个数组。

Default Value: [CameraEventType.RIGHT_DRAG, CameraEventType.WHEEL, CameraEventType.PINCH]
相机缩放速度的乘数。
Default Value: 5.0

Methods

删除此对象持有的鼠标侦听器。

一旦对象被销毁,就不应该使用它;调用 isDestroyed 将导致 DeveloperError 异常。 因此 将返回值 (undefined) 分配给对象,如示例中所示。
Throws:
Example:
controller = controller && controller.destroy();
See:
如果此对象已销毁,则返回 true;否则为 false。

如果此对象已销毁,则不应使用;调用 isDestroyed 将导致 DeveloperError 异常。
Returns:
true,如果此对象被销毁;否则为 false
See:
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.