Documentation / scene / OrbitCameraController
Class: OrbitCameraController
Defined in: libs/scene/src/camera/orbit.ts:64
Orbit camera controller
Extends
Constructors
Constructor
new OrbitCameraController(
options?):OrbitCameraController
Defined in: libs/scene/src/camera/orbit.ts:95
Creates an instance of OrbitCameraController
Parameters
options?
Partial<OrbitCameraControllerOptions>
The creation options
Returns
OrbitCameraController
Overrides
BaseCameraController.constructor
Accessors
enabled
Get Signature
get enabled():
boolean
Defined in: libs/scene/src/camera/base.ts:224
Check if the controller is enabled.
Returns
boolean
Set Signature
set enabled(
value):void
Defined in: libs/scene/src/camera/base.ts:227
Parameters
value
boolean
Returns
void
Inherited from
center
Get Signature
get center():
Immutable<Vector3>
Defined in: libs/scene/src/camera/orbit.ts:139
Rotation center
Returns
Immutable<Vector3>
Set Signature
set center(
val):void
Defined in: libs/scene/src/camera/orbit.ts:142
Parameters
val
Immutable<Vector3>
Returns
void
Methods
_getCamera()
_getCamera():
Camera
Defined in: libs/scene/src/camera/base.ts:204
Get the attached camera.
Returns
The current camera or null if none is attached.
Inherited from
BaseCameraController._getCamera
_setCamera()
_setCamera(
camera):void
Defined in: libs/scene/src/camera/base.ts:215
Attach a camera to the controller.
If the camera changes, the controller will call reset() so subclasses can reinitialize state that depends on the camera.
Parameters
camera
The camera to attach.
Returns
void
Inherited from
BaseCameraController._setCamera
onMouseDown()
onMouseDown(
evt):boolean
Defined in: libs/scene/src/camera/base.ts:253
Handle pointer down (mouse/touch/pen) events.
Parameters
evt
The pointer event.
Returns
boolean
true if handled and should stop further processing; otherwise false.
Inherited from
BaseCameraController.onMouseDown
onMouseUp()
onMouseUp(
evt):boolean
Defined in: libs/scene/src/camera/base.ts:262
Handle pointer up events.
Parameters
evt
The pointer event.
Returns
boolean
true if handled; otherwise false.
Inherited from
BaseCameraController.onMouseUp
onMouseWheel()
onMouseWheel(
evt):boolean
Defined in: libs/scene/src/camera/base.ts:273
Handle mouse wheel (scroll) events.
Typical usage: zoom/dolly control, FOV adjustments.
Parameters
evt
The wheel event.
Returns
boolean
true if handled; otherwise false.
Inherited from
BaseCameraController.onMouseWheel
onMouseMove()
onMouseMove(
evt):boolean
Defined in: libs/scene/src/camera/base.ts:284
Handle pointer move events.
Typical usage: orbit, pan, or look controls based on button/modifier state.
Parameters
evt
The pointer event.
Returns
boolean
true if handled; otherwise false.
Inherited from
BaseCameraController.onMouseMove
onKeyDown()
onKeyDown(
evt):boolean
Defined in: libs/scene/src/camera/base.ts:295
Handle key down events.
Typical usage: WASD navigation, modifiers for speed, toggling modes.
Parameters
evt
The keyboard event.
Returns
boolean
true if handled; otherwise false.
Inherited from
BaseCameraController.onKeyDown
onKeyUp()
onKeyUp(
evt):boolean
Defined in: libs/scene/src/camera/base.ts:304
Handle key up events.
Parameters
evt
The keyboard event.
Returns
boolean
true if handled; otherwise false.
Inherited from
update()
update():
void
Defined in: libs/scene/src/camera/base.ts:317
Per-frame update.
Subclasses should override this to:
- Integrate velocities/accelerations and apply damping.
- Smoothly interpolate camera transforms.
- Clamp angles/distances/FOV, etc.
Called once per frame by the owning system.
Returns
void
Inherited from
_onKeyDown()
protected_onKeyDown(_evt):boolean
Defined in: libs/scene/src/camera/base.ts:363
Key down handler for subclasses to override.
Parameters
_evt
Keyboard event.
Returns
boolean
true if handled; otherwise false.
Inherited from
BaseCameraController._onKeyDown
_onKeyUp()
protected_onKeyUp(_evt):boolean
Defined in: libs/scene/src/camera/base.ts:372
Key up handler for subclasses to override.
Parameters
_evt
Keyboard event.
Returns
boolean
true if handled; otherwise false.
Inherited from
reset()
reset():
void
Defined in: libs/scene/src/camera/orbit.ts:158
Reset the controller's internal state.
Called automatically when a camera is attached via _setCamera. Subclasses should override this to reset accumulators, velocities, targets, etc.
Returns
void
Overrides
_onMouseDown()
protected_onMouseDown(evt):boolean
Defined in: libs/scene/src/camera/orbit.ts:173
Mouse down event handler
Parameters
evt
Returns
boolean
Boolean value indices whether this event was handled
Overrides
BaseCameraController._onMouseDown
_onMouseUp()
protected_onMouseUp(evt):boolean
Defined in: libs/scene/src/camera/orbit.ts:208
Pointer up handler for subclasses to override.
Parameters
evt
Pointer event.
Returns
boolean
true if handled; otherwise false.
Overrides
BaseCameraController._onMouseUp
_onMouseWheel()
protected_onMouseWheel(evt):boolean
Defined in: libs/scene/src/camera/orbit.ts:227
Mouse wheel handler for subclasses to override.
Parameters
evt
Wheel event.
Returns
boolean
true if handled; otherwise false.
Overrides
BaseCameraController._onMouseWheel
_onMouseMove()
protected_onMouseMove(evt):boolean
Defined in: libs/scene/src/camera/orbit.ts:235
Pointer move handler for subclasses to override.
Parameters
evt
Pointer event.
Returns
boolean
true if handled; otherwise false.
Overrides
BaseCameraController._onMouseMove
lookAt()
lookAt(
from,to,up):void
Defined in: libs/scene/src/camera/orbit.ts:287
Convenience method that delegates to camera.lookAt.
Parameters
from
Vector3
Camera position.
to
Vector3
Look-at target.
up
Vector3
Up direction.
Returns
void
Overrides
setOptions()
setOptions(
opt?):void
Defined in: libs/scene/src/camera/orbit.ts:304
Set options
Parameters
opt?
options
Returns
void
_onUpdate()
protected_onUpdate():void
Defined in: libs/scene/src/camera/orbit.ts:312
Per-frame update handler for subclasses to override.
Returns
void