Difference between revisions of "Part Extrude/en"

From FreeCAD Documentation
Jump to navigation Jump to search
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<languages/>
 
<languages/>
 
{{Docnav
 
{{Docnav
|[[Part Compound‏‎Filter|Compound Filter]]
+
|[[Part_Builder|Builder]]
|[[Part_Fillet|Fillet]]
+
|[[Part_Revolve|Revolve]]
|[[Part_Module|Part]]
+
|[[Part_Workbench|Part]]
|IconL=Part Compound‏‎Filter.svg
+
|IconL=Part_Builder.svg
 +
|IconR=Part_Revolve.svg
 
|IconC=Workbench_Part.svg
 
|IconC=Workbench_Part.svg
|IconR=Part_Fillet.svg
 
 
}}
 
}}
  
Line 12: Line 12:
 
|Name=Part Extrude
 
|Name=Part Extrude
 
|MenuLocation=Part → Extrude
 
|MenuLocation=Part → Extrude
|Workbenches=[[Part_Module|Part]]
+
|Workbenches=[[Part_Workbench|Part]]
|SeeAlso=[[Draft Trimex]]
+
|SeeAlso=[[Draft_Trimex|Draft Trimex]], [[PartDesign_Pad|PartDesign Pad]]
 
}}
 
}}
  
[[image:Part Extrude demo.png|600px]]
+
[[image:Part_Extrude_demo.png|600px]]
 +
 
 
== Description ==
 
== Description ==
 +
 
'''Part Extrude''' extends a shape by a specified distance, in a specified direction. The output shape type will vary depending on the input shape type and the options selected.
 
'''Part Extrude''' extends a shape by a specified distance, in a specified direction. The output shape type will vary depending on the input shape type and the options selected.
  
Line 27: Line 29:
 
*  Extrude a closed Wire (e.g. a Draft Wire), will optionally produce a shell (several joined faces) or if the parameter "solid" is "true" will produce a solid  
 
*  Extrude a closed Wire (e.g. a Draft Wire), will optionally produce a shell (several joined faces) or if the parameter "solid" is "true" will produce a solid  
 
*  Extrude a face (e.g. plane), will produce a solid (e.g. Cuboid)
 
*  Extrude a face (e.g. plane), will produce a solid (e.g. Cuboid)
*  Extrude a [[Draft_ShapeString |Draft Shape String]], will produce a compound of solids (the string is a compound of the letters which are each a solid)
+
*  Extrude a {{Button|[[File:Draft_ShapeString.svg|16px]] [[Draft_ShapeString|Draft ShapeString]]}}, will produce a compound of solids (the string is a compound of the letters which are each a solid)
 
* Extrude a shell of faces, will produce a Compsolid.
 
* Extrude a shell of faces, will produce a Compsolid.
  
 
==Usage==
 
==Usage==
# Select the shape(s) in the 3D view or in the Model tree
+
 
# Click on the {{KEY|[[Image:Part_Extrude.svg|16px]] '''Extrude'''}} icon in the toolbar, or go to the Part → Extrude menu
+
# Select the shape(s) in the [[3D_view|3D view]] or in the Model [[Tree_view|tree view]]
 +
# Click on the {{Button|[[Image:Part_Extrude.svg|16px]] [[Part_Extrude|Part Extrude]]}} button in the toolbar, or go to the {{MenuCommand|Part → Extrude}} menu
 
# Set the direction and length and optionally other parameters (see the following [[#Parameters|Parameters]] section for more details).
 
# Set the direction and length and optionally other parameters (see the following [[#Parameters|Parameters]] section for more details).
# Click OK.
+
# Click {{Button|OK}}.
  
Alternatively, the selection can be done after launching the tool, by selecting one or more shape from the list in the Tasks panel.
+
Alternatively, the selection can be done after launching the tool, by selecting one or more shape from the list in the [[Task_panel|Tasks panel]].
  
 
The Model tree will list as many Extrude objects as there were selected shapes. Each input shape is placed underneath its Extrude object.
 
