PartDesign SubtractiveTorus: Difference between revisions

From FreeCAD Documentation
m (More clearly definition of Radius1, added remark about bug at changing Angle1 and Angle2.)
m (Button template)
 
(14 intermediate revisions by 8 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 7: Line 25:
<!--T:3-->
<!--T:3-->
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.

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


</translate>
</translate>
Line 17: Line 32:
''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 Attachment]].
* {{PropertyData|Attachment}}: defines the attachment mode as well as the Attachment Offset. See [[Part_EditAttachment|Part EditAttachment]].
* {{PropertyData|Label}}: Label given to the Torus object. Change to suit your needs.
* {{PropertyData|Label}}: Label given to the Torus object. Change to suit your needs.
* {{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|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)
Line 43: Line 58:
* {{PropertyData|Angle3}}: (labelled ''U parameter'' in the Primitive parameters) angle of rotation of the circular cross section (360° in a full 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).