Modifies the camera position and orientation based on mouse input to a canvas.
| 参数名称 | 类型 | 描述信息 |
|---|---|---|
scene |
Scene | The scene. |
成员(属性)
Sets the duration, in seconds, of the bounce back animations in 2D and Columbus view.
-
默认值:
3.0
When disabled, the values of
maximumZoomDistance and minimumZoomDistance are ignored.
-
默认值:
true
If true, inputs are allowed conditionally with the flags enableTranslate, enableZoom,
enableRotate, enableTilt, and enableLook. If false, all inputs are disabled.
NOTE: This setting is for temporary use cases, such as camera flights and
drag-selection of regions (see Picking demo). It is typically set to false at the
start of such events, and set true on completion. To keep inputs disabled
past the end of camera flights, you must use the other booleans (enableTranslate,
enableZoom, enableRotate, enableTilt, and enableLook).
-
默认值:
true
If true, allows the user to use free-look. If false, the camera view direction can only be changed through translating
or rotating. This flag only applies in 3D and Columbus view modes.
-
默认值:
true
If true, allows the user to rotate the world which translates the user's position.
This flag only applies in 2D and 3D.
-
默认值:
true
If true, allows the user to tilt the camera. If false, the camera is locked to the current heading.
This flag only applies in 3D and Columbus view.
-
默认值:
true
If true, allows the user to pan around the map. If false, the camera stays locked at the current position.
This flag only applies in 2D and Columbus view modes.
-
默认值:
true
If true, allows the user to zoom in and out. If false, the camera is locked to the current distance from the ellipsoid.
-
默认值:
true
A parameter in the range
[0, 1) used to determine how long
the camera will continue to spin because of inertia.
With value of zero, the camera will have no inertia.
-
默认值:
0.9
A parameter in the range
[0, 1) used to determine how long
the camera will continue to translate because of inertia.
With value of zero, the camera will have no inertia.
-
默认值:
0.9
A parameter in the range
[0, 1) used to determine how long
the camera will continue to zoom because of inertia.
With value of zero, the camera will have no inertia.
-
默认值:
0.8
lookEventTypes : CameraEventType|Array|undefined
The input that allows the user to change the direction the camera is viewing. This only applies in 3D and Columbus view modes.
The type can be a CameraEventType, undefined, an object with eventType
and modifier properties with types CameraEventType and KeyboardEventModifier,
or an array of any of the preceding.
-
默认值:
{ eventType : CameraEventType.LEFT_DRAG, modifier : KeyboardEventModifier.SHIFT }
A parameter in the range
[0, 1) used to limit the range
of various user inputs to a percentage of the window width/height per animation frame.
This helps keep the camera under control in low-frame-rate situations.
-
默认值:
0.1
The angle, relative to the ellipsoid normal, restricting the maximum amount that the user can tilt the camera. If
undefined, the angle of the camera tilt is unrestricted.
-
默认值:
undefined
使用示例:
// Prevent the camera from tilting below the ellipsoid surface
viewer.scene.screenSpaceCameraController.maximumTiltAngle = Math.PI / 2.0;
The maximum magnitude, in meters, of the camera position when zooming. Defaults to positive infinity.
-
默认值:
Number.POSITIVE_INFINITY
The minimum height the camera must be before testing for collision with terrain. Default to scene.ellipsoid.minimumRadius * 0.0025 when another ellipsoid than WGS84 is used.
-
默认值:
15000.0 or scene.ellipsoid.minimumRadius * 0.0025.
The minimum distance the camera must be before testing for collision with terrain when zoom with inertia. Default to scene.ellipsoid.minimumRadius * 0.00063 when another ellipsoid than WGS84 is used.
-
默认值:
4000.0 or scene.ellipsoid.minimumRadius * 0.00063
The minimum height the camera must be before picking the terrain or scene content instead of the ellipsoid. Defaults to scene.ellipsoid.minimumRadius * 0.025 when another ellipsoid than WGS84 is used.
-
默认值:
150000.0 or scene.ellipsoid.minimumRadius * 0.025
The minimum height the camera must be before switching from rotating a track ball to
free look when clicks originate on the sky or in space. Defaults to ellipsoid.minimumRadius * 1.175 when another ellipsoid than WGS84 is used.
-
默认值:
7500000.0 or scene.ellipsoid.minimumRadius * 1.175
The minimum magnitude, in meters, of the camera position when zooming. Defaults to 1.0.
-
默认值:
1.0
rotateEventTypes : CameraEventType|Array|undefined
The input that allows the user to rotate around the globe or another object. This only applies in 3D and Columbus view modes.
The type can be a CameraEventType, undefined, an object with eventType
and modifier properties with types CameraEventType and KeyboardEventModifier,
or an array of any of the preceding.
tiltEventTypes : CameraEventType|Array|undefined
The input that allows the user to tilt in 3D and Columbus view or twist in 2D.
The type can be a CameraEventType, undefined, an object with eventType
and modifier properties with types CameraEventType and KeyboardEventModifier,
or an array of any of the preceding.
-
默认值:
[CameraEventType.MIDDLE_DRAG, CameraEventType.PINCH, {
eventType : CameraEventType.LEFT_DRAG,
modifier : KeyboardEventModifier.CTRL
}, {
eventType : CameraEventType.RIGHT_DRAG,
modifier : KeyboardEventModifier.CTRL
}]
translateEventTypes : CameraEventType|Array|undefined
The input that allows the user to pan around the map. This only applies in 2D and Columbus view modes.
The type can be a CameraEventType, undefined, an object with eventType
and modifier properties with types CameraEventType and KeyboardEventModifier,
or an array of any of the preceding.
zoomEventTypes : CameraEventType|Array|undefined
The input that allows the user to zoom in/out.
The type can be a CameraEventType, undefined, an object with eventType
and modifier properties with types CameraEventType and KeyboardEventModifier,
or an array of any of the preceding.
A multiplier for the speed at which the camera will zoom.
-
默认值:
5.0
方法
Removes mouse listeners held by this object.
Once an object is destroyed, it should not be used; calling any function other than
Once an object is destroyed, it should not be used; calling any function other than
isDestroyed will result in a DeveloperError exception. Therefore,
assign the return value (undefined) to the object as done in the example.
Throws:
-
DeveloperError : This object was destroyed, i.e., destroy() was called.
使用示例:
controller = controller && controller.destroy();参考:
Returns true if this object was destroyed; otherwise, false.
If this object was destroyed, it should not be used; calling any function other than
If this object was destroyed, it should not be used; calling any function other than
isDestroyed will result in a DeveloperError exception.
返回值:
true if this object was destroyed; otherwise, false.