SarabSplatter4D¶
SarabSplatter4D plays Gaussian-splat scenes — the photoreal 3D captures made by Postshot, Luma, Polycam, SuperSplat, gsplat / Nerfstudio and similar tools — inside your footage or as a scene of its own, with an iOS capture companion app and a desktop training workflow for your own scans.
Overview¶
Load a .ply (3D Gaussian Splatting), a PlayCanvas / SuperSplat compressed .ply, a .splat, or a
.sarabsplatter4d scan of your own, frame it with Frame Scene and the orbit camera, and every splat renders on
the GPU at full resolution — a million splats in about ten milliseconds on Apple Silicon (the SarabScene3D engine,
shared with SarabMesh). With a SarabResolver camera upstream (Write CameraLink / linked camera) the scene follows the
shot.
Render Quality: Draft renders at half resolution for scrubbing; the other tiers render every splat at full resolution. Max Gaussians (0 = all) keeps only the nearest N splats for previews of very large scenes.
Adding it to your shot¶
Apply SarabSplatter4D from the SarabFX category (SarabFX/3D) in the Effects/OFX library of DaVinci Resolve, Nuke, Natron, or any other OFX-compatible host, then drag it onto your clip/node. (Restart the host after installing new plugins.)
Key parameters¶
| Parameter | What it controls | Default |
|---|---|---|
| Scene File | The splat scene: .sarabsplatter4d (SarabSplatterCapture, animated), 3DGS .ply, PlayCanvas / SuperSplat compressed .ply, or .splat. Reload Scene File re-reads it. |
— |
| Composite Over Source | Draw the splats over the source clip (on) or against black (off). | on |
| Camera Mode / Position / Rotation / FOV | Manual camera, Linked (SarabResolver's CameraLink from the source) or Lua. Orbit Around Scene turns Rotation into a turntable about the scene's centre. Frame Scene resets the camera. | Manual |
| Time Mode (Time (4D) group) | For animated .sarabsplatter4d scenes. Synced: scene time = timeline seconds × Time Warp + Time Offset. Manual: scene time = Manual Time, keyframed by hand (scrub, hold, reverse). Still scenes ignore the group. |
Synced |
| Manual Time (s) | The scene time in seconds in Manual mode. | 0 |
| Time Warp / Time Offset (s) | Playback speed relative to the capture (0 freezes it) and the seconds added, in Synced mode. | 1.0 / 0 |
| Loop | Wrap the scene time around the capture's duration; off holds the last moment. | on |
| Master Density / Splat Size / Min & Max Splat Size | Per-splat opacity multiplier and the screen-size envelope of the splats. | 1.0 / 1.0 |
| Render Quality | Draft renders at half resolution for fast previews; the other settings at full resolution. | Full |
| Max Gaussians | Cap on the number of splats drawn (0 = all). | 0 |
| Frame Cache | Optional memory / disk cache of rendered frames with the usual Clear buttons and GB budget. | off |
Viewport gizmos¶
To document
SarabSplatter4D provides an interactive camera gizmo in the viewport (default camera position (0, 0, 5)) for orbiting and framing the reconstructed scene. Document how to drag/rotate/scale and any modifier keys.
Note: overlays render in canonical coordinates scaled by renderScale —
see the coordinate-system notes in the internal engineering docs if you're
debugging gizmo drift across preview resolutions.
Examples & media¶
Adding screenshots & videos
Drop assets in docs/assets/plugins/sarabsplatter4d/ and embed them:
- Image:
 - Video: a raw HTML5 block —
Tips & troubleshooting¶
To document
Common pitfalls, performance notes (GPU/frame cache), host-specific quirks.
- Capture workflow: scan with the companion iPhone app, AirDrop the .sabscan to a Mac, train it into a .sarabsplatter4d asset, then render with this plugin. Document the end-to-end capture-to-render steps with screenshots once available.
See also: Installation · Activation · All plugins