The Model tree will list as many Extrude objects as there were selected shapes. Each input shape is placed underneath its Extrude object.
  
 
== Parameters ==
 
== Parameters ==
The Extrude shape is defined by the following parameters, which can be edited after its creation in the Data tab. 
 
  
*'''Base''': the input shape (the shape upon which the Part Extrude was applied)
+
The Extrude shape is defined by the following parameters, which can be edited after its creation in [[Property_editor|Property editor]]. 
 +
 
 +
*'''Base''': the input shape (the shape upon which the Part Extrude was applied).
  
 
*'''Dir''': the direction to extend the shape. If '''Dir Mode''' is 'Custom', you can edit '''Dir'''. Otherwise, '''Dir''' is read-only, and computed from the linked shape.
 
*'''Dir''': the direction to extend the shape. If '''Dir Mode''' is 'Custom', you can edit '''Dir'''. Otherwise, '''Dir''' is read-only, and computed from the linked shape.
  
*'''Dir Link''': parametric link to a edge (line) that sets the direction of extrusion. As of v0.17, this property is not supported by property editor.
+
*'''Dir Link''': parametric link to a edge (line) that sets the direction of extrusion.
  
 
*'''Dir Mode''': sets how '''Dir''' is controlled. 'Custom' means '''Dir''' is editable. 'Edge' means Dir is obtained from an edge (line) linked by '''Dir Link'''. 'Normal' means Dir is perpendicular to plane of the input shape.
 
*'''Dir Mode''': sets how '''Dir''' is controlled. 'Custom' means '''Dir''' is editable. 'Edge' means Dir is obtained from an edge (line) linked by '''Dir Link'''. 'Normal' means Dir is perpendicular to plane of the input shape.
Line 61: Line 65:
 
*'''Symmetric''': if True, extrusion is centered at the input shape, and total length is '''Length Fwd'''. '''Length Rev''' is ignored.
 
*'''Symmetric''': if True, extrusion is centered at the input shape, and total length is '''Length Fwd'''. '''Length Rev''' is ignored.
  
*'''Taper Angle''' and '''Taper Angle Rev''': applies an angle to the extrusion, so that sides of the extrusion are drafted by the specified angle. Positive angle means the cross-section expands. '''Taper Angle Rev''' sets the taper for the reversed part of the extrusion (the part from '''Length Rev'''). As of v0.17, tapered extrusion is only supported for wires with no holes. Taper does not work well if the extruded shape contains B-splines.  
+
*'''Taper Angle''' and '''Taper Angle Rev''': applies an angle to the extrusion, so that sides of the extrusion are drafted by the specified angle. Positive angle means the cross-section expands. '''Taper Angle Rev''' sets the taper for the reversed part of the extrusion (the part from '''Length Rev''').</br>{{Version|0.20}} Inner structures receive the opposite taper angle. This is done to facilitate the design of molds and molded parts.</br>{{VersionMinus|0.19}} Tapered extrusion is only supported for shapes without inner structures. Taper does not work well if the shape contains B-splines.  
  
 
*'''Face Maker Class''': sets C++ class name of face making code, which is used when making solids from wires. This property is here mainly for maintaining backward compatibility. Do not touch, unless you know what you are doing.
 
*'''Face Maker Class''': sets C++ class name of face making code, which is used when making solids from wires. This property is here mainly for maintaining backward compatibility. Do not touch, unless you know what you are doing.
  
*'''Placement''': the standard [[Placement|placement]] parameters
+
*'''Placement''': the standard [[Placement|placement]] parameters.
  
*'''Label''': label to be shown in the Model tree (not available on Extrude creation)
+
*'''Label''': label to be shown in the Model [[Tree_view|tree view]] (not available on Extrude creation).
  
 
== Task dialog ==
 
