PartDesign Revolution/en: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
(16 intermediate revisions by the same user not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand|Name=PartDesign Revolution|Workbenches=[[PartDesign Workbench|PartDesign]], Complete|MenuLocation=PartDesign → Revolution}}

{{Docnav
|[[PartDesign_Pad|Pad]]
|[[PartDesign_AdditiveLoft|Additive loft]]
|[[PartDesign_Workbench|PartDesign]]
|IconL=PartDesign_Pad.svg
|IconR=PartDesign_AdditiveLoft.svg
|IconC=Workbench_PartDesign.svg
}}

{{GuiCommand
|Name=PartDesign Revolution
|MenuLocation=Part Design → Create an additive feature → Revolution
|Workbenches=[[PartDesign_Workbench|PartDesign]]
|SeeAlso=[[PartDesign_Groove|PartDesign Groove]]
}}

==Description==


==Introduction==
The '''Revolution''' tool creates a solid by revolving a selected sketch or 2D object about a given axis.
The '''Revolution''' tool creates a solid by revolving a selected sketch or 2D object about a given axis.
[[File:PartDesign Revolution example.svg|none]]
''Above: sketch (A) is revolved 270 degrees counterclockwise around axis (B); resulting solid (C) is shown right.''


[[File:PartDesign Revolution example.svg]]
==How to use==
{{Caption|Above: sketch (A) is revolved 270 degrees counter-clockwise around axis (B); resulting solid (C) is shown right.}}

==Usage==


# Select the sketch to be revolved. <span style="font-size:x-small;color:green;">v0.17 and above</span> A face on the existing solid can alternatively be used.
# Select the sketch to be revolved. <span style="font-size:x-small;color:green;">v0.17 and above</span> A face on the existing solid can alternatively be used.
# Press the {{KEY|[[Image:PartDesign_Pad.png|24px]] '''Pad'''}} button.
# Press the {{Button|[[Image:PartDesign_Revolution.svg|24px]] '''Revolution'''}} button.
# Set the Revolution parameters (see next section).
# Set the Revolution parameters (see next section).
# Click OK.
# Press {{Button|OK}}.


==Options==
==Options==

When creating a revolution, the 'revolution parameters' dialogue offers several parameters specifying how the sketch should be revolved.
When creating a revolution, the '''Revolution parameters''' dialogue offers several parameters specifying how the sketch should be revolved.


