PartDesign SubtractiveCylinder: Difference between revisions

From FreeCAD Documentation
(Remove the version template, as the version is already indicated in the GuiCommand template)
m (prisms -> cylinders)
 
(14 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:13-->
<!--T:13-->
{{Docnav
{{Docnav|[[PartDesign SubtractiveCone|Subtractive cone]]|[[PartDesign SubtractiveEllipsoid|Subtractive ellipsoid]]|[[PartDesign_Workbench|PartDesign]]|IconL=PartDesign SubtractiveCone.png|IconC=Workbench_PartDesign.svg|IconR=PartDesign SubtractiveEllipsoid.png}}
|[[PartDesign_SubtractiveBox|Subtractive box]]
|[[PartDesign_SubtractiveSphere|Subtractive sphere]]
|[[PartDesign_Workbench|PartDesign]]
|IconL=PartDesign_SubtractiveBox.svg
|IconR=PartDesign_SubtractiveSphere.svg
|IconC=Workbench_PartDesign.svg
}}


<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand
|Name=PartDesign SubtractiveCylinder
|Name=PartDesign SubtractiveCylinder
|Workbenches=[[PartDesign Workbench|PartDesign]]
|MenuLocation=Part Design → Create a subtractive primitive → Subtractive Cylinder
|MenuLocation=Part Design → Create a subtractive primitive → Subtractive Cylinder
|Workbenches=[[PartDesign_Workbench|PartDesign]]
|Version=0.17
|Version=0.17
|SeeAlso=[[PartDesign CompPrimitiveSubtractive]]
|SeeAlso=[[PartDesign_CompPrimitiveSubtractive|PartDesign CompPrimitiveSubtractive]], [[PartDesign AdditiveCylinder|PartDesign_AdditiveCylinder]]
}}
}}


Line 25: Line 33:
''On the left: active body (A) shown in grey and subtractive cylinder (B) shown in transparent red; result on the right.''
''On the left: active body (A) shown in grey and subtractive cylinder (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 SubtractiveCylinder.png|24px]] '''Subtractive Cylinder'''}} button. '''Note''': the Subtractive Cylinder is part of an icon menu labelled ''Create an subtractive primitive''. After launching FreeCAD, the Subtractive Box is the one displayed in the toolbar. To get to the Cylinder button, click on the down arrow besides the visible icon and select Subtractive cylinder in the menu.
# Press the {{Button|[[Image:PartDesign SubtractiveCylinder.svg|24px]] '''Subtractive Cylinder'''}} button. '''Note''': the Subtractive Cylinder is part of an icon menu labelled ''Create an subtractive primitive''. After launching FreeCAD, the Subtractive Box is the one displayed in the toolbar. To get to the Cylinder button, click on the down arrow besides the visible icon and select Subtractive cylinder 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 Cylinder feature appears under the active Body.
# A Cylinder feature appears under the active Body.


==Options== <!--T:9-->
==Options== <!--T:9-->

<!--T:17-->
It is possible to create skewed cylinders by specifying angles in respect to the normal vector of the chosen attachment. {{Version|0.20}}


<!--T:10-->
<!--T:10-->
The Cylinder can be edited after its creation in two ways:
The Cylinder 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 Cylinder object. Change to suit your needs.
* {{PropertyData|Label}}: label given to the Cylinder object. Change to suit your needs.
* {{PropertyData|Radius}}: the radius value of the cylinder.
* {{PropertyData|Radius}}: the radius value of the cylinder.
* {{PropertyData|Angle}}: angle of rotation of the cross section (360 degrees forms a full cylinder).
* {{PropertyData|Angle}}: angle of rotation of the cross section (360 degrees forms a full cylinder).
* {{PropertyData|Height}}: the length of the cylinder along its axis.
* {{PropertyData|Height}}: the height of the cylinder along its axis.
* {{PropertyData|First Angle}}: angle in first direction. {{Version|0.20}}

* {{PropertyData|Second Angle}}: angle in second direction. {{Version|0.20}}




<!--T:14-->
<!--T:14-->
{{Docnav
{{Docnav|[[PartDesign SubtractiveCone|Subtractive cone]]|[[PartDesign SubtractiveEllipsoid|Subtractive ellipsoid]]|[[PartDesign_Workbench|PartDesign]]|IconL=PartDesign SubtractiveCone.png|IconC=Workbench_PartDesign.svg|IconR=PartDesign SubtractiveEllipsoid.png}}
|[[PartDesign_SubtractiveBox|Subtractive box]]

|[[PartDesign_SubtractiveSphere|Subtractive sphere]]
<!--T:15-->
{{PartDesign Tools navi}}
|[[PartDesign_Workbench|PartDesign]]
|IconL=PartDesign_SubtractiveBox.svg

|IconR=PartDesign_SubtractiveSphere.svg
<!--T:16-->
|IconC=Workbench_PartDesign.svg
{{Userdocnavi}}
}}


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

Latest revision as of 09:01, 3 January 2023

PartDesign SubtractiveCylinder

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

Description

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

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

Usage

  1. Press the Subtractive Cylinder button. Note: the Subtractive Cylinder is part of an icon menu labelled Create an subtractive primitive. After launching FreeCAD, the Subtractive Box is the one displayed in the toolbar. To get to the Cylinder button, click on the down arrow besides the visible icon and select Subtractive cylinder in the menu.
  2. Set the Primitive parameters and Attachment.
  3. Click OK.
  4. A Cylinder feature appears under the active Body.

Options

It is possible to create skewed cylinders by specifying angles in respect to the normal vector of the chosen attachment. introduced in version 0.20

The Cylinder 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 Cylinder object. Change to suit your needs.
  • DataRadius: the radius value of the cylinder.
  • DataAngle: angle of rotation of the cross section (360 degrees forms a full cylinder).
  • DataHeight: the height of the cylinder along its axis.
  • DataFirst Angle: angle in first direction. introduced in version 0.20
  • DataSecond Angle: angle in second direction. introduced in version 0.20