== Task dialog ==
Line 77: Line 81:
 
* {{Button|Close}} button closes dialog, without doing anything.
 
* {{Button|Close}} button closes dialog, without doing anything.
  
* {{Button|Apply}} button creates the extrusion, but does not close the dialog. You can then select another shape in the list on the bottom, and create more extrusions. Clicking Apply may times creates many extrusions.
+
* {{Button|Apply}} button creates the extrusion, but does not close the dialog. You can then select another shape in the list on the bottom, and create more extrusions. Clicking {{Button|Apply}} may times creates many extrusions.
  
 
* 'Direction' radio buttons: set the way extrusion direction is computed.  
 
* 'Direction' radio buttons: set the way extrusion direction is computed.  
  
* {{Button|Select}} button: click it, and then pick an edge in 3D view. That edge will appear in text field next to the button, in format "ObjectName:EdgeN". You can also type the link manually. Values X,Y,Z will be filled according to the edge direction.
+
* {{Button|Select}} button: click it, and then pick an edge in [[3D_view|3D view]]. That edge will appear in text field next to the button, in format "ObjectName:EdgeN". You can also type the link manually. Values X,Y,Z will be filled according to the edge direction.
  
 
* {{Button|X}}, {{Button|Y}}, {{Button|Z}} buttons: Click ''x'' button to set extrusion direction to +''x'' axis. Click it again to set -''x'' axis.  
 
* {{Button|X}}, {{Button|Y}}, {{Button|Z}} buttons: Click ''x'' button to set extrusion direction to +''x'' axis. Click it again to set -''x'' axis.  
Line 97: Line 101:
 
* Shape list: here you select, what shapes to extrude. If multiple objects are selected, multiple Extrude objects are created.
 
* Shape list: here you select, what shapes to extrude. If multiple objects are selected, multiple Extrude objects are created.
  
== Gotchas ==
+
== Notes ==
Part Extrude dialog does not offer a preview, yet. 'Apply' will create an extrusion object every time you click it, which can be useful as preview; however, they will remain and yet another one will be created as you click OK. [[Std Undo|Undo]] can be useful to clean them up before clicking OK.
 
  
Since v0.17, a sketch created from within PartDesign cannot be used for Part Extrude, if it is within a Body ("Links go out of allowed scope" error). In order to Part-Extrude a sketch, you should ''create the sketch from Sketcher workbench''. Or you can just drag a PartDesign one out of a Body.
+
* [[App_Link|App Link]] objects linked to the appropriate object types and [[App_Part|App Part]] containers with the appropriate visible objects inside can also be used as profiles and to specify the direction. {{Version|0.20}}
  
Extrusion with taper angle does not support holes. It also may give bogus results if the number of segments in the profile changes as a result of taper.
+
* The task dialog does not offer a preview, yet. {{Button|Apply}} will create an extrusion object every time you click it, which can be useful as preview; however, they will remain and yet another one will be created as you click {{Button|OK}}. [[Std_Undo|Undo]] can be useful to clean them up before clicking {{Button|OK}}.
  
== Comparison with [[PartDesign Pad]] ==
+
== Comparison with PartDesign Pad ==
  
PartDesign Pad is also an extrusion feature, but there are important differences.
+
[[PartDesign_Pad|PartDesign Pad]] is also an extrusion feature, but there are important differences:
  
Part Extrude always creates a standalone shape. PartDesign Pad fuses the extrusion result to the rest of the Body.
+
* Part Extrude always creates a standalone shape. PartDesign Pad fuses the extrusion result to the rest of the Body.
 +
* Part Extrude doesn't care where it is in model tree. PartDesign Pad can only live inside a [[PartDesign_Body|PartDesign Body]].
 +
* Part Extrude can extrude any object that has a Part geometry ([[OpenCASCADE|OpenCASCADE]] shape), except for solids and CompSolids.
 +
