Skip to content

Nodes · 3D

SplatRead

3Dv1app

Overview

A captured location as millions of soft elliptical blobs, with parallax and view-dependent colour, depth-composited against cards and geometry.

How to

  1. Point file at the .ply / .splat / .spz.
  2. Set color_space to what the trainer baked.
  3. Lower budget until the viewport is comfortable; the HUD says what was dropped.
  4. Clean the capture with floater_removal and opacity_floor.

Inputs

InputWhat it takes
inthe image this node works on

Outputs

OutputType
outScene

Parameters

ParameterTypeDefaultWhat it does
fileTextString::new(The file on disk — use #### for frame numbers in a sequence.
color_spaceChoicesrgbNot documented yet.
orientationChoicey-down (3DGS)Not documented yet.
cluster_toleranceFloat0Not documented yet.
budgetInt600_000Not documented yet.
relightChoiceoffNot documented yet.
exposureFloat0Brightness in photographic stops: +1 doubles the light.
ambientFloat1Not documented yet.
light_gainFloat1Not documented yet.
floater_removalFloat0Not documented yet.
opacity_floorFloat0Not documented yet.
txFloat0Translate X — position along the world X axis, metres.
tyFloat0Translate Y — position along the world Y axis (up), metres.
tzFloat0Translate Z — position along the world Z axis, metres. The camera looks down −Z.
rxFloat0Rotate around X, degrees.
ryFloat0Rotate around Y (turntable), degrees.
rzFloat0Rotate around Z (roll), degrees.
sxFloat1Scale along X. 1 = unchanged.
syFloat1Scale along Y.
szFloat1Scale along Z.

Known edges

Loading is off-thread: the box draws dim while streaming. Async depth sorting is on in the viewport and off in renders, so an AOV render stays byte-deterministic.

See also

  • The 3D system — How to put geometry, cameras and volumes in the comp — without becoming a 3D application.
  • Gaussian splats — How to bring a captured location into the comp — and relight it.