PartDesign SubtractiveTorus: Difference between revisions

From FreeCAD Documentation
(Added Properties.)
m (Button template)
 
(19 intermediate revisions by 9 users not shown)
Line 1: Line 1:
<languages/>
<translate>
<translate>

<!--T:13-->
{{Docnav
|[[PartDesign_SubtractiveEllipsoid|Subtractive ellipsoid]]
|‎[[PartDesign_SubtractivePrism|Subtractive prism]]
|[[PartDesign_Workbench|PartDesign]]
|IconL=PartDesign_SubtractiveEllipsoid.svg
|IconR=PartDesign_SubtractivePrism.svg
|IconC=Workbench_PartDesign.svg
}}

<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand|Name=PartDesign SubtractiveTorus|Workbenches=[[PartDesign Workbench|PartDesign]]|MenuLocation=Part Design → Create a subtractive primitive → Subtractive Torus|Shortcut=None|SeeAlso=[[PartDesign CompPrimitiveSubtractive]]}}
|Name=PartDesign SubtractiveTorus
|MenuLocation=Part Design → Create a subtractive primitive → Subtractive Torus
|Workbenches=[[PartDesign_Workbench|PartDesign]]
|Version=0.17
|SeeAlso=[[PartDesign_CompPrimitiveSubtractive|PartDesign CompPrimitiveSubtractive]], [[PartDesign_AdditiveTorus|PartDesign AdditiveTorus]]
}}


==Description== <!--T:2-->
==Description== <!--T:2-->
Line 8: Line 26:
Inserts a subtractive torus in the active Body. Its shape is subtracted from the existing solid.
Inserts a subtractive torus in the active Body. Its shape is subtracted from the existing solid.


</translate>
<!--T:4-->
{{Version|0.17}}

<!--T:5-->
[[File:PartDesign_SubtractiveTorus_example.svg|none]]
[[File:PartDesign_SubtractiveTorus_example.svg|none]]
<translate>

<!--T:6-->
<!--T:6-->
''On the left: active body (A) shown in grey and subtractive torus (B) shown in transparent red; result on the right.''
''On the left: active body (A) shown in grey and subtractive torus (B) shown in transparent red; result on the right.''


==How to use== <!--T:7-->
==Usage== <!--T:7-->


<!--T:8-->
<!--T:8-->
# Press the {{KEY|[[Image:PartDesign SubtractiveTorus.png|24px]] '''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.
# Press the {{Button|[[Image:PartDesign SubtractiveTorus.svg|24px]] '''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.
# Set the Primitive parameters and [[Part_Attachment|Attachment]].
# Set the Primitive parameters and [[Part_EditAttachment|Attachment]].
# Click {{KEY|OK}}.
# Click {{Button|OK}}.
# A Torus feature appears under the active Body.
# A Torus feature appears under the active Body.


Line 30: Line 45:
The Torus can be edited after its creation in two ways:
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.
* 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]].
* Via the [[Property_editor|Property editor]].


==Properties== <!--T:11-->
==Properties== <!--T:11-->


<!--T:12-->
<!--T:12-->
* {{PropertyData|Attachment}}: defines the attachment mode as well as the Attachment Offset. See [[Part_EditAttachment|Part EditAttachment]].
A torus can be assimilated to a small disc that makes a circular orbit around an imaginary axis. Thus the torus is defined by the following properties:
* {{PropertyData|Radius1:}} Radius of the circle around which the disc circulates.
* {{PropertyData|Label}}: Label given to the Torus object. Change to suit your needs.
* {{PropertyData|Radius2:}} Radius of the disc defining the form of the torus.
* {{PropertyData|Radius1}}: 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)
* {{PropertyData|Angle1:}} 1st angle to cut / define the disc of the torus.
* {{PropertyData|Radius2}}: Radius of the circular cross-section defining the form of the torus.
* {{PropertyData|Angle1}}: (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.
* {{PropertyData|Angle2:}} 2nd angle to cut / define the disc of the torus.
* {{PropertyData|Angle2}}: (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.
* {{PropertyData|Angle3:}} 3rd angle to define the circumference of the torus.
* {{PropertyData|Angle3}}: (labelled ''U parameter'' in the Primitive parameters) angle of rotation of the circular cross section (360° in a full torus).



<!--T:14-->
{{Docnav
|[[PartDesign_SubtractiveEllipsoid|Subtractive ellipsoid]]
|‎[[PartDesign_SubtractivePrism|Subtractive prism]]
|[[PartDesign_Workbench|PartDesign]]
|IconL=PartDesign_SubtractiveEllipsoid.svg
|IconR=PartDesign_SubtractivePrism.svg
|IconC=Workbench_PartDesign.svg
}}


</translate>
</translate>
{{PartDesign_Tools_navi{{#translation:}}}}
{{clear}}
{{Userdocnavi{{#translation:}}}}
<languages/>

Latest revision as of 11:56, 11 April 2022

PartDesign SubtractiveTorus

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

Description

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

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

Usage

  1. Press the 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.

Options

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.

Properties

  • DataAttachment: defines the attachment mode as well as the Attachment Offset. See Part EditAttachment.
  • 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).