[name]

This class is a special version of [page:TrackballControls] which supports orthographic cameras.

Example

[example:misc_controls_trackball_orthographic misc / controls / trackball / orthographic ]

Constructor

[name]( [param:OrthographicCamera camera], [param:HTMLDOMElement domElement] )

[page:OrthographicCamera camera]: The orthographic camera of the rendered scene.

[page:HTMLDOMElement domElement]: (optional) The HTML element used for event listeners. By default this is the whole document, however if you only want the controls to work over a specific element (e.g. the canvas) you can specify that here.

Creates a new instance of [name].

Events

change

Fires when the camera has been transformed by the controls.

start

Fires when an interaction (e.g. touch) was initiated.

end

Fires when an interaction has finished.

Properties

[property:HTMLDOMElement domElement]

The HTMLDOMElement used to listen for mouse / touch events. This must be passed in the constructor; changing it here will not set up new event listeners. Default is the whole document.

[property:Number dynamicDampingFactor]

Defines the intensity of damping. Only considered if [page:.staticMoving staticMoving] is set to *false*. Default is *0.2*.

[property:Boolean enabled]

Whether or not the controls are enabled.

[property:Array keys]

This array holds keycodes for controlling interactions.

• When the first defined key is pressed, all mouse interactions (left, middle, right) performs orbiting.
• When the second defined key is pressed, all mouse interactions (left, middle, right) performs zooming.
• When the third defined key is pressed, all mouse interactions (left, middle, right) performs panning.

[property:Boolean noPan]

Whether or not panning is disabled. Default is *false*.

[property:Boolean noRoll]

Whether or not rolling is disabled. Default is *false*.

[property:Boolean noRotate]

Whether or not rotation is disabled. Default is *false*.

[property:Boolean noZoom]

Whether or not zooming is disabled. Default is *false*.

[property:OrthographicCamera object]

The camera being controlled.

[property:Number panSpeed]

The zoom speed. Default is *0.3*.

[property:Number rotateSpeed]

The rotation speed. Default is *1.0*.

[property:Object screen]

Represents the properties of the screen. Automatically set when [page:.handleResize handleResize]() is called.

• left: Represents the offset in pixels to the screen's left boundary.
• top: Represents the offset in pixels to the screen's top boundary.
• width: Represents the screen width in pixels.
• height: Represents the screen height in pixels.

[property:Boolean staticMoving]

Whether or not damping is disabled. Default is *false*.

[property:Number zoomSpeed]

The zoom speed. Default is *1.2*.

Methods

[method:null dispose] ()

Should be called if the controls is no longer required.

[method:null handleResize] ()

Should be called if the application window is resized.

[method:null panCamera] ()

Performs panning if necessary. Called by [page:.update update]().

[method:null reset] ()

Resets the controls to its initial state.

[method:null rotateCamera] ()

Rotates the camera if necessary. Called by [page:.update update]().

[method:null update] ()

Updates the controls. Usually called in the animation loop.

[method:null zoomCamera] ()

Performs zooming if necessary. Called by [page:.update update]().

Source

[link:https://github.com/mrdoob/three.js/blob/master/examples/js/controls/TrackballControls.js examples/js/controls/TrackballControls.js]