创建
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
dragInputs : Array.<ScreenSpaceInputBindings.InputBinding>
控制缩放的拖拽输入绑定。每个绑定都是鼠标按钮与可选键盘修饰符的组合。
控制缩放的滚动输入绑定。
决定控制器是否启用以及是否由宿主场景进行更新。
启用或禁用缩放时的惯性效果。当启用时,在用户输入停止后,相机将继续移动,并根据
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);
scrollInputs : Array.<ScreenSpaceEventType>
控制缩放的滚动输入绑定。
-
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 元素。 |
当控制器从 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 | 当前模拟时间。 |
Type Definitions
Properties:
| Name | Type | Attributes | Description |
|---|---|---|---|
dragInputs |
Array.<ScreenSpaceInputBindings.InputBinding> |
<optional> |
控制缩放的拖拽输入绑定。 |
scrollInputs |
Array.<ScreenSpaceEventType> |
<optional> |
控制缩放的滚动输入绑定。 |
