PartDesign Revolution/en: Difference between revisions

From FreeCAD Documentation
(Importing a new version from external source)
(Updating to match new version of source page)
 
(26 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand|Name=PartDesign Revolution|Workbenches=[[PartDesign Workbench|PartDesign]], Complete|MenuLocation=PartDesign → Revolution}}


{{Docnav
==Introduction==
|[[PartDesign_Pad|Pad]]
This tool revolves a selected sketch or 2D object about a given axis.
|[[PartDesign_AdditiveLoft|Additive loft]]
For all the following explanations of this command the example sketch below will be used:
|[[PartDesign_Workbench|PartDesign]]
[[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.]]
|IconL=PartDesign_Pad.svg
{{clear}}
|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==

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

[[File:PartDesign Revolution example.svg]]

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

==Usage==

# Select a single sketch or one or more faces from the Body.
# Press the {{Button|[[Image:PartDesign_Revolution.svg|24px]] [[PartDesign_Revolution|Revolution]]}} button.
# Set the Revolution parameters, see [[#Options|Options]] below.
# Press the {{Button|OK}} button.

==Options==

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|frame|left]]

===Type===

{{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 {{Button|Face}} button and select a face or a [[PartDesign_Plane|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.


==Options==
When creating a revolution, the 'revolution parameters' dialogue offers several parameters specifying how the sketch should be revolved.
{|
| [[Image:partdesign_revolution_parameters.png|left]]
|
===Axis===
===Axis===

This option specifies the axis about which the sketch is to be revolved. Currently, only the horizontal or vertical sketch axis can be selected here. But in the Properties table, an arbitrary axis can be defined. 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.
Specifies the axis of the revolution:
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.

===Angle===
* '''Vertical sketch axis''': selects the vertical sketch axis.
This controls the angle through which the revolution is to be formed, e.g. 360° would be a full, contiguous revolution.
* '''Horizontal sketch axis''': selects the horizontal sketch axis.
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°.
* '''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.

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===
===Symmetric to plane===

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===
===Reversed===
The direction of revolution will be reversed.
|}


Reverses the direction of the revolution.
==Examples==
Note: All the examples 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==
===2nd angle===
An [http://forum.freecadweb.org/viewtopic.php?f=3&t=3674 example] with the practice on the forum.


{{Version|1.0}}
<languages/>

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

{{TitleProperty|Part Design}}

* {{PropertyData|Refine|Bool}}

{{TitleProperty|Revolution}}

* {{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}}

{{TitleProperty|Sketch Based}}

* {{PropertyData|Profile|LinkSub}}
* {{PropertyData|Midplane|Bool}}
* {{PropertyData|Reversed|Bool}}
* {{PropertyData|Allow Multi Face|Bool}}

==Notes==

* 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]].


{{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:}}}}

Latest revision as of 09:36, 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