根据鼠标输入到画布上来修改摄像机位置和方向。
Name | Type | Description |
---|---|---|
scene |
Scene | The scene. |
Members
设置 2D 和 Columbus 视图中反弹动画的持续时间(以秒为单位)。
-
Default Value:
3.0
禁用后,将忽略
maximumZoomDistance
和 minimumZoomDistance
的值。
-
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
lookEventTypes : CameraEventType|Array|undefined
允许用户更改摄像机查看方向的输入。这仅适用于 3D 和 Columbus 视图模式。
类型可以是 CameraEventType
、undefined
、eventType
以及类型为 CameraEventType
和 KeyboardEventModifier
的修饰符
属性,
或前面任何一个数组。
-
Default Value:
{ eventType : CameraEventType.LEFT_DRAG
, modifier : KeyboardEventModifier.SHIFT
}
范围
[0, 1)
中的参数,用于限制范围
每个动画帧的窗口宽度/高度的百分比。
这有助于在低帧率情况下控制摄像机。
-
Default Value:
0.1
相对于椭球法线的角度,限制了用户可以倾斜相机的最大数量。
如果未定义
,则摄像机倾斜的角度不受限制。
-
Default Value:
undefined
Example:
//防止相机倾斜到椭球体表面以下
viewer.scene.screenSpaceCameraController.maximumTiltAngle = Math.PI / 2.0;
缩放时摄像机位置的最大幅值(以米为单位)。默认为正无穷大。
-
Default Value:
Number.POSITIVE_INFINITY
在测试与地形碰撞之前,摄像机必须达到的最小高度。当使用除 WGS84 以外的其他椭球体时,默认为 scene.ellipsoid.minimumRadius * 0.0025。
-
Default Value:
15000.0 or scene.ellipsoid.minimumRadius * 0.0025.
在惯性变焦时,在测试与地形碰撞之前,摄像机必须保持的最小距离。当使用除 WGS84 以外的其他椭球时,默认为 scene.ellipsoid.minimumRadius * 0.00063。
-
Default Value:
4000.0 or scene.ellipsoid.minimumRadius * 0.00063
在选择地形或场景内容(而不是椭球体)之前,摄像机必须达到的最小高度。当使用 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
rotateEventTypes : CameraEventType|Array|undefined
允许用户围绕地球或其他对象旋转的输入。这仅适用于 3D 和 Columbus 视图模式。
类型可以是 CameraEventType
、undefined
、eventType
以及类型为 CameraEventType
和 KeyboardEventModifier
的修饰符
属性,
或前面任何一个数组。
-
Default Value:
CameraEventType.LEFT_DRAG
tiltEventTypes : CameraEventType|Array|undefined
允许用户在 3D 和哥伦布视图中倾斜或在 2D 中扭曲的输入。
类型可以是 CameraEventType
、undefined
、eventType
以及类型为 CameraEventType
和 KeyboardEventModifier
的修饰符
属性,
或前面任何一个数组。
-
Default Value:
[CameraEventType.MIDDLE_DRAG
, CameraEventType.PINCH
, {
eventType : CameraEventType.LEFT_DRAG
,
modifier : KeyboardEventModifier.CTRL
}, {
eventType : CameraEventType.RIGHT_DRAG
,
modifier : KeyboardEventModifier.CTRL
}]
translateEventTypes : CameraEventType|Array|undefined
允许用户在地图上平移的输入。这仅适用于 2D 和 Columbus 视图模式。
类型可以是 CameraEventType
、undefined
、eventType
以及类型为 CameraEventType
和 KeyboardEventModifier
的修饰符
属性,
或前面任何一个数组。
-
Default Value:
CameraEventType.LEFT_DRAG
zoomEventTypes : CameraEventType|Array|undefined
允许用户放大/缩小的输入。
类型可以是 CameraEventType
、undefined
、eventType
以及类型为 CameraEventType
和 KeyboardEventModifier
的修饰符
属性,
或前面任何一个数组。
-
Default Value:
[CameraEventType.RIGHT_DRAG
, CameraEventType.WHEEL
, CameraEventType.PINCH
]
相机缩放速度的乘数。
-
Default Value:
5.0
Methods
删除此对象持有的鼠标侦听器。
一旦对象被销毁,就不应该使用它;调用
一旦对象被销毁,就不应该使用它;调用
isDestroyed
将导致 DeveloperError
异常。 因此
将返回值 (undefined
) 分配给对象,如示例中所示。
Throws:
-
DeveloperError : 这个物体被摧毁了,destroy().
Example:
controller = controller && controller.destroy();
See:
Returns:
true
,如果此对象被销毁;否则为 false
。