# Cameras

The **Cameras** section — in the **Scene** tab of [Studio](https://developer.playcanvas.com/user-manual/supersplat/studio.md)'s left panel — defines the **starting camera** for your published splat: the view a visitor lands on when they open your [scene page](https://developer.playcanvas.com/user-manual/supersplat/scene-page.md) (unless a [camera animation track](https://developer.playcanvas.com/user-manual/supersplat/editor/timeline.md) or [annotation](https://developer.playcanvas.com/user-manual/supersplat/studio/annotations.md) drives the start pose instead). The camera has a **position**, a **target** (the point it looks at), and a **field of view**.

[Image: The Cameras panel with a list of cameras]

:::note

Studio currently supports a single camera. Support for multiple cameras is coming.

:::

## Setting the camera

The camera is listed as **Camera 1** with two icon buttons:

- **Go to** (crosshair icon) — flies the viewport to the camera's saved pose.
- **Edit** (pencil icon) — opens [camera edit mode](https://developer.playcanvas.com/user-manual/supersplat/studio/cameras.md#edit-camera-mode) to frame a new starting view. The pencil turns yellow while edit mode is active.

You set the camera's **position** and **target** by framing the viewport. There are no numeric position or target inputs in the Cameras panel.

### Edit camera mode

1. Click **Edit** (the pencil) in the Cameras panel. Studio enters camera edit mode: the viewport flies to the camera's saved pose, a thick yellow border frames the viewport, and a **Camera Edit Mode** badge appears at the top left, with **Apply** and **Cancel** buttons beside it.
2. Orbit, pan, and zoom the viewport to frame the shot (see [Camera Controls](https://developer.playcanvas.com/user-manual/supersplat/editor/camera-controls.md) for navigation).
3. Click **Apply** to save the viewport's **position**, **target** (look-at point), and **field of view** as Camera 1's stored start pose, then exit edit mode.
4. Click **Cancel** to exit without saving; the viewport returns to the last saved pose.

:::tip

While framing, **double-click a point on the splat** to set it as the focal point — the point the camera orbits around. The view smoothly re-centres on that point without moving the camera's position. Double-clicking empty space has no effect.

:::

Click **Edit** again (or press **Escape**) to exit edit mode without saving. Unlike **Cancel**, the viewport is not restored — only the stored pose stays unchanged.

[Video](https://developer.playcanvas.com/video/supersplat-studio-edit-camera.mp4)

## Lens (field of view)

Below the camera list, the **Lens** control sets the **field of view** with a slider and a numeric input, in whole degrees from **10°** to **120°** (default **75°**). The value is the **full** viewing angle, not a half-angle. On a **wide** viewport the angle is measured **horizontally** (left to right); on a **tall** viewport it is measured **vertically** (top to bottom). You store one number — Studio and the published scene page apply it to whichever axis suits the screen shape.

This is a single, global setting — it applies to the start camera and all annotation cameras.

## Defaults

A fresh scene starts with a single camera at a **75°** field of view, with position and target chosen for the scene type:

- **Environment-style** scenes — position `[0, 2, 0]`, target `[2, 2, 0]`.
- **Object-style** scenes — position `[2, 2, -2]`, target `[0, 0, 0]`.

Use [camera edit mode](https://developer.playcanvas.com/user-manual/supersplat/studio/cameras.md#edit-camera-mode) to frame the viewport and click **Apply** to capture a new pose, then adjust the **Lens** field of view so the scene looks the way you want visitors to see it on first load.

## How cameras are used

- **Initial framing** — the first camera in the list is the default starting view when a visitor opens the scene page (`startMode: 'default'`). A [camera animation track](https://developer.playcanvas.com/user-manual/supersplat/editor/timeline.md) or an [annotation](https://developer.playcanvas.com/user-manual/supersplat/studio/annotations.md) can override this via the scene's start mode.
- **Annotation poses** — each [annotation](https://developer.playcanvas.com/user-manual/supersplat/studio/annotations.md) embeds its own camera pose that the viewer animates to when the annotation is selected. The annotation's pose is independent of the entries in the Cameras list.

## See also

- [Camera animation (Timeline)](https://developer.playcanvas.com/user-manual/supersplat/editor/timeline.md) — keyframed camera motion, authored in the SuperSplat Editor
- [Annotations](https://developer.playcanvas.com/user-manual/supersplat/studio/annotations.md) — 3D-positioned hotspots that can adopt a camera pose
- [Experience Settings](https://developer.playcanvas.com/user-manual/supersplat/studio/experience-settings.md) — the JSON contract that stores the camera list