Documentation / Node reference / geo nodes
Removes points, primitives or objects that match one or more criteria.
Topology
Pick what is being removed with `entity`, then turn on one or more `by*` criteria; `combineMode` decides whether they union or intersect, and `invert` deletes everything they did NOT match. Nothing is copied that does not have to be: an object that loses no entity is forwarded untouched, one that loses some is rebuilt from its survivors. The bounding rules are in WORLD space, so an object placed by a geo/Transform in OBJECT mode upstream is tested where it stands; the expression and normal rules read the geometry as stored and are not turned by that transform.
| Name | Type | What it does |
|---|---|---|
| entity | UInt8 POINT · PRIMITIVE · OBJECT · STAGE | What is being deleted: points, primitives or objects. |
| invert | Bool | Delete everything the criteria did NOT match. |
| keepUnreferencedPoints | Bool | PRIMITIVE mode only: keep the points the surviving primitives no longer use, unreferenced, instead of dropping them with the primitives that owned them. |
| combineMode | UInt8 OR · AND | How several active criteria combine: OR takes the union, AND the intersection. |
| group | String | Restrict the deletion to a group. Only entities in it may be deleted; an OBJECT group restricts which objects may be. Empty = anything may be. |
| byRange | Bool | Delete a repeating slice of the entities. |
| range | Vector2UInt | First number = how many to take, second = how often. So 1 and 3 takes every third entity, 2 and 5 takes the first two of every five. This is a repeating step, not a from-to range. |
| byExpression | Bool | Delete with an expression evaluated per entity. |
| expression | Bool | A true/false expression run on each entity, e.g. `attrib(.P).y > 0`. True means deleted. `attrib(.P)` is the point exactly as stored, with no object transform applied. |
| byBoundingBox | Bool | Delete what falls inside a box. |
| boundingBoxMin | Vector3 | Lower corner of the box, in world space. |
| boundingBoxMax | Vector3 | Upper corner of the box, in world space. |
| byBoundingObject | Bool | Delete what falls inside the shape plugged into input 1. Triangle meshes use a real inside test; anything else uses its bounding box. |
| byNormal | Bool | Delete primitives facing a given direction, read off the geometry as stored. |
| normal | Vector3 | The direction to face, in the geometry's own frame. An object transform upstream does not turn it. |
| angle | Float | How far a primitive may point away from that direction and still count, in degrees. |
| byArea | Bool | Delete primitives by their area. |
| areaMode | UInt8 SMALLER · LARGER | Delete the primitives SMALLER or LARGER than the threshold. |
| area | Float | The area threshold. |
| byName | Bool | Delete objects by name. |
| name | String | Object names to match. `*` and `?` are wildcards, `^name` excludes, e.g. `box* ^boxTemp`. A plain name matches exactly. |
| byGeometryType | Bool | Delete objects by what kind of geometry they hold. |
| geometryType | UInt8 UNDEFINED · POINT · SEGMENT · TRIANGLE · QUAD · TETRAHEDRON · HEXA · MANIFOLD_2D · MANIFOLD_3D · CAD_SHAPE · VOLUME · NURBS_CURVE · NURBS_SURFACE · BREP · VOXEL · SDF_3D · SDF_2D | The geometry kind to match. |
Scenes you can open in the editor that teach this node.
A ball, a T and a cube on its edge, measured for the faces a 3D printer cannot build without support, and shown four ways: how far each face leans, how bad each region is, which region each face is in, and the surfaces a support would hold up.
geo/PrintOverhangMeasure geo/AttributePromote geo/AttributeDisplay geo/Delete
This page is generated from the engine, so it describes the release you can download. The same text is in the editor's Help panel next to the node itself.
