Optionalopts: CaptureOptionsRe-fit the camera to the current model bounds (the default 3/4 view), fitting the bounding box to the canvas aspect and field of view. Also resumes auto-framing on resize.
Current camera pose, or null before a source is set / when the renderer is unsupported.
The current plate placement decision (null placement = no plate drawn).
The fallback background tier (DD-032): beaten by a theme.background, so after setTheme with a theme
that sets one this has no visible effect until that theme's background is cleared.
Set or remove (null) the build plate. Re-places the model and, while auto-framing, re-fits the camera.
Show/hide the build-volume wireframe cage, independently of the plate, grid and shadow (parity with the
toolpath setBuildVolumeCage). The model does not move and the camera is not re-fitted. Remembered when the
plate is rebuilt (a new bed, theme or scope).
Change the perspective lens, [10, 120]° (RangeError outside it). Keeps apparent size; re-fits while auto-framing.
Change the resting pixel ratio: (0, 4] or 'device' (DPR capped at 2, followed live). RangeError
otherwise. A gesture in progress settles on the new ratio; the default capture() size does not change.
Render only a subset of the current source (DD-030 D2): { plateId }, { objectIds }, or an
{ instanceFilter }; null restores the whole source. Rebuilds and reframes to the subset. Gate a
{ plateId } on the ready info's plates being present — an unmatched scope renders empty.
Parse → build → frame → ready. Async (3MF unzips). Overlapping calls are last-wins.
Replace the plate/backdrop theme (replace semantics). Throws RangeError for an invalid opacity/every.
Snap to a preset orientation (shared with the toolpath camera).
Capture the current view as an image
Blob(DD-030 D1) — for an operator-selected thumbnail or a large-file fallback. Rejects withE_CAPTURE_UNSUPPORTEDwhen the renderer is unavailable.