PartDesign Revolution: Difference between revisions

From FreeCAD Documentation
(added text)
(V0.22 -> V1.0)
 
(83 intermediate revisions by 13 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand|Name=PartDesign_Revolution|Workbenches=PartDesign, Complete|MenuLocation=PartDesign -> Revolution}}
<translate>
==Introduction==
This tool revolves a selected sketch or 2D object about a given axis.


<!--T:19-->
For all the following explanations of this command the example sketch below will be used:
{{Docnav
[[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}}
|[[PartDesign_Pad|Pad]]
==Options==
|[[PartDesign_AdditiveLoft|Additive loft]]
[[Image:revolve_toolbar.png|left]]
|[[PartDesign_Workbench|PartDesign]]
===Base===
|IconL=PartDesign_Pad.svg
====Angle====
|IconR=PartDesign_AdditiveLoft.svg
This controls the angle through which the revolution is to be formed e.g. 360° would be a full, contiguous revolution.
|IconC=Workbench_PartDesign.svg
The images in the [[#Examples|examples]] section demonstrate some of the possibilities with specifying different angles.
}}
====Axis====
This option specifies the axis about which the sketch is to be revolved.
This option 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. Examples of this are demostrated in example images 1, 2 and 3.
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 diffucult to comprehend, Example Revolution 4 shows an example where more than one of the boxes has a non-zero value.
Setting the value of 1.00 in one of the x, y or z boxes will tell the tool to revolve the sketch about that axis.
This option only recognizes values of 0.00 or 1.00, and only one of the three axis boxes may posses a value of 1.00 (think of it as an on/off switch.)
The images in the [[#Examples|examples]] section demonstrate scenarios where the example sketch is revolved about either the x or the y axis.
====Base====
This option specifies the offset in either the x, y, or z axis and accepts any number as an argument to each field.
For the sketch example on this page, entering a value of -100 for the y field will offset the sketch by -100mm in the y-axis. The difference between a y-offset of 0 and -100 is illustrated in example revolution images 1 and 3 (below). Image 1 has a y-offset of -100, and image 3 a y-offset of 0.
===Placement===
Once a sketch has been revolved, it is transformed in to a revolution part.
This section controls the placement of the part with respect to the coordinate system.
NOTE: The following options do not affect the physical dimensions of the part (as the above did), but merely its position in space.
====Angle====
The Angle argument specifies the angle to be used with the [[#Axis|axis]] option (below). An angle is set here, and the axis that the angle acts upon is set with the axis option.
The part is rotated by the specified angle, about the specified axis.
A usage example might be if you created the revolution as required, but then needed to rotate the whole part by some amount, in order to allow it to line-up with another pre-existing part.
====Axis====
This option specifies the axis/axes about which the created revolution part is to be rotated -NOT REVOLVED (the exact value of rotation comes from the angle option (above)).
This option takes three arguments, which are passed as numbers to either the x, y, or z boxes in the tool. Adding a value to more than one of the axes will cause the part to be rotated by the angle in each axis.
For example, with an angle of 15° set, specifying a value of 1.0 for x, and 2.0 for y will cause the finished part to be rotated 15° in the x-axis AND 30° in the y-axis.
====Position====


<!--T:4-->
===Examples===
{{GuiCommand
[[Image:revolve3_cropped.png|frame|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).]]
|Name=PartDesign Revolution
[[Image:revolve5_cropped.png|frame|Example revolution 2: In this image the angle is 70°, revolution is about the y-axis and there is a y-offset of 100mm.]]
|MenuLocation=Part Design → Create an additive feature → Revolution
[[Image:revolve7_cropped.png|frame|Example revolution 3: In this image the angle is 270°, revolution is about the x-axis and there are 0 offsets]]
|Workbenches=[[PartDesign_Workbench|PartDesign]]
[[Image:revolve8_cropped.png|frame|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 are 0 offsets]]
|SeeAlso=[[PartDesign_Groove|PartDesign Groove]]
{{clear}}
}}
{{languages | {{es|PartDesign Revolve/es}} }}

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

<!--T:1-->
The '''Revolution''' tool creates a solid by revolving a selected sketch or 2D object about a given axis.

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

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

==Usage== <!--T:12-->

<!--T:13-->
# 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== <!--T:24-->

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

<!--T:25-->
[[Image:partdesign_revolution_parameters.png|frame|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-->

<!--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>
{{PartDesign Tools navi{{#translation:}}}}
{{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