Parameters
The Split node acts as a filter for your geometry stream. It allows you to isolate specific shapes or points based on a Group pattern and discard the rest.
Unlike Separate Shapes, which explodes a single shape into multiple nodes, the Split node is designed to handle streams containing multiple distinct objects (e.g., from a Merge node or a Scatter result).
Parameters
| Parameter | Description |
|---|---|
Label | The display name for the node. |
Group | Subset of the input geometry to split. Supports patterns. |
Group Type | The type of entities to split. |
Invert Selection | Negates the sense of the selection. |
Discard Geometry | If enabled, removes lines/faces and keeps only the points (Point Cloud). |
Delete Unused Groups | Remove any groups that are left empty after splitting. |
Usage
Filtering Shapes
By default, the Split node operates in Shape mode. This is useful for processing specific parts of a complex composition differently.
- Connect a stream containing multiple shapes (e.g., from a Merge node).
- Enter the name of the shape(s) you want to keep in the Group field. You can use wildcards (e.g.,
Star*). - The node outputs only the matching shapes.
Splitting Flow
To separate a stream into two distinct branches (A and B), use two Split nodes:
- Branch A: Use a Split node selecting
Group A. - Branch B: Use a Split node selecting
Group Awith Invert Selection enabled.
Filtering Points
When set to Points, the node filters the vertices of the input geometry.
- The result is returned as a Point Cloud, destroying the original topology (path connectivity).
- This is useful for isolating specific points for instancing (e.g., “Keep only points on the left side”).