PartDesign SubtractiveTorus

From FreeCAD Documentation
Jump to: navigation, search
Other languages:
Deutsch • ‎English • ‎français • ‎italiano • ‎română • ‎Türkçe

PartDesign SubtractiveTorus.png PartDesign SubtractiveTorus

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


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

introduced in version 0.17

PartDesign SubtractiveTorus example.svg

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

How to use

  1. Press the PartDesign SubtractiveTorus.png Subtractive Torus button. Note: the Subtractive Torus 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 Torus, click on the down arrow besides the visible icon and select Subtractive Torus in the menu.
  2. Set the Primitive parameters and Attachment.
  3. Click OK.
  4. A Torus feature appears under the active Body.


The Torus 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 Attachment.
  • DATALabel: Label given to the Torus object. Change to suit your needs.
  • DATARadius1: Radius of the imaginary orbit around which the circular cross-section revolves. (The distance between the center of the torus and the center of the revolving cross section)
  • DATARadius2: Radius of the circular cross-section defining the form of the torus.
  • DATAAngle1: (labelled V parameter in the Primitive parameters) lower truncation of the torus, parallel to the circular cross section (-180° in a full torus). A bug in the sources causes unexpected results at changing Angle1.
  • DATAAngle2: (unlabelled in the Primitive parameters) upper truncation of the ellipsoid, parallel to the circular cross section (180° in a full torus). A bug in the sources causes unexpected results at changing Angle2.
  • DATAAngle3: (labelled U parameter in the Primitive parameters) angle of rotation of the circular cross section (360° in a full torus).