Skip to main content

Cameras

The Cameras section — in the Scene tab of Studio's left panel — defines the starting camera for your published splat: the view a visitor lands on when they open your scene page (unless a camera animation track or annotation drives the start pose instead). The camera has a position, a target (the point it looks at), and a field of view.

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 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 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.

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 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 or an annotation can override this via the scene's start mode.
  • Annotation poses — each annotation 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​