ScreenSpaceCameraController

ScreenSpaceCameraController

new

Modifies the camera position and orientation based on mouse input to a canvas.

Parameters:
Name Type Description
canvas HTMLCanvasElement The canvas to listen for events.
cameraController CameraController The camera controller used to modify the camera.
Throws:
Source:

Members

:Number

Sets the duration, in milliseconds, of the bounce back animations in 2D and Columbus view. The default value is 3000.
Default Value:
  • 3000.0

:CameraColumbusViewMode

Sets the behavior in Columbus view.
Default Value:

:Boolean

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.
Default Value:
  • true

:Boolean

If true, allows the user to rotate the camera. If false, the camera is locked to the current heading. This flag only applies in 2D and 3D.
Default Value:
  • true

:Boolean

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.
Default Value:
  • true

:Boolean

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.
Default Value:
  • true

:Boolean

If true, allows the user to zoom in and out. If false, the camera is locked to the current distance from the ellipsoid.
Default Value:
  • true

:Number

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.
Default Value:
  • 0.9

:Number

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.
Default Value:
  • 0.9

:Number

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.
Default Value:
  • 0.8

:Number

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.
Default Value:
  • 0.1

:Number

The maximum magnitude, in meters, of the camera position when zooming. Defaults to positive infinity.
Default Value:
  • Number.POSITIVE_INFINITY

:Number

The minimum magnitude, in meters, of the camera position when zooming. Defaults to 20.0.
Default Value:
  • 20.0

Methods

Removes mouse listeners held by this object.

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.
Returns:
Example
controller = controller && controller.destroy();
See:

Returns true if this object was destroyed; otherwise, false.

If this object was destroyed, it should not be used; calling any function other than isDestroyed will result in a DeveloperError exception.

Returns:
Boolean true if this object was destroyed; otherwise, false.
See:

<static>

Gets the ellipsoid. The ellipsoid is used to determine the size of the map in 2D and Columbus view as well as how fast to rotate the camera based on the distance to its surface.

Returns:
Ellipsoid The ellipsoid.

<static>

Sets the ellipsoid. The ellipsoid is used to determine the size of the map in 2D and Columbus view as well as how fast to rotate the camera based on the distance to its surface.

Parameters:
Name Type Argument Default Description
ellipsoid Ellipsoid <optional>
WGS84 The ellipsoid.