Part Torus/en

Description
The Part Torus command creates a parametric torus solid, a doughnut shape. It is the result of sweeping a circular profile around a circular path. In the coordinate system defined by its property, the circular path of the torus lies on the XY plane with its center at the origin.

A Part Torus can be turned into a segment of a torus by changing its property. By changing its and/or  properties the swept profile can become a segment of a circle.



Usage

 * 1) There are several ways to invoke the command:
 * 2) * Press the button.
 * 3) * Select the option from the menu.
 * 4) The torus is created.
 * 5) Optionally change the dimensions and  of the torus by doing one of the following:
 * 6) * Double-click the object in the Tree view:
 * 7) *# The task panel opens.
 * 8) *# Change one or more properties.
 * 9) *# The object is dynamically updated in the 3D view.
 * 10) *# Press the button.
 * 11) * Change the properties in the Property editor.
 * 12) * Change the with the [[Image:Std_TransformManip.svg|16px]] Std TransformManip command.

Example


A Part Torus object created with the scripting example below is shown here.

Properties
See also: Property editor.

A Part Torus object is derived from a Part Feature object and inherits all its properties. It also has the following additional properties:

Data
The object has the same attachment properties as a Part Part2DObject.


 * : The radius of the circular path of the torus. The default is.
 * : The radius of the circular profile of the torus. The default is.
 * : The start angle of the circular profile. Valid range: . The default is.
 * : The end angle the circular profile. Valid range: . The default is . If the total angle of the circular profile is smaller than the profile will have a pie-shape.
 * : The angle of the circular path of the torus. Valid range: . The default is . If it is smaller than the resulting solid will be a segment of a torus.

Scripting
See also: Autogenerated API documentation, Part scripting and FreeCAD Scripting Basics.

A Part Torus can be created with the method of the document:


 * Where is the name for the object.
 * The function returns the newly created object.

Example: