SarabMesh¶
SarabMesh puts a 3D model — glTF / glb, FBX, OBJ or an Alembic cache, animated or still — into your footage. With SarabResolver upstream the model is rendered from the shot's real camera, lit by a key light and a sky/ground ambient, casts a shadow on the real floor, and is hidden by the real objects in front of it, pixel by pixel. Place in Footage moves, turns and scales it with the same gizmos as every other SarabFX 3D plugin.
Adding it to your shot¶
Chain Read → SarabResolver → SarabMesh. Set SarabResolver's Output to Source with depth in alpha and resolve the clip (Resolve Clip Now). Then in SarabMesh pick a Model File, click Place and click the floor where the model should stand, and use the gizmos (Scene Gizmo: Object Position / Rotation / Scale) to adjust.
Without SarabResolver the model still renders, framed by an automatic camera over the source — handy to check a file.
Apply SarabMesh from the SarabFX/3D category in DaVinci Resolve, Nuke, Natron or any other OFX host.
Supported files¶
| Format | Notes |
|---|---|
glTF 2.0 .glb / .gltf |
PBR metallic-roughness materials, base colour / metal-rough / emissive textures (embedded, external or data URI), alpha mask and blend, double-sided. Animation clips and skinned characters play (translation / rotation / scale channels; morph targets not yet). |
FBX .fbx |
Meshes, PBR or classic materials, embedded or external textures, skin deformers and animation stacks (curves sampled densely at load, interpolated at any frame rate). Converted to metres, y-up. |
OBJ .obj + .mtl |
Kd → base colour, map_Kd → texture, Ns → roughness. Textures must sit next to the file. Static. |
Alembic .abc |
Polygon-mesh caches from Houdini, Maya, Blender…: the geometry is played back sample by sample (fixed topology — a cache whose vertex count changes is shown from its first sample). No materials: the model takes the plugin's lighting on a neutral surface. |
Animation¶
| Parameter | What it controls | Default |
|---|---|---|
| Time Mode | Timeline: the clip plays with the timeline (timeline seconds × Speed + Time Offset). Manual: the clip time is Manual Time, and Speed / Time Offset are ignored. | Timeline |
| Manual Time (s) | The clip time in seconds in Manual mode. Keyframe it: a linear ramp plays, a flat section holds a pose, a falling ramp plays backwards — the animation follows your keys, not the timeline. | 0 |
| Clip | Which animation clip of the file plays — Model Info lists them by index (glTF: the file's animations; FBX: one per animation stack; Alembic caches ignore it). | 0 |
| Speed | Playback speed relative to the file's timing; 0 freezes the pose at the offset. | 1.0 |
| Time Offset (s) | Seconds added to the clip time. Animate it (with Speed 0) to scrub the animation by hand, or set it so the action starts on the right frame. | 0 |
| Loop | Wrap around at the end of the clip / cache. | on |
| Animate in Place | Keeps the character's root where you placed it — a walk or run authored moving forward no longer travels across the shot (the vertical bob stays). Off lets the clip's travel move the model. | on |
In Timeline mode the clip time is timeline seconds × Speed + Offset, so a character keeps its own tempo whatever the frame rate. Switch to Manual mode to drive the clip time with keyframes instead — a hold on the pose you need, a hit timed to a cut, a slow-motion section — while the model still sits in the tracked shot.
New nodes place the model facing the camera (glTF and FBX models look down +Z, the same axis the first camera looks along, so an unrotated model would show its back).
Key parameters¶
| Parameter | What it controls | Default |
|---|---|---|
| Model File | The glTF / glb / FBX / OBJ / Alembic file (~/ is expanded). Reload Model re-reads it; it also reloads when the file changes on disk. Model Info shows the triangle count, the file's own height and the clips. | — |
| Model Height (world units) | The model is scaled so its height equals this in SarabResolver's world (a room is a few units across; a person ≈ 0.4–0.6). Place in Footage's Scale multiplies it. 0 keeps the file's own units — a fox authored in centimetres would then be 80 units tall. | 0.4 |
| Opacity | Overall opacity of the model. | 1.0 |
| Light Azimuth / Elevation | Where the key light comes from — degrees around the vertical axis and above the horizon. Match the shot's sun or key. | 35 / 50 |
| Light Intensity / Colour | Strength and tint of the key light. | 3.0 / warm white |
| Ambient Sky / Ground | Hemisphere fill from above and below (the room's bounce). | blue-grey / brown |
| Exposure | Multiplier on the rendered model. | 1.0 |
| Output Gamma | 1.0 for a linear working space (Natron), 2.2 for a display-encoded timeline (Resolve). | 1.0 |
| Self Shadows | The model shadows itself (shadow map). | on |
| Shadow on Floor / Floor Shadow Strength | Darkens the real floor under the model: an invisible plane at the anchor's height catches the shadow. | on / 0.6 |
| Occlusion Softness | How softly the real scene's edge cuts into the model (world units). | 0.01 |
| Place in Footage | Position, Rotation, Scale, Anchor, Place Plane, Make Level, Track Point / Follow Tracked Point (the model rides something moving in the shot — see Motion beyond keyframes), Pass Scene Downstream — shared with all SarabFX 3D plugins. | — |
How it renders¶
SarabMesh runs on SarabScene3D, the native GPU engine also behind SarabSplatter4D: indexed triangles with a depth buffer, GGX metallic-roughness shading, a 2048² shadow map with soft filtering, and the model's colour and distance written together so the compositor can test every pixel against the footage's depth. A million triangles render in a few milliseconds on Apple Silicon.
Tips¶
- Set Light Azimuth / Elevation by looking at a real shadow in the plate; then trim Ambient Sky / Ground until the model's shaded side matches nearby objects.
- The floor shadow lands on the plane through the Anchor: click Place on the floor, not on a table, unless the model stands on the table.
- Turn Pass Scene Downstream on to put a SarabOrtex shader or another model behind or in front of this one.