Documentation / Node reference / geo nodes

geo/Circle

Creates a 2D circle, as points, as a line loop or as a filled disc.

Primitives

Creates a circle, with the point count set by the segments. The type picks what the circle is made of: points, a closed polyline, or a triangulated disc. Turn `open` on to keep only a wedge, from arcStart to arcEnd. Use direction and twist to aim the plane, and center to move the circle within that plane.

If a geometry is connected to the input, the Circle instead fits a bounding disc around that input: the radius and the center come from the data, and the arc params no longer apply.

**The circle is always 2D.** It stores two numbers per point instead of three, so it cannot leave its plane, and its plane is its own object frame: direction, twist and center place the OBJECT rather than baking into the points, which is why there is no transform mode to pick. On screen it sits exactly where a 3D circle would. Put a geo/DimensionPromote after it to get a 3D one, which is what a node that needs to move a single point out of the plane wants.

Parameters

Name Type What it does
type UInt8 POINT · LINE · MESH What the circle is made of: POINT (one point per segment), LINE (a polyline loop) or MESH (a triangulated disc).
radius Float Circle radius.
segments UInt32 Number of segments around the circle. Raise it for a smoother outline.
open Bool Keep only a wedge of the circle, between arcStart and arcEnd, instead of the full turn.
arcStart Float Angle the wedge starts at, in degrees.
arcEnd Float Angle the wedge ends at, in degrees.
direction Vector3 Normal the circle plane faces along.
twist Float Roll about the normal, in degrees. Only affects where the first point sits, so it is mostly useful on an arc.
oriented Bool With an input connected, take the normal from the input itself (its least-variance axis) instead of from direction.
center Vector2 Offset of the circle in its own plane, so it follows direction and twist.

Examples

Scenes you can open in the editor that teach this node.

See also

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.