Primitive Sphere

Status: Implemented

Primitive Sphere builds an exact analytic sphere centred on the origin, with its polar axis along +Y.

Walkthrough

Recorded from the running app by BREP_mcp/tests/videos/primitive-sphere.json; regenerate every walkthrough with ./build.sh docs-videos.

Inputs

• id (string, default null) – names the history entry, the solid and its face.
• radius (number, default 5) – sphere radius. Taken as a magnitude, so a negative value behaves as positive.
• transform (transform, default position [0, 0, 0], rotation [0, 0, 0], scale [1, 1, 1]) – placement baked into the solid before the boolean; the face keeps its name.
• boolean (boolean_operation, default operation NONE with no targets and mergeCoplanarFaces: true) – optional union / subtract / intersect after creation.

Behaviour

• A sphere is a single analytic face. Both the solid and that one face are named {id}.
• Never offered by the selection context bar — it takes no references.

Limitations

• The radius magnitude must exceed the kernel's geometric epsilon.