{|
{|
| [[Image:partdesign_revolution_parameters.png|left]]
| [[Image:partdesign_revolution_parameters.png|left]]
|
|

===Axis===
===Axis===

This option specifies the axis about which the sketch is to be revolved. Currently, by default only the horizontal or vertical sketch axis can be selected here. However if the sketch which defines the feature to be Revolved also contains a construction line (or lines), then the drop down list will contain one custom sketch axis for each construction line. The first construction line will be labelled 'Sketch axis 0'. After creation an arbitrary axis can be defined in the Properties table. Base is a point through which the axis goes. The axis option itself takes three arguments, which are passed as numbers to either the x, y, or z boxes in the tool. Adding a value of 1.0 to only one of the boxes will cause the tool to make the revolution about that axis. Example revolutions 1, 2 and 3 in the [[#Examples|examples]] section demonstrate scenarios where the example sketch is revolved about either the x or the y axis.
This option specifies the axis about which the sketch is to be revolved.
Adding a non-zero value to more than one of the axes will cause the part to be revolved by a weighted amount in each axis. e.g. an x value of 1 and a y value of 2 will mean that the revolution about the y-axis is twice as strong as that about the x. This is fairly difficult to comprehend, Example Revolution 4 shows an example where more than one of the boxes has a non-zero value.
* '''Vertical sketch axis''': selects the vertical sketch axis.
===Angle===
* '''Horizontal sketch axis''': selects the horizontal sketch axis.
* '''Sketch axis''': <span style="font-size:x-small;color:blue;">v0.16 and below</span> selects a construction line contained in the sketch used by the Revolution. The first construction line created in the sketch will be labelled ''Sketch axis 0''. The drop down list will contain one custom sketch axis for each construction line.
* '''Construction line''': <span style="font-size:x-small;color:green;">v0.17 and above</span> selects a construction line contained in the sketch used by the Revolution. The drop down list will contain an entry for each construction line. The first construction line created in the sketch will be labelled ''Construction line 1''.
* '''Base (X/Y/Z) axis''': <span style="font-size:x-small;color:green;">v0.17 and above</span> selects the X, Y or Z axis of the Body's Origin;
* '''Select reference...''': <span style="font-size:x-small;color:green;">v0.17 and above</span> allows selection in the 3D view of an edge on the Body, or a [[PartDesign Line|datum line]].

===Angle===

This controls the angle through which the revolution is to be formed, e.g. 360° would be a full, contiguous revolution.
This controls the angle through which the revolution is to be formed, e.g. 360° would be a full, contiguous revolution.
The images in the [[#Examples|examples]] section demonstrate some of the possibilities with specifying different angles. It is not possible to specify negative angles (use the '''Reversed''' option instead) or angles greater than 360°.
The images in the [[#Examples|examples]] section demonstrate some of the possibilities with specifying different angles. It is not possible to specify negative angles (use the '''Reversed''' option instead) or angles greater than 360°.

===Symmetric to plane===
===Symmetric to plane===

If checked, the revolution will extend half of the specified angle in both directions from the sketch plane.
If checked, the revolution will extend half of the specified angle in both directions from the sketch plane.

===Reversed===
===Reversed===

If checked, the direction of revolution is reversed from default clockwise to counterclockwise.
If checked, the direction of revolution is reversed from default clockwise to counterclockwise.
|}
|}
{{clear}}


==Properties ==


Below are properties which can be defined after creation of the feature. Data properties ''Base'' and ''Axis'' are uneditable.
==Examples==


* {{PropertyData|Angle}}: angle of rotation. See [[#Angle|Angle]].
[[Image:PartDesign_Revolution_axis_fromconstructionlines1.jpg|frame|left|Example revolution using a construction line as the Revolution axis: In this image the angle is 75°, revolution is about the construction line (Sketch axis 0)]]
* {{PropertyData|Label}}: label given to the operation, can be changed at convenience.
{{clear}}
* {{PropertyData|Midplane}}: true or false. See [[#Symmetric to plane|Symmetric to plane]].
* {{PropertyData|Reversed}}: true or false. See [[#Reversed|Reversed]].
* {{PropertyData|Refine}}: <span style="font-size:x-small;color:green;">v0.17 and above</span> true or false. If set to true, cleans the solid from residual edges left by features. See [[Part RefineShape]] for more details.


==Examples==
For all the following examples of this command, the example sketch below will be used:
[[Image:complex_sketch.png|frame|left|Example sketch: A complex sketch with many constraints. Sketch is oriented in the x-y plane, with x being the horizontal axis, and y being the vertical axis (shown in image as the two blue lines). Other important things to note about this sketch is that it are mirrored about the y axis and that the base of it is coincident with the x axis.]]
{{clear}}


[[Image:PartDesign_Revolution_axis_fromconstructionlines1.jpg|frame|none|Example revolution using a construction line as the Revolution axis: In this image the angle is 75°, revolution is about the construction line (Sketch axis 0).]]
Note: Unlike the above, all these examples below refer to Base, Axis and Placement being edited directly through the feature properties table.
[[Image:revolve3_cropped.png|frame|left|Example revolution 1: In this image the angle has been set to 70°, revolution is about the x-axis and there is a y-offset of 100mm. The sketch is the face not shown in the image (i.e. the 'back' face).]]
[[Image:revolve5_cropped.png|frame|left|Example revolution 2: In this image the angle is 70°, revolution is about the y-axis and there is a y-offset of 100mm.]]
[[Image:revolve7_cropped.png|frame|left|Example revolution 3: In this image the angle is 270°, revolution is about the x-axis and there are 0 offsets]]
[[Image:revolve8_cropped.png|frame|left|Example revolution 4: In this image the angle is 270°, revolution is about the x-axis (value 1.00) and the y-axis (value 2.00) and there is a y-offset of 100mm]]
{{clear}}


==Useful links==
==Useful links==
An [http://forum.freecadweb.org/viewtopic.php?f=3&t=3674 example] with the practice on the forum.


A [http://forum.freecadweb.org/viewtopic.php?f=3&t=3674 detailed example of use] on the forum.
<languages/>


{{Docnav
|[[PartDesign_Pad|Pad]]
|[[PartDesign_AdditiveLoft|Additive loft]]
|[[PartDesign_Workbench|PartDesign]]
|IconL=PartDesign_Pad.svg
|IconR=PartDesign_AdditiveLoft.svg
|IconC=Workbench_PartDesign.svg
}}

{{PartDesign Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Revision as of 11:21, 11 April 2022

PartDesign Revolution

Menu location
Part Design → Create an additive feature → Revolution
Workbenches
PartDesign
Default shortcut
None
Introduced in version
-
See also
PartDesign Groove

Description

The Revolution tool creates a solid by revolving a selected sketch or 2D object about a given axis.

Above: sketch (A) is revolved 270 degrees counter-clockwise around axis (B); resulting solid (C) is shown right.

Usage

  1. Select the sketch to be revolved. v0.17 and above A face on the existing solid can alternatively be used.
  2. Press the Revolution button.
  3. Set the Revolution parameters (see next section).
  4. Press OK.

Options

When creating a revolution, the Revolution parameters dialogue offers several parameters specifying how the sketch should be revolved.

Axis

This option specifies the axis about which the sketch is to be revolved.

  • Vertical sketch axis: selects the vertical sketch axis.
  • Horizontal sketch axis: selects the horizontal sketch axis.
  • Sketch axis: v0.16 and below selects a construction line contained in the sketch used by the Revolution. The first construction line created in the sketch will be labelled Sketch axis 0. The drop down list will contain one custom sketch axis for each construction line.
  • Construction line: v0.17 and above selects a construction line contained in the sketch used by the Revolution. The drop down list will contain an entry for each construction line. The first construction line created in the sketch will be labelled Construction line 1.
  • Base (X/Y/Z) axis: v0.17 and above selects the X, Y or Z axis of the Body's Origin;
  • Select reference...: v0.17 and above allows selection in the 3D view of an edge on the Body, or a datum line.

Angle

This controls the angle through which the revolution is to be formed, e.g. 360° would be a full, contiguous revolution. The images in the examples section demonstrate some of the possibilities with specifying different angles. It is not possible to specify negative angles (use the Reversed option instead) or angles greater than 360°.

Symmetric to plane

If checked, the revolution will extend half of the specified angle in both directions from the sketch plane.

Reversed

If checked, the direction of revolution is reversed from default clockwise to counterclockwise.

Properties

Below are properties which can be defined after creation of the feature. Data properties Base and Axis are uneditable.

  • DataAngle: angle of rotation. See Angle.
  • DataLabel: label given to the operation, can be changed at convenience.
  • DataMidplane: true or false. See Symmetric to plane.
  • DataReversed: true or false. See Reversed.
  • DataRefine: v0.17 and above true or false. If set to true, cleans the solid from residual edges left by features. See Part RefineShape for more details.

Examples

Example revolution using a construction line as the Revolution axis: In this image the angle is 75°, revolution is about the construction line (Sketch axis 0).

Useful links

A detailed example of use on the forum.