PartDesign Revolution: Difference between revisions

From FreeCAD Documentation
m (Button template)
(V0.22 -> V1.0)
 
(25 intermediate revisions by 2 users not shown)
Line 28: Line 28:
[[File:PartDesign Revolution example.svg]]
[[File:PartDesign Revolution example.svg]]
<translate>
<translate>

<!--T:11-->
<!--T:11-->
{{Caption|Above: sketch (A) is revolved 270 degrees counter-clockwise around axis (B); resulting solid (C) is shown right.}}
{{Caption|Above: sketch (A) is revolved 270 degrees counter-clockwise around axis (B); resulting solid (C) is shown right.}}
Line 34: Line 35:


<!--T:13-->
<!--T:13-->
# Select a single sketch or one or more faces from the Body.
# 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 {{Button|[[Image:PartDesign_Revolution.svg|24px]] '''Revolution'''}} button.
# Press the {{Button|[[Image:PartDesign_Revolution.svg|24px]] [[PartDesign_Revolution|Revolution]]}} button.
# Set the Revolution parameters (see next section).
# Set the Revolution parameters, see [[#Options|Options]] below.
# Press {{Button|OK}}.
# Press the {{Button|OK}} button.


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


<!--T:2-->
<!--T:2-->
When creating a revolution, the '''Revolution parameters''' dialogue offers several parameters specifying how the sketch should be revolved.
When creating a revolution, or after double-clicking an existing revolution in the [[Tree_view|Tree view]], the '''Revolution parameters''' task panel is shown. It offers the following settings:


<!--T:25-->
<!--T:25-->
[[Image:partdesign_revolution_parameters.png|frame|left]]
{|

| [[Image:partdesign_revolution_parameters.png|left]]
===Type=== <!--T:35-->
|

<!--T:36-->
{{Version|1.0}}

<!--T:37-->
Type offers five different ways of specifying the angle of the revolution:

====Dimension==== <!--T:38-->

<!--T:39-->
Enter a numeric value for the '''Angle''' of the revolution. With the option '''Symmetric to plane''' the revolution will extend half the given angle to either side of the sketch or face.

====To last==== <!--T:40-->

<!--T:41-->
The revolution will extend up to the last face of the support it encounters in its direction. If there is no support, an error message will appear.

====To first==== <!--T:42-->

<!--T:43-->
The revolution will extend up to the first face of the support it encounters in its direction. If there is no support, an error message will appear.

====Up to face==== <!--T:44-->

<!--T:45-->
The revolution will extend up to a face. Press the {{Button|Face}} button and select a face or a [[PartDesign_Plane|datum plane]] from the Body.

====Two dimensions==== <!--T:46-->

<!--T:47-->
This allows to enter a second angle in which the revolution should extend in the opposite direction. The directions can be switched by checking the '''Reversed''' option.


===Axis=== <!--T:26-->
===Axis=== <!--T:26-->

<!--T:48-->
Specifies the axis of the revolution:


<!--T:10-->
<!--T:10-->
This option specifies the axis about which the sketch is to be revolved.
* '''Vertical sketch axis''': selects the vertical sketch axis.
* '''Vertical sketch axis''': selects the vertical sketch axis.
* '''Horizontal sketch axis''': selects the horizontal sketch axis.
* '''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''': selects a construction line from the sketch used by the revolution. The dropdown list will contain an entry for each construction line. The first construction line will be labelled ''Construction line 1''.
* '''Base (X/Y/Z) axis''': selects the X, Y or Z axis of the Body's origin.
* '''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''.
* '''Select reference...''': allows the selection of a straight edge or a [[PartDesign_Line|datum line]] from the Body.
* '''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]].
<!--T:49-->
Note that when changing the axis, the '''Reversed''' option may be (un)checked automatically.


===Angle=== <!--T:27-->
===Angle=== <!--T:27-->


<!--T:15-->
<!--T:15-->
Defines the angle of the revolution. This option is only available if '''Type''' is '''Dimension''' or '''Two dimensions'''. Angles larger than 360° are not possible. Nor are negative values, use the '''Reversed''' option instead.
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°.


===Symmetric to plane=== <!--T:28-->
===Symmetric to plane=== <!--T:28-->


<!--T:29-->
<!--T:29-->
If checked, the revolution will extend half of the specified angle in both directions from the sketch plane.
Check this option to extend the revolution half the given angle to either side of the sketch or face. This option is only available if '''Type''' is '''Dimension'''.


===Reversed=== <!--T:30-->
===Reversed=== <!--T:30-->


<!--T:31-->
<!--T:31-->
If checked, the direction of revolution is reversed from default clockwise to counterclockwise.
Reverses the direction of the revolution.

|}
===2nd angle=== <!--T:50-->

<!--T:51-->
{{Version|1.0}}

<!--T:52-->
Defines the angle of the revolution in the opposite direction. This option is only available if '''Type''' is '''Two dimensions''' and '''Angle''' is smaller than 360°.

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

