Nodes · 3D
SplatFx
3Dv1app
Overview
Direct a splat capture with a field over its splats — crop, dissolve, warp, shade, or matte through a camera. This is the difference between a viewer and a compositor.
How to
- Chain one SplatFx per effect; each appends to the set.
- Use a region (box or sphere) to hit one object rather than the whole scene.
- For
matte, project a 2D branch through a camera and dissolve what it covers.
Inputs
| Input | What it takes |
|---|---|
| in | the image this node works on |
Outputs
| Output | Type |
|---|---|
| out | Scene |
Parameters
| Parameter | Type | Default | What it does |
|---|---|---|---|
| tx | Float | 0.0 | Translate X — position along the world X axis, metres. |
| ty | Float | 0.0 | Translate Y — position along the world Y axis (up), metres. |
| tz | Float | 0.0 | Translate Z — position along the world Z axis, metres. The camera looks down −Z. |
| rx | Float | 0.0 | Rotate around X, degrees. |
| ry | Float | 0.0 | Rotate around Y (turntable), degrees. |
| rz | Float | 0.0 | Rotate around Z (roll), degrees. |
| sx | Float | 1.0 | Scale along X. 1 = unchanged. |
| sy | Float | 1.0 | Scale along Y. |
| sz | Float | 1.0 | Scale along Z. |
| kind | Choice | crop | Which effect this node appends to the splat chain: crop cuts splats away by a box or sphere, dissolve fades them by a field, warp displaces them by a field, shade grades them by a field, matte keeps only what a 2D matte sees through the camera. cropdissolvewarpshadematte |
| crop_shape | Choice | box | Crop by a box (min/max corners) or a sphere (centre + radius). boxsphere |
| crop_min_x | Float | -1.0 | Crop box: the X of the near corner, world units. |
| crop_min_y | Float | -1.0 | Crop box: the Y of the near corner, world units. |
| crop_min_z | Float | -1.0 | Crop box: the Z of the near corner, world units. |
| crop_max_x | Float | 1.0 | Crop box: the X of the far corner, world units. |
| crop_max_y | Float | 1.0 | Crop box: the Y of the far corner, world units. |
| crop_max_z | Float | 1.0 | Crop box: the Z of the far corner, world units. |
| crop_center_x | Float | 0.0 | Crop sphere: the X of its centre, world units. |
| crop_center_y | Float | 0.0 | Crop sphere: the Y of its centre, world units. |
| crop_center_z | Float | 0.0 | Crop sphere: the Z of its centre, world units. |
| crop_radius | Float | 1.0 | Crop sphere: its radius, world units. |
| crop_feather | Float | 0.0 | Soften the crop's edge over this distance instead of cutting hard — splats fade out across it. |
| crop_invert | Bool | false | Keep the OUTSIDE of the shape and cut the inside. |
| field | Choice | noise | What drives a dissolve, warp or shade per splat: noise (3D fbm at the splat's position), distance (from a centre, out to a radius), or axis (the splat's coordinate along one axis, field_from to field_to). noisedistanceaxis |
| field_scale | Float | 1.0 | The noise field's feature size, world units — small is a fine sizzle, large is slow lobes. |
| field_seed | Int | 1 | The noise field's seed. Change it for a different pattern with the same statistics. |
| field_center_x | Float | 0.0 | Distance field: the X of its centre, world units. |
| field_center_y | Float | 0.0 | Distance field: the Y of its centre, world units. |
| field_center_z | Float | 0.0 | Distance field: the Z of its centre, world units. |
| field_radius | Float | 1.0 | Distance field: the field runs 0 at the centre to 1 at this radius. |
| field_axis | Int | 1 | Axis field: which axis to read — 0 = X, 1 = Y, 2 = Z. |
| field_from | Float | 0.0 | Axis field: the coordinate where the field is 0. |
| field_to | Float | 1.0 | Axis field: the coordinate where the field is 1 — a wipe travels by animating this pair. |
| amount | Float | 1.0 | Strength of the effect. 1 = as designed; 0 = none. |
| shrink | Bool | false | Dissolve: shrink splats as they fade instead of only fading their opacity — they read as evaporating rather than ghosting. |
| tint | Color | [1.0, 1.0, 1.0, 1.0] | Shade: the colour multiplied in where the field is 1. |
| gamma | Float | 1.0 | Shade: a gamma applied where the field is 1 — under 1 brightens, over 1 darkens. |
| matte | Text | Matte kind: the NAME of a 2D node whose alpha, seen through camera, decides which splats stay — paint a roto on the plate and keep only what it covers. | |
| camera | Text | The Camera3D the matte is projected through. Empty uses the scene's default camera. | |
| region | Choice | off | Limit a dissolve, warp or shade to a region: off is the whole set, box or sphere the shape below. Splats outside the region are untouched. offboxsphere |
| region_min_x | Float | -1.0 | Region box: the X of the near corner, world units. |
| region_min_y | Float | -1.0 | Region box: the Y of the near corner, world units. |
| region_min_z | Float | -1.0 | Region box: the Z of the near corner, world units. |
| region_max_x | Float | 1.0 | Region box: the X of the far corner, world units. |
| region_max_y | Float | 1.0 | Region box: the Y of the far corner, world units. |
| region_max_z | Float | 1.0 | Region box: the Z of the far corner, world units. |
| region_center_x | Float | 0.0 | Region sphere: the X of its centre, world units. |
| region_center_y | Float | 0.0 | Region sphere: the Y of its centre, world units. |
| region_center_z | Float | 0.0 | Region sphere: the Z of its centre, world units. |
| region_radius | Float | 1.0 | Region sphere: its radius, world units. |
| disabled | Bool | false | Bypass: the node passes its first input through untouched (D in the graph). The knobs keep their values for when it comes back. |
| label | Text | A note shown under the node in the graph — what this node is FOR. Never affects the render or the cache. | |
| hide_input | Bool | false | Draw the node without its input wire — a tidy graph for a node whose source is obvious (a Dot, a viewer tap). |
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.