PartDesign Revolution: Difference between revisions

From FreeCAD Documentation
(added image)
(V0.22 -> V1.0)
 
(95 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]]
|[[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. 360degrees would be a full, contiguous revolution.
|IconC=Workbench_PartDesign.svg
====Axis====
}}
This option specifies the axis about which the sketch is to be revolved.
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 three pictue4s below show the example sketch revolved about the x, y, and z axis respectively:


<!--T:4-->
===Placement===
{{GuiCommand
====Angle====
|Name=PartDesign Revolution
The Angle argument specifies how far the object is to be turned. The
|MenuLocation=Part Design → Create an additive feature → Revolution
coordinates move the origin of the axis of revolving, relative to the origin
|Workbenches=[[PartDesign_Workbench|PartDesign]]
of the coordinate system.
|SeeAlso=[[PartDesign_Groove|PartDesign Groove]]
If you select a user defined axis, the numbers define the direction of the
}}
revolving axis with respect to the coordinate system: If the Z coordinate is

0 and the Y and X coordinate are non-zero, then the axis will lie in the
==Description== <!--T:23-->
X-Y-plane. Its angle is such that its tangent is the ratio of the given

X and Y coordinates.
<!--T:1-->
===Examples===
The '''Revolution''' tool creates a solid by revolving a selected sketch or 2D object about a given axis.
[[Image:revolve3_cropped.png|frame|Example revolution 1: In this image the angle has been set to 70degrees. The sketch is the face not shown in the image (i.e. the 'back' face).]]

[[Image:revolve5_cropped.png|frame|Example revolution 2: In this image the angle is 70degrees, revolution is about the z-axis and there is a y-offset of 100mm.]]
</translate>
[[Image:revolve7_cropped.png|frame|Example revolution 3: In this image the angle is 270degrees, revolution is about the x-axis and there are 0 offsets]]
[[File:PartDesign Revolution example.svg]]
{{clear}}
<translate>
{{languages | {{es|PartDesign Revolve/es}} }}

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