PartDesign Revolution: Difference between revisions

From FreeCAD Documentation
(Remove obsolete info under Axis; added v0.17-specific options; added Properties; deleted obsolete examples.)
(V0.22 -> V1.0)
 
(52 intermediate revisions by 9 users not shown)
Line 1: Line 1:
<languages/>
<translate>
<translate>

<!--T:19-->
{{Docnav
|[[PartDesign_Pad|Pad]]
|[[PartDesign_AdditiveLoft|Additive loft]]
|[[PartDesign_Workbench|PartDesign]]
|IconL=PartDesign_Pad.svg
|IconR=PartDesign_AdditiveLoft.svg
|IconC=Workbench_PartDesign.svg
}}

<!--T:4-->
<!--T:4-->
{{GuiCommand
{{GuiCommand|Name=PartDesign Revolution|Workbenches=[[PartDesign Workbench|PartDesign]], Complete|MenuLocation=PartDesign → Revolution}}
|Name=PartDesign Revolution
|MenuLocation=Part Design → Create an additive feature → Revolution
|Workbenches=[[PartDesign_Workbench|PartDesign]]
|SeeAlso=[[PartDesign_Groove|PartDesign Groove]]
}}


==Introduction== <!--T:1-->
==Description== <!--T:23-->

<!--T:1-->
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.


</translate>
</translate>[[File:PartDesign Revolution example.svg|none]]<translate>
[[File:PartDesign Revolution example.svg]]
<translate>


<!--T:11-->
<!--T:11-->
''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.}}


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


<!--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 {{KEY|[[Image:PartDesign Revolution.png|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 {{KEY|OK}}.
# Press the {{Button|OK}} button.


==Options== <!--T:2-->
==Options== <!--T:24-->
When creating a revolution, the '''Revolution parameters''' dialogue offers several parameters specifying how the sketch should be revolved.


<!--T:2-->
{|
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:
| [[Image:partdesign_revolution_parameters.png|left]]
|
===Axis=== <!--T:10-->
This option specifies the axis about which the sketch is to be revolved. 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 created in the sketch will be labelled ''Sketch axis 0''.


<!--T:25-->
<span style="font-size:x-small;color:green;">v0.17 and above</span> Other selectable options are:
[[Image:partdesign_revolution_parameters.png|frame|left]]
* '''Base (X/Y/Z) axis''': selects the X, Y or Z axis of the Body's Origin;
* '''Select reference...''': allows selection in the 3D view of an edge on the Body, or a datum line.


===Angle===
===Type=== <!--T:35-->
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===
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.
|}
{{clear}}


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


<!--T:37-->
Below are properties which can be defined after creation of the feature. Data properties Base, Axis and Angle are uneditable.
Type offers five different ways of specifying the angle of the revolution:


====Dimension==== <!--T:38-->
* {{PropertyData|Label}}: name given to the operation, this name can be changed at convenience.
* {{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== <!--T:6-->
<!--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.


<!--T:8-->
====To last==== <!--T:40-->
[[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)]]
{{clear}}


==Useful links== <!--T:3-->
<!--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.
A [http://forum.freecadweb.org/viewtopic.php?f=3&t=3674 detailed example of use] on the forum.


====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-->

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

<!--T:10-->
* '''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 [[PartDesign_Line|datum line]] from the Body.

<!--T:49-->
Note that when changing the axis, the '''Reversed''' option may be (un)checked automatically.

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

<!--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.

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

<!--T:29-->
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-->

<!--T:31-->
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}}

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

<!--T:56-->
{{TitleProperty|Revolution}}

<!--T:57-->
* {{PropertyData|Type|Enumeration}}
* {{PropertyData|Base|Vector}}: (read-only)
* {{PropertyData|Axis|Vector}}: (read-only)
* {{PropertyData|Angle|Angle}}
* {{PropertyData|Up To Face|LinkSub}}
* {{PropertyData|Angle2|Angle}}
* {{PropertyData|Reference Axis|LinkSub}}

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

<!--T:59-->
* {{PropertyData|Profile|LinkSub}}
* {{PropertyData|Midplane|Bool}}
* {{PropertyData|Reversed|Bool}}
* {{PropertyData|Allow Multi Face|Bool}}

==Notes== <!--T:33-->

<!--T:34-->
* A [[File:PartDesign_ShapeBinder.svg|16px]] [[PartDesign_ShapeBinder|ShapeBinder]] cannot be used for the profile.
* 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]].


<!--T:20-->
{{Docnav
|[[PartDesign_Pad|Pad]]
|[[PartDesign_AdditiveLoft|Additive loft]]
|[[PartDesign_Workbench|PartDesign]]
|IconL=PartDesign_Pad.svg
|IconR=PartDesign_AdditiveLoft.svg
|IconC=Workbench_PartDesign.svg
}}


</translate>
</translate>
{{PartDesign Tools navi{{#translation:}}}}
<languages/>
{{Userdocnavi{{#translation:}}}}

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