* Part Extrude can extrude individual faces of other objects. PartDesign Pad will only accept either Sketch or faces of PartDesign objects as a profile.
  
Part Extrude doesn't care where it is in model tree. PartDesign Pad can only live inside a [[PartDesign Body]].
 
 
Part Extrude can extrude any object that has Part Geometry (OCC shape), except for solids and compsolids. And it can't extrude individual faces of other objects. PartDesign Pad will only accept a Sketch as a profile (and a small selection of other object types), or a face of a solid.
 
  
 
{{Docnav
 
{{Docnav
|[[Part Compound‏‎Filter|Compound Filter]]
+
|[[Part_Builder|Builder]]
|[[Part_Fillet|Fillet]]
+
|[[Part_Revolve|Revolve]]
|[[Part_Module|Part]]
+
|[[Part_Workbench|Part]]
|IconL=Part Compound‏‎Filter.svg
+
|IconL=Part_Builder.svg
 +
|IconR=Part_Revolve.svg
 
|IconC=Workbench_Part.svg
 
|IconC=Workbench_Part.svg
|IconR=Part_Fillet.svg
 
 
}}
 
}}
  
{{Part Tools navi}}
+
{{Part_Tools_navi{{#translation:}}}}
 
+
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi}}
 
 
 
{{clear}}
 

Latest revision as of 16:31, 6 May 2022

Other languages:
Deutsch • ‎English • ‎Türkçe • ‎español • ‎français • ‎italiano • ‎polski • ‎português do Brasil • ‎română • ‎svenska • ‎čeština • ‎русский • ‎中文(中国大陆)‎
Arrow-left.svg Previous: Part Builder.svg Builder
Next: Revolve Part Revolve.svg Arrow-right.svg

Part Extrude.svg Part Extrude

Menu location
Part → Extrude
Workbenches
Part
Default shortcut
None
Introduced in version
-
See also
Draft Trimex, PartDesign Pad

Part Extrude demo.png

Description

Part Extrude extends a shape by a specified distance, in a specified direction. The output shape type will vary depending on the input shape type and the options selected.

In most common scenarios, the following lists the expected output shape type from a given input shape type,

  • Extrude a Vertex (point), will produce a lineal Edge (Line)
  • Extrude a open edge (e.g. line, arc), will produce a open face (e.g. plane)
  • Extrude a closed edge (e.g. circle), will optionally produce a closed face (e.g. an open ended cylinder) or if the parameter "solid" is "true" will produce a solid (e.g. a closed solid cylinder)
  • Extrude a open Wire (e.g. a Draft Wire), will produce a open shell (several joined faces)
  • Extrude a closed Wire (e.g. a Draft Wire), will optionally produce a shell (several joined faces) or if the parameter "solid" is "true" will produce a solid
  • Extrude a face (e.g. plane), will produce a solid (e.g. Cuboid)
  • Extrude a Draft ShapeString.svg Draft ShapeString, will produce a compound of solids (the string is a compound of the letters which are each a solid)
  • Extrude a shell of faces, will produce a Compsolid.

Usage

  1. Select the shape(s) in the 3D view or in the Model tree view
  2. Click on the Part Extrude.svg Part Extrude button in the toolbar, or go to the Part → Extrude menu
  3. Set the direction and length and optionally other parameters (see the following Parameters section for more details).
  4. Click OK.

Alternatively, the selection can be done after launching the tool, by selecting one or more shape from the list in the Tasks panel.

The Model tree will list as many Extrude objects as there were selected shapes. Each input shape is placed underneath its Extrude object.

Parameters

The Extrude shape is defined by the following parameters, which can be edited after its creation in Property editor.

  • Base: the input shape (the shape upon which the Part Extrude was applied).
  • Dir: the direction to extend the shape. If Dir Mode is 'Custom', you can edit Dir. Otherwise, Dir is read-only, and computed from the linked shape.
  • Dir Link: parametric link to a edge (line) that sets the direction of extrusion.
  • Dir Mode: sets how Dir is controlled. 'Custom' means Dir is editable. 'Edge' means Dir is obtained from an edge (line) linked by Dir Link. 'Normal' means Dir is perpendicular to plane of the input shape.
  • Length Fwd: The distance to extrude by. If both Length Fwd and Length Rev are zero, the length of Dir vector is used.
  • Length Rev: Additional length to extrude against Dir.
  • Solid: if True, extruding a closed edge or a closed wire will yield a solid. If False, a shell will result.
  • Reversed: reverses the extrusion to go against Dir.
  • Symmetric: if True, extrusion is centered at the input shape, and total length is Length Fwd. Length Rev is ignored.
  • Taper Angle and Taper Angle Rev: applies an angle to the extrusion, so that sides of the extrusion are drafted by the specified angle. Positive angle means the cross-section expands. Taper Angle Rev sets the taper for the reversed part of the extrusion (the part from Length Rev).
    introduced in version 0.20 Inner structures receive the opposite taper angle. This is done to facilitate the design of molds and molded parts.
    version 0.19 and below Tapered extrusion is only supported for shapes without inner structures. Taper does not work well if the shape contains B-splines.
  • Face Maker Class: sets C++ class name of face making code, which is used when making solids from wires. This property is here mainly for maintaining backward compatibility. Do not touch, unless you know what you are doing.
  • Placement: the standard placement parameters.
  • Label: label to be shown in the Model tree view (not available on Extrude creation).

Task dialog

Part Extrude dialog.png
  • OK button creates the extrusion, and closes the dialog.
  • Close button closes dialog, without doing anything.
  • Apply button creates the extrusion, but does not close the dialog. You can then select another shape in the list on the bottom, and create more extrusions. Clicking Apply may times creates many extrusions.
  • 'Direction' radio buttons: set the way extrusion direction is computed.
  • Select button: click it, and then pick an edge in 3D view. That edge will appear in text field next to the button, in format "ObjectName:EdgeN". You can also type the link manually. Values X,Y,Z will be filled according to the edge direction.
  • X, Y, Z buttons: Click x button to set extrusion direction to +x axis. Click it again to set -x axis.
  • X, Y, Z input fields: set or display the direction vector of extrusion. If both lengths are zero, the length of this vector sets the length of extrusion, and values are always in mm, regardless of unit preferences.
  • Length fields: set length of extrusion. These input fields have unit support.
  • Symmetric: spreads out the extrusion into both directions, so that the profile remains in the middle.
  • Taper Outward Angle: positive angle means profile is expanded at other end of extrusion.
  • Create Solid checkbox: if checked, extruding a closed wire or edge will yield a solid. It is checked by default, if a closed wire was preselected before invoking Part Extrude.
  • Shape list: here you select, what shapes to extrude. If multiple objects are selected, multiple Extrude objects are created.

Notes

  • The task dialog does not offer a preview, yet. Apply will create an extrusion object every time you click it, which can be useful as preview; however, they will remain and yet another one will be created as you click OK. Undo can be useful to clean them up before clicking OK.

Comparison with PartDesign Pad

PartDesign Pad is also an extrusion feature, but there are important differences:

  • Part Extrude always creates a standalone shape. PartDesign Pad fuses the extrusion result to the rest of the Body.
  • Part Extrude doesn't care where it is in model tree. PartDesign Pad can only live inside a PartDesign Body.
  • Part Extrude can extrude any object that has a Part geometry (OpenCASCADE shape), except for solids and CompSolids.
  • Part Extrude can extrude individual faces of other objects. PartDesign Pad will only accept either Sketch or faces of PartDesign objects as a profile.


Arrow-left.svg Previous: Part Builder.svg Builder
Next: Revolve Part Revolve.svg Arrow-right.svg