PartDesign SubtractiveSphere

    From FreeCAD Documentation

    PartDesign SubtractiveSphere.svg 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.

    PartDesign SubtractiveSphere example.svg

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


    1. Press the PartDesign SubtractiveSphere.svg 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).