PartDesign SubtractiveSphere

From FreeCAD Documentation
Revision as of 13:41, 2 September 2022 by Evgeniy (talk | contribs) (ellipsoid -> sphere)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

PartDesign SubtractiveSphere

Menu location
Part Design → Create a subtractive primitive → Subtractive Sphere
Default shortcut
Introduced in version
See also
PartDesign CompPrimitiveSubtractive, PartDesign AdditiveSphere


Inserts a subtractive sphere in the active Body. Its shape is subtracted from the existing solid.

On the left: active body (A) shown in grey and subtractive sphere (B) shown in transparent red; result on the right.


  1. Press the Subtractive Sphere button. Note: the Subtractive Sphere is part of an icon menu labelled Create an additive primitive. After launching FreeCAD, the Subtractive Box is the one displayed in the toolbar. To get the Sphere, click on the down arrow besides the visible icon and select Subtractive Sphere in the menu.
  2. Set the Primitive parameters and Attachment.
  3. Click OK.
  4. A Sphere feature appears under the active Body.


The Sphere can be edited after its creation in two ways:

  • Double-clicking it in the Model tree, or by right-clicking and selecting Edit primitive in the contextual menu; this brings up the Primitive parameters.
  • Via the Property editor.


  • DataAttachment: defines the attachment mode as well as the Attachment Offset. See Part EditAttachment.
  • DataLabel: Label given to the Sphere object. Change to suit your needs.
  • DataRadius: Radius of the sphere.
  • DataAngle1: (labelled V parameter in the Primitive parameters) lower truncation of the sphere, parallel to the circular cross section (-90 degrees in a full sphere)
  • DataAngle2: (unlabelled in the Primitive parameters) upper truncation of the sphere, parallel to the circular cross section (90 degrees in a full sphere).
  • DataAngle3: (labelled U parameter in the Primitive parameters) angle of rotation of the cross section (360 degrees in a full sphere).