Talos docs

splat

Since 0.6
Plain text

Use it in a scene entity's components list as { "type": "splat", … }. The contract writes the fields flat and refuses unknown keys.

Fields

FieldTypeRequiredDefaultAllowed valuesDescription
assetstringyesThe splat asset holding the capture: a 3DGS .ply (Scaniverse, offline training; SH degree 0 to 3) or a .splat file.
radianceNitsnumbernoLuminance in cd/m² of a capture colour of 1: the capture's baked light in the scene's units. Default: what the engine makes an unlit colour of 1, so under the none tonemap at exposure 1 the capture shows its own colours. More than 0; anything else draws at the default with a load warning.
visiblebooleannotrueWhether the capture is drawn. Default true.
axesSplatAxesnoy-up, z-up, y-downWhich way is up in the file: "y-up" (default, as stored), "z-up" (photogrammetry, CAD) or "y-down" (COLMAP-trained captures). Applied before the entity's transform.

Rules that can refuse it

  • hd-only-ignored
  • render.hd.splat_format
  • render.hd.splat_too_large
  • render.hd.splat_truncated
  • splat-view-outside

Example

From the contract's tested fixture fixtures/contract/full20/scene.json#wall-north.

{
  "type": "splat",
  "asset": "wall-scan",
  "axes": "z-up"
}