创建
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
dragInputs : Array.<ScreenSpaceInputBindings.InputBinding>
控制倾斜的拖拽输入绑定。每个绑定都是鼠标按钮
和可选键盘修饰键的组合。
决定控制器是否启用以及是否由宿主场景进行更新。
一个位于 [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 元素。 |
当控制器从 DOM 中移除时调用。需实现
disconnectedCallback 来取消任何 DOM 事件监听器。
| Name | Type | Description |
|---|---|---|
element |
HTMLElement | 包含 Cesium 场景的 DOM 元素。 |
当控制器首次更新时调用,即在调用
update 之前。需实现 firstUpdate 以在相关场景开始渲染循环后执行一次性操作。例如初始化模拟时间值或将primitive添加到场景中。
| Name | Type | Description |
|---|---|---|
scene |
Scene | |
time |
JulianDate | 当前模拟时间。 |
See:
尝试以指定的弧度值在指定原点周围绕相机旋转。正值表示顺时针旋转,负值表示逆时针旋转。如果拖拽原点不在椭球上,则不会应用任何旋转。
| Name | Type | Default | Description |
|---|---|---|---|
camera |
Camera | 要旋转的相机。 | |
target |
Cartesian3 | 在世界坐标中旋转的原点位置。 | |
axis |
Cartesian3 | 旋转的轴,通常是目标位置处表面法线的负方向。 | |
amount |
number | 相机旋转的弧度值。正值表示顺时针旋转,负值表示逆时针旋转。 | |
dt |
number | 自上次更新以来的时间差,单位:秒。 | |
ellipsoid |
Ellipsoid |
Ellipsoid.default
|
optional 选择作为旋转原点的椭球。如果未定义,则使用默认椭球。 |
尝试以指定的弧度值倾斜相机。正值表示向下倾斜,负值表示向上倾斜。如果拖拽原点不在椭球上,则不会应用任何倾斜。
| 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 | 当前模拟时间。 |
Type Definitions
Properties:
| Name | Type | Attributes | Description |
|---|---|---|---|
dragInputs |
Array.<ScreenSpaceInputBindings.InputBinding> |
<optional> |
控制倾斜和旋转的拖拽输入绑定。 |
