ScreenSpaceZoomCameraController
Cesium v1.147 · 中文

一个相机控制器,可根据屏幕空间中的指针位置实现相机的放大和缩小。

new Cesium.ScreenSpaceZoomCameraController(options)

创建 ScreenSpaceZoomCameraController 的新实例。
Name Type Description
options ScreenSpaceZoomCameraController.ControllerOptions optional 配置控制器的选项。
Example:
viewer.scene.screenSpaceCameraController.enableInputs = false;
viewer.scene.screenSpaceCameraController.enableCollisionDetection = false;

const zoomCameraController = new Cesium.ScreenSpaceZoomCameraController();
viewer.addController(zoomCameraController);

Members

启用或禁用缩放时的阻尼效果。阻尼会平滑相机移动,使操作显得更自然或更有重量感,但也可能导致相机响应出现轻微延迟。如果禁用阻尼,相机将立即响应用户输入。
Default Value: true
控制缩放的拖拽输入绑定。每个绑定都是鼠标按钮与可选键盘修饰符的组合。 控制缩放的滚动输入绑定。
See:
决定控制器是否启用以及是否由宿主场景进行更新。
启用或禁用缩放时的惯性效果。当启用时,在用户输入停止后,相机将继续移动,并根据 ScreenSpaceZoomCameraController#inertialDecay 逐渐减速。
Default Value: true
相机缩放速度随时间衰减的比率。
Default Value: 6.0
相机可以远离缩放目标的最大距离。
Default Value: 100000.0
以米/秒为单位的最大缩放速度。这限制了相机放大和缩小的速度。
Default Value: 1.0
用于选择缩放起始世界的位置的函数。该函数接受 Scene、屏幕空间位置 Cartesian2 和存储结果的 Cartesian3 实例作为参数。该函数应返回用于缩放的世界位置 Cartesian3,如果无法选择位置则返回 undefined。
Default Value: defaultPickWorldPosition
Example:
const zoomCameraController = new Cesium.ScreenSpaceZoomCameraController();
zoomCameraController.pickWorldPosition = function (scene, windowPosition, result) {
// 从深度缓冲区选择世界位置
return scene.pickPosition(windowPosition, result);
};
viewer.addController(zoomCameraController);
控制缩放的滚动输入绑定。
Default Value: [ScreenSpaceEventType.WHEEL]
See:
如果为 false,相机将把镜头缩放到屏幕中心位置;如果为 true,相机将在鼠标指针下方或拖拽开始时、使用滚动滚轮滚动时定位。
Default Value: false
指定单个缩放动画完成所需的秒数长度。
Default Value: 0.45
定义相机每秒放大和缩小多少的比例,即相机距离缩放目标的距离比率。
Default Value: 0.4
根据鼠标滚轮增量决定相机放大和缩小的速度。
Default Value: 0.2

Methods

当控制器被添加到 DOM 时调用。需实现 connectedCallback 来设置任何 DOM 事件监听器。
Name Type Description
element HTMLElement 包含 Cesium 场景的 DOM 元素。

disconnectedCallback(element)

当控制器从 DOM 中移除时调用。需实现 disconnectedCallback 来取消任何 DOM 事件监听器。
Name Type Description
element HTMLElement 包含 Cesium 场景的 DOM 元素。
当控制器首次更新时调用,即在调用 update 之前。需实现 firstUpdate 以在相关场景开始渲染循环后执行一次性操作。例如初始化模拟时间值或将primitive添加到场景中。
Name Type Description
scene Scene
time JulianDate 当前模拟时间。
See:
每帧调用一次。需实现 update 来修改相机或场景的其他部分。
Name Type Description
scene Scene
time JulianDate 当前模拟时间。
See:

Type Definitions

Cesium.ScreenSpaceZoomCameraController.ControllerOptions

Properties:
Name Type Attributes Description
dragInputs Array.<ScreenSpaceInputBindings.InputBinding> <optional>
控制缩放的拖拽输入绑定。
scrollInputs Array.<ScreenSpaceEventType> <optional>
控制缩放的滚动输入绑定。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.