===Data=== <!--T:53-->

<!--T:54-->
{{TitleProperty|Part Design}}


==Properties == <!--T:16-->
<!--T:55-->
* {{PropertyData|Refine|Bool}}


<!--T:17-->
<!--T:56-->
{{TitleProperty|Revolution}}
Below are properties which can be defined after creation of the feature. Data properties ''Base'' and ''Axis'' are uneditable.


<!--T:18-->
<!--T:57-->
* {{PropertyData|Angle}}: angle of rotation. See [[#Angle|Angle]].
* {{PropertyData|Type|Enumeration}}
* {{PropertyData|Label}}: label given to the operation, can be changed at convenience.
* {{PropertyData|Base|Vector}}: (read-only)
* {{PropertyData|Midplane}}: true or false. See [[#Symmetric to plane|Symmetric to plane]].
* {{PropertyData|Axis|Vector}}: (read-only)
* {{PropertyData|Reversed}}: true or false. See [[#Reversed|Reversed]].
* {{PropertyData|Angle|Angle}}
* {{PropertyData|Up To Face|LinkSub}}
* {{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.
* {{PropertyData|Angle2|Angle}}
* {{PropertyData|Reference Axis|LinkSub}}


==Examples== <!--T:6-->
<!--T:58-->
{{TitleProperty|Sketch Based}}


<!--T:8-->
<!--T:59-->
* {{PropertyData|Profile|LinkSub}}
[[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).]]
* {{PropertyData|Midplane|Bool}}
* {{PropertyData|Reversed|Bool}}
* {{PropertyData|Allow Multi Face|Bool}}


==Useful links== <!--T:32-->
==Notes== <!--T:33-->


<!--T:3-->
<!--T:34-->
* A [[File:PartDesign_ShapeBinder.svg|16px]] [[PartDesign_ShapeBinder|ShapeBinder]] cannot be used for the profile.
A [http://forum.freecadweb.org/viewtopic.php?f=3&t=3674 detailed example of use] on the forum.
* When using a [[File:PartDesign_SubShapeBinder.svg|16px]] [[PartDesign_SubShapeBinder|SubShapeBinder]] for the profile, selecting the binder in the [[Tree_view|Tree view]] will fail, instead the binder's face has to selected in the [[3D_view|3D view]].





Latest revision as of 09:35, 21 April 2024

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 a single sketch or one or more faces from the Body.
  2. Press the Revolution button.
  3. Set the Revolution parameters, see Options below.
  4. Press the OK button.

Options

When creating a revolution, or after double-clicking an existing revolution in the Tree view, the Revolution parameters task panel is shown. It offers the following settings:

Type

introduced in version 1.0

Type offers five different ways of specifying the angle of the revolution:

Dimension

Enter a numeric value for the Angle of the revolution. With the option Symmetric to plane the revolution will extend half the given angle to either side of the sketch or face.

To last

The revolution will extend up to the last face of the support it encounters in its direction. If there is no support, an error message will appear.

To first

The revolution will extend up to the first face of the support it encounters in its direction. If there is no support, an error message will appear.

Up to face

The revolution will extend up to a face. Press the Face button and select a face or a datum plane from the Body.

Two dimensions

This allows to enter a second angle in which the revolution should extend in the opposite direction. The directions can be switched by checking the Reversed option.

Axis

Specifies the axis of the revolution:

  • Vertical sketch axis: selects the vertical sketch axis.
  • Horizontal sketch axis: selects the horizontal sketch axis.
  • Construction line: selects a construction line from the sketch used by the revolution. The dropdown list will contain an entry for each construction line. The first construction line will be labelled Construction line 1.
  • Base (X/Y/Z) axis: selects the X, Y or Z axis of the Body's origin.
  • Select reference...: allows the selection of a straight edge or a datum line from the Body.

Note that when changing the axis, the Reversed option may be (un)checked automatically.

Angle

Defines the angle of the revolution. This option is only available if Type is Dimension or Two dimensions. Angles larger than 360° are not possible. Nor are negative values, use the Reversed option instead.

Symmetric to plane

Check this option to extend the revolution half the given angle to either side of the sketch or face. This option is only available if Type is Dimension.

Reversed

Reverses the direction of the revolution.

2nd angle

introduced in version 1.0

Defines the angle of the revolution in the opposite direction. This option is only available if Type is Two dimensions and Angle is smaller than 360°.

Properties

Data

Part Design

  • DataRefine (Bool)

Revolution

  • DataType (Enumeration)
  • DataBase (Vector): (read-only)
  • DataAxis (Vector): (read-only)
  • DataAngle (Angle)
  • DataUp To Face (LinkSub)
  • DataAngle2 (Angle)
  • DataReference Axis (LinkSub)

Sketch Based

  • DataProfile (LinkSub)
  • DataMidplane (Bool)
  • DataReversed (Bool)
  • DataAllow Multi Face (Bool)

Notes