Connect Points

Turns a point cloud into a line network — plexus webs, nearest-neighbor meshes, Delaunay triangulations, convex hulls, or a single polyline through the points.

Category: Point Ops Menu path: Point Ops > Connect Points

Ports

Port	Type	Direction	Description
points_in	points	input	Points to connect (Grid, PointScatter, PointAdvect, TrackPoints, …)
out	shape	output	The connection network. Each connection is an open two-point path (Sequential: one polyline; Hull: one closed outline). Per-vertex curveu + color; per-path length, index, and opacity (when fade > 0)

Parameters

Param	Type	Default	Description
mode	enum	Nearest	Sequential = one polyline through the points in input order. Nearest = each point links to its neighbors nearest neighbors. Radius = every pair closer than radius links. Delaunay = unique triangulation edges (structured mesh). Hull = one closed convex-hull outline
closed	boolean	false	Sequential mode only: close the polyline back to the first point
neighbors	scalar	3	Nearest mode only: neighbors per point (clamped 1–16)
radius	scalar	150	Radius mode only: maximum connection distance in px
fade	scalar	0	When > 0, writes a per-path opacity attribute that dims longer connections: opacity = 1 − fade · (length / ref). ref = radius in Radius mode, the longest emitted edge otherwise. 0 writes no attribute
maxConnections	scalar	0	Safety cap on the total connection count (0 = unlimited). A hard cap of 20,000 edges always applies. Capping is deterministic — the same first-N edges every frame

Expose Channels

None.

How It Works

Duplicate connections are removed (A→B and B→A are the same edge), and every connection gets its own two fresh vertices — a point that appears in five edges contributes five separate vertex pairs, so downstream per-vertex operations treat each strand independently.

The output is built to compose with the rest of the shape toolbox: per-vertex curveu runs 0 → 1 along each connection (arc-length-normalized along the whole polyline in Sequential/Hull modes), per-path length (px) and index (edge order) are always written, and each endpoint's per-point color attribute (if present) is copied onto the strand's vertices — so DrawShape's per-vertex color pipeline renders smooth gradients between differently-colored points.

Usage Examples

Basic: Plexus web

PointScatter → ConnectPoints (Radius, radius 120, fade 1) → DrawShape (fill off, strokeWidth 1) → Output. Nearby points join into a web whose longest strands fade out. Animate the scatter's seed or advect the points and the web re-forms continuously.

Structured mesh

Grid (Jittered) → ConnectPoints (Delaunay) → DrawShape (fill off). A clean triangulated wireframe over the whole cloud — no duplicate edges, no overdraw.

Creative: Trim-revealed constellation

ConnectPoints (Nearest, 2) → TrimPath (animate end 0 → 1) → DrawShape. Every strand draws on in parallel. Add ShapeAttributes (Custom target, Index source) before the trim and use TrimPath's delay attribute for a staggered cascade.

Tips

• Colors on the input points (via PointAttributes → Color) become per-vertex gradient endpoints on every strand — two differently-colored points produce a blended line between them.
• fade writes standard per-path opacity, which DrawShape's grouped renderer honors directly — no extra wiring.
• The per-path length attribute is plain scalar data: read it downstream (e.g. AttributeToField) to drive stroke width or color by connection length.
• Radius mode is O(n²) over the point count; for dense clouds prefer Nearest or Delaunay, or set maxConnections.
• Sequential + closed is a quick "connect the dots into a loop" — pair with ResampleShape → ShapeSmooth for a smooth blob through the points.

Related Nodes

• CloneToPoints — stamps geometry at points; ConnectPoints draws between them
• LabelPoints — annotate the same point streams with text
• TrimPath — animate the strands drawing on/off
• PointTrail — same open-polyline output conventions, but through time instead of space
• DrawShape — renders the network (per-vertex colors, per-path opacity)