Function autoFrameCamera

autoFrameCamera(
    camera: LuxarCamera,
    controls: ControlsManager,
    bounds: BoundingBox | null,
    preserveTarget?: boolean,
    up?: Vector3,
): AutoFrameResult
Auto-frame the camera to fit a pre-computed (typically metadata- derived) 3D bounding box. For orthographic cameras, adjusts zoom instead of distance.

Used by SceneManager.loadSceneData() to auto-frame on scene load.
Parameters
- camera: LuxarCamera
- controls: ControlsManager
- bounds: BoundingBox | null
- preserveTarget: boolean = false
  If true, keep the current controls target (set by zarr viewer_config) instead of overwriting it with the bounding box center.
- Optionalup: Vector3
Returns AutoFrameResult
- Defined in src/scene/scene-manager/camera/camera-framing.ts:444