splat
Since 0.6
Use it in a scene entity's components list as { "type": "splat", … }. The contract writes the fields flat and refuses unknown keys.
Fields
| Field | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
asset | string | yes | The splat asset holding the capture: a 3DGS .ply (Scaniverse, offline training; SH degree 0 to 3) or a .splat file. | ||
radianceNits | number | no | Luminance 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. | ||
visible | boolean | no | true | Whether the capture is drawn. Default true. | |
axes | SplatAxes | no | y-up, z-up, y-down | Which 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-ignoredrender.hd.splat_formatrender.hd.splat_too_largerender.hd.splat_truncatedsplat-view-outside
Example
From the contract's tested fixture fixtures/contract/full20/scene.json#wall-north.
{
"type": "splat",
"asset": "wall-scan",
"axes": "z-up"
}