Class CameraManager

CameraManager - Manages dual camera system (perspective + orthographic)

Example usage:

const cameraManager = new CameraManager(aspect, {
  fov: 45,
  initialPosition: new THREE.Vector3(0, 1, 3)
});

const camera = cameraManager.getActiveCamera();

// Switch camera mode
cameraManager.toggleCameraMode(controls);

// Reset to initial position
cameraManager.resetCamera(controls);

// Handle window resize
cameraManager.handleResize(newWidth, newHeight);

Constructors

constructor

new CameraManager(aspect: number, config?: CameraConfig): CameraManager
Create a new CameraManager
Parameters
- aspect: number
  Initial aspect ratio (width / height)
- config: CameraConfig = {}
  Camera configuration
Returns CameraManager
- Defined in managers/CameraManager.ts:107

Methods

getActiveCamera

getActiveCamera(): PerspectiveCamera | OrthographicCamera
Get the currently active camera

Returns PerspectiveCamera | OrthographicCamera
- Defined in managers/CameraManager.ts:153

getPerspectiveCamera

getPerspectiveCamera(): PerspectiveCamera
Get the perspective camera

Returns PerspectiveCamera
- Defined in managers/CameraManager.ts:160

getOrthographicCamera

getOrthographicCamera(): OrthographicCamera
Get the orthographic camera

Returns OrthographicCamera
- Defined in managers/CameraManager.ts:167

isOrthographicMode

isOrthographicMode(): boolean
Check if currently using orthographic camera

Returns boolean
- Defined in managers/CameraManager.ts:174

getCameraType

getCameraType(): "perspective" | "orthographic"
Get current camera type

Returns "perspective" | "orthographic"
- Defined in managers/CameraManager.ts:181

toggleCameraMode

toggleCameraMode(controls?: any): PerspectiveCamera | OrthographicCamera
Toggle between perspective and orthographic camera
Parameters
- Optionalcontrols: any
  Optional OrbitControls to update
Returns PerspectiveCamera | OrthographicCamera
The new active camera
- Defined in managers/CameraManager.ts:191

resetCamera

resetCamera(controls?: any): void
Reset camera to initial position and target
Parameters
- Optionalcontrols: any
  Optional OrbitControls to update
Returns void
- Defined in managers/CameraManager.ts:237

setInitialPosition

setInitialPosition(position: Vector3): void
Set initial camera position (for reset)
Parameters
- position: Vector3
  New initial position
Returns void
- Defined in managers/CameraManager.ts:251

setInitialTarget

setInitialTarget(target: Vector3): void
Set initial target position (for reset)
Parameters
- target: Vector3
  New initial target
Returns void
- Defined in managers/CameraManager.ts:260

updateCameraPosition

updateCameraPosition(position: Vector3, target?: Vector3, controls?: any): void
Update both cameras for the current position/target Useful when programmatically moving the camera
Parameters
- position: Vector3
  New camera position
- Optionaltarget: Vector3
  New target position
- Optionalcontrols: any
  Optional controls to update
Returns void
- Defined in managers/CameraManager.ts:272

handleResize

handleResize(width: number, height: number): void
Handle window resize - updates both cameras
Parameters
- width: number
  New width in pixels
- height: number
  New height in pixels
Returns void
- Defined in managers/CameraManager.ts:304

saveCameraState

saveCameraState(controls?: any): CameraState
Save current camera state
Parameters
- Optionalcontrols: any
  Optional controls to save target from
Returns CameraState
CameraState object
- Defined in managers/CameraManager.ts:337

restoreCameraState

restoreCameraState(state: CameraState, controls?: any): void
Restore camera state
Parameters
- state: CameraState
  CameraState to restore
- Optionalcontrols: any
  Optional controls to update
Returns void
- Defined in managers/CameraManager.ts:366

getInitialPosition

getInitialPosition(): Vector3
Get the initial position

Returns Vector3
- Defined in managers/CameraManager.ts:386

getInitialTarget

getInitialTarget(): Vector3
Get the initial target

Returns Vector3
- Defined in managers/CameraManager.ts:393

calculateOptimalDistance

calculateOptimalDistance(boundingBox: Box3, padding?: number): number
Calculate optimal camera distance for a given bounding box
Parameters
- boundingBox: Box3
  The bounding box to frame
- padding: number = 1.2
  Optional padding factor (default 1.2)
Returns number
Optimal camera distance
- Defined in managers/CameraManager.ts:404

frameBoundingBox

frameBoundingBox(boundingBox: Box3, controls?: any, padding?: number): void
Frame a bounding box - positions camera to view entire box
Parameters
- boundingBox: Box3
  The bounding box to frame
- Optionalcontrols: any
  Optional controls to update
- padding: number = 1.2
  Optional padding factor (default 1.2)
Returns void
- Defined in managers/CameraManager.ts:424

dispose

dispose(): void
Dispose of cameras (cleanup)

Returns void
- Defined in managers/CameraManager.ts:484

Properties

`Private`perspectiveCamera

perspectiveCamera: PerspectiveCamera

`Private`orthographicCamera

orthographicCamera: OrthographicCamera

`Private`activeCamera

activeCamera: PerspectiveCamera | OrthographicCamera

`Private`isOrthographic

isOrthographic: boolean = false

`Private`initialPosition

initialPosition: Vector3

`Private`initialTarget

initialTarget: Vector3

`Private`frustumSize

frustumSize: number

`Private`currentAspect

currentAspect: number

Class CameraManager

Index

Constructors

Methods

Properties

Constructors

constructor

Parameters

Returns CameraManager

Methods

getActiveCamera

Returns PerspectiveCamera | OrthographicCamera

getPerspectiveCamera

Returns PerspectiveCamera

getOrthographicCamera

Returns OrthographicCamera

isOrthographicMode

Returns boolean

getCameraType

Returns "perspective" | "orthographic"

toggleCameraMode

Parameters

Returns PerspectiveCamera | OrthographicCamera

resetCamera

Parameters

Returns void

setInitialPosition

Parameters

Returns void

setInitialTarget

Parameters

Returns void

updateCameraPosition

Parameters

Returns void

handleResize

Parameters

Returns void

saveCameraState

Parameters

Returns CameraState

restoreCameraState

Parameters

Returns void

getInitialPosition

Returns Vector3

getInitialTarget

Returns Vector3

calculateOptimalDistance

Parameters

Returns number

frameBoundingBox

Parameters

Returns void

dispose

Returns void

Properties

PrivateperspectiveCamera

PrivateorthographicCamera

PrivateactiveCamera

PrivateisOrthographic

PrivateinitialPosition

PrivateinitialTarget

PrivatefrustumSize

PrivatecurrentAspect

Settings

On This Page

`Private`perspectiveCamera

`Private`orthographicCamera

`Private`activeCamera

`Private`isOrthographic

`Private`initialPosition

`Private`initialTarget

`Private`frustumSize

`Private`currentAspect