ScreenSpaceTiltOrbitCameraController
Cesium v1.147 · 中文

一个相机控制器,允许通过点击和拖动鼠标或在触摸屏上触摸并拖动来在屏幕空间中将相机围绕目标位置进行倾斜和旋转。

new Cesium.ScreenSpaceTiltOrbitCameraController(options)

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

const tiltOrbitController = new Cesium.ScreenSpaceTiltOrbitCameraController();
viewer.addController(tiltOrbitController);
// 在光标下的位置进行倾斜,或在拖动开始时点击该位置,而不是屏幕中心的固定位置。
viewer.scene.screenSpaceCameraController.enableInputs = false;
viewer.scene.screenSpaceCameraController.enableCollisionDetection = false;

const tiltOrbitController = new Cesium.ScreenSpaceTiltOrbitCameraController();
tiltOrbitController.useDragPosition = true;
viewer.addController(tiltOrbitController);
// 配置控制器使用左鼠标按钮进行倾斜和旋转,而不是默认的右鼠标按钮。
const tiltOrbitController = new Cesium.ScreenSpaceTiltOrbitCameraController({
dragInputs: [{ button: Cesium.MouseButton.LEFT }]
});
viewer.addController(tiltOrbitController);

Members

启用或禁用倾斜和轨道动画的阻尼效果。阻尼可以平滑相机运动,使其看起来更自然或更有重量感,但也会带来轻微的响应延迟。如果禁用阻尼,相机会立即响应用户输入。
Default Value: true
控制倾斜的拖拽输入绑定。每个绑定都是鼠标按钮 和可选键盘修饰键的组合。
See:
决定控制器是否启用以及是否由宿主场景进行更新。
一个位于 [0, 1) 范围内的参数,用于限制输入范围 为每一帧动画中窗口宽度/高度的百分比。 这有助于在低帧率情况下控制相机。
Default Value: 0.1
每秒弧度的最大轨道速度。Number.POSITIVE_INFINITY 表示最大轨道速度无限制。
Default Value: CesiumMath.TWO_PI
每秒弧度的最大倾斜速度。Number.POSITIVE_INFINITY 表示最大倾斜速度无限制。
Default Value: CesiumMath.PI
指定单个轨道动画完成所需的秒数。
Default Value: 0.0045
启用拖拽以旋转相机。
Default Value: true
每次拖动像素时相机轨道运动的幅度。1.0 表示在整个画布上拖动鼠标会使相机轨道运动 180 度。
Default Value: 2.0
用于选择用于倾斜或旋转的世界位置的回调函数。该函数接受 Scene、Cartesian2 屏幕空间位置和 Cartesian3 实例作为参数来返回结果。该函数应返回用于倾斜或旋转的 Cartesian3 世界位置,如果无法选择位置则返回 undefined。
Default Value: defaultPickWorldPosition
Example:
const tiltOrbitCameraController = new Cesium.ScreenSpaceTiltOrbitCameraController();
tiltOrbitCameraController.pickWorldPosition = function (scene, windowPosition, result) {
// 从深度缓冲区选择世界位置
return scene.pickPosition(windowPosition, result);
};
viewer.addController(tiltOrbitCameraController);
指定单个倾斜动画完成所需的秒数。
Default Value: 0.0045
启用拖拽以倾斜相机。
Default Value: true
每次拖动像素时相机倾斜的幅度。1.0 表示在整个画布上拖动鼠标会使相机倾斜 90 度。
Default Value: 2.0
如果为 false,相机将围绕屏幕中心的固定位置进行旋转和倾斜。如果为 true,相机将围绕光标下的位置或拖动开始时点击的位置进行旋转和倾斜。
Default Value: false

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:

orbit(camera, target, axis, amount, dt, ellipsoid)

尝试以指定的弧度值在指定原点周围绕相机旋转。正值表示顺时针旋转,负值表示逆时针旋转。如果拖拽原点不在椭球上,则不会应用任何旋转。
Name Type Default Description
camera Camera 要旋转的相机。
target Cartesian3 在世界坐标中旋转的原点位置。
axis Cartesian3 旋转的轴,通常是目标位置处表面法线的负方向。
amount number 相机旋转的弧度值。正值表示顺时针旋转,负值表示逆时针旋转。
dt number 自上次更新以来的时间差,单位:秒。
ellipsoid Ellipsoid Ellipsoid.default optional 选择作为旋转原点的椭球。如果未定义,则使用默认椭球。

tilt(camera, target, axis, amount, dt, ellipsoid)

尝试以指定的弧度值倾斜相机。正值表示向下倾斜,负值表示向上倾斜。如果拖拽原点不在椭球上,则不会应用任何倾斜。
Name Type Default Description
camera Camera 要倾斜的相机。
target Cartesian3 在世界坐标中倾斜的原点位置。
axis Cartesian3 倾斜的轴,通常是目标位置处表面法线的负方向。
amount number 相机倾斜的弧度值。正值表示向下倾斜,负值表示向上倾斜。
dt number 自上次更新以来的时间差,单位:秒。值必须大于0。
ellipsoid Ellipsoid Ellipsoid.default optional 选择作为倾斜原点的椭球。如果未定义,则使用默认椭球。
每帧调用一次。需实现 update 来修改相机或场景的其他部分。
Name Type Description
scene Scene
time JulianDate 当前模拟时间。
See:

Type Definitions

Cesium.ScreenSpaceTiltOrbitCameraController.ControllerOptions

Properties:
Name Type Attributes Description
dragInputs Array.<ScreenSpaceInputBindings.InputBinding> <optional>
控制倾斜和旋转的拖拽输入绑定。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.