PartDesign Pocket: Difference between revisions

From FreeCAD Documentation
m (png to svg)
mNo edit summary
(25 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:9-->
<!--T:9-->
{{Docnav
{{Docnav|[[PartDesign AdditiveWedge|Additive wedge]]|[[PartDesign_Hole|Hole]]|[[PartDesign_Workbench|PartDesign]]|IconL=PartDesign AdditiveWedge.png|IconC=Workbench_PartDesign.svg|IconR=PartDesign Hole.png}}
|[[PartDesign_AdditiveWedge|Additive wedge]]
|[[PartDesign_Hole|Hole]]
|[[PartDesign_Workbench|PartDesign]]
|IconL=PartDesign_AdditiveWedge.svg
|IconR=PartDesign_Hole.svg
|IconC=Workbench_PartDesign.svg
}}


<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand|Name=PartDesign Pocket|Workbenches=[[PartDesign Workbench|PartDesign]]|MenuLocation=PartDesign → Pocket}}
|Name=PartDesign Pocket
|MenuLocation=PartDesign → Create a substractive feature → Pocket
|Workbenches=[[PartDesign_Workbench|PartDesign]]
|SeeAlso=[[PartDesign_Pad|PartDesign Pad]]
}}


==Description== <!--T:2-->
==Description== <!--T:45-->

The '''Pocket''' tool cuts out a solid by extruding a sketch (or a face of the solid) in a straight path and subtracting it from the solid.
<!--T:2-->
The '''Pocket''' tool cuts solids by extruding a sketch or a face of a solid along a straight path.


</translate>
</translate>
Line 16: Line 31:
''Sketch profile (A) was mapped to the top face of base solid (B); result after pocketing through on the right. ''
''Sketch profile (A) was mapped to the top face of base solid (B); result after pocketing through on the right. ''


==Usage== <!--T:6-->
==Usage== <!--T:46-->

# Select the sketch to be pocketed.
<!--T:6-->
#: <span style="font-size:x-small;color:blue;">v0.16 and below</span> The sketch must be mapped to the planar face of an existing solid or Part Design feature, or an error message will appear.
# Select the sketch or face to be pocketed. {{Version|0.20}} Alternatively you can select several sketches or faces.
# Press the {{KEY|[[Image:PartDesign_Pocket.svg|16px]] '''Pocket'''}} button.
# Press the {{KEY|[[Image:PartDesign_Pocket.svg|16px]] '''Pocket'''}} button.
# Set the Pocket parameters (see next section).
# Set the Pocket parameters, see the [[#Options|Options]] below.
# Click OK.
# Click OK.


==Options== <!--T:3-->
==Options== <!--T:3-->
[[Image:Pocket_options.png|left]]


<!--T:47-->
When creating a pocket, the '''Pocket parameters''' dialogue offers five different ways of specifying the length (depth) to which the pocket will be extruded:
When creating a pocket, the the '''Pocket parameters''' dialog will be shown. It offers the following settings:
===Dimension=== <!--T:7-->

Enter a numeric value for the depth of the pocket. The default direction for extrusion is into the support. Extrusions occur [http://en.wikipedia.org/wiki/Surface_normal normal] to the defining sketch plane. Negative dimensions are not possible. Use the '''Reversed''' option instead.
<!--T:48-->
===To first===
[[Image:pocket_parameters_cropped.png|frame|left]]

===Type=== <!--T:29-->

<!--T:44-->
Type offers four different ways of specifying the length to which the pocket will be extruded:

===Dimension=== <!--T:49-->

<!--T:7-->
Enter a numeric value for the length of the pocket. The default direction for extrusion is into the support, but it can be changed by ticking the '''Reversed''' option. Extrusions occur by default [http://en.wikipedia.org/wiki/Surface_normal normal] to the defining sketch plane. This can be changed by specifying another '''Direction''' {{Version|0.20}}. With the option '''Symmetric to plane''' the pocket will extend half of the given length to either side of the plane. Negative dimensions are not possible. Use the '''Reversed''' option instead.

====Through all==== <!--T:50-->

<!--T:51-->
The pocket will extrude through all objects in the extrusion direction. With the option '''Symmetric to plane''' the pad will cut through all material in both directions.</br>'''Note:''' For technical reasons, ''Through All'' is actually a 10 meter deep pocket. If you need deeper pockets, use the type '''Dimension'''.

====To first==== <!--T:52-->

<!--T:53-->
The pocket will extrude up to the first face of the support in the extrusion direction. In other words, it will cut through all material until it reaches an empty space.
The pocket will extrude up to the first face of the support in the extrusion direction. In other words, it will cut through all material until it reaches an empty space.
===Through all===
The pocket will cut through all material in the extrusion direction. With the option '''Symmetric to plane''' the pad will cut through all material in both directions.
===Up to face===
The pocket will extrude up to a face in the support that can be chosen by clicking on it.
===Two dimensions===
<span style="font-size:x-small;color:green;">v0.17 and above</span> This allows to enter a second length in which the pad should extend in the opposite direction (into the support). Again can be changed by ticking the '''Reversed''' option.


====Up to face==== <!--T:54-->


==Limitations== <!--T:4-->
<!--T:13-->
The pocket will extrude up to a face in the model that can be chosen by clicking on it.
* Use the type '''Dimension''' or '''Through All''' wherever possible because the other types sometimes give trouble when they are being patterned
* Otherwise, the pocket feature has the same [[PartDesign_Pad#Limitations|limitations]] as the pad feature.


==Useful links== <!--T:5-->
====Two dimensions==== <!--T:55-->
An [http://forum.freecadweb.org/viewtopic.php?f=3&t=3733&start=10 example] with the practice on the forum.


<!--T:56-->
This allows to enter a second length in which the pocket should extend in the opposite direction (into the support). The directions can be switched by ticking the '''Reversed''' option.


<!--T:10-->
===Length=== <!--T:57-->
{{Docnav|[[PartDesign AdditiveWedge|Additive wedge]]|[[PartDesign_Hole|Hole]]|[[PartDesign_Workbench|PartDesign]]|IconL=PartDesign AdditiveWedge.png|IconC=Workbench_PartDesign.svg|IconR=PartDesign Hole.png}}


<!--T:11-->
<!--T:58-->
Defines the length of the pocket. Multiple units can be used independently of the user's units preferences (m, cm, mm, nm, ft or ', in or "). This option is only available when '''Type''' is either '''Dimension''' or '''Two dimensions'''.
{{PartDesign Tools navi}}


<!--T:12-->
=== Offset to face === <!--T:59-->

{{Userdocnavi}}
<!--T:60-->
Offset from face at which the pocket will end. This option is only available when '''Type''' is either '''Through all''', '''To first''' or '''Up to face'''.

===Direction=== <!--T:61-->

<!--T:62-->
{{Version|0.20}}

==== Direction/edge ==== <!--T:63-->

<!--T:64-->
You can select the direction of the extrusion:

<!--T:65-->
* '''Face/Sketch normal''' The sketch or face is extruded along its normal. If you have selected several sketches or faces to be extruded, the normal of the first one will be used. {{Version|0.20}}
* '''Select reference...''' The sketch is extruded along an edge of the 3D model. When this is method selected, you can click on any edge in the 3D model and it becomes the direction vector for the extrusion.
* '''Custom direction''' The sketch is extruded along a direction that can be specified via vector values.

==== Show direction ==== <!--T:66-->

<!--T:67-->
If checked, the pocket direction will be shown. In case the pocket uses a '''Custom direction''', it can be changed.

==== Length along sketch normal ==== <!--T:68-->

<!--T:69-->
If checked, the pocket length is measured along the sketch normal, otherwise along the custom direction.

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

<!--T:71-->
Tick the checkbox to extrude half of the given length to either side of the sketch or plane.

=== Reversed === <!--T:72-->

<!--T:73-->
Reverses the direction of the pocket.

==Properties== <!--T:74-->

<!--T:75-->
* {{PropertyData|Type}}: Type of ways how the pocket will be extruded, see [[#Options|Options]].
* {{PropertyData|Length}}: Defines the length of the pocket, see [[#Options|Options]].
* {{PropertyData|Length2}}: Second pocket length in case the {{PropertyData|Type}} is '''TwoLengths''', see [[#Options|Options]].
* {{PropertyData|Use Custom Vector}}: {{Version|0.20}} If checked, the pocket direction will not be the normal vector of the sketch but the given vector, see [[#Options|Options]].
* {{PropertyData|Direction}}: {{Version|0.20}} Vector of the pocket direction if {{PropertyData|Use Custom Vector}} is used.
* {{PropertyData|Along Sketch Normal}}: {{Version|0.20}} If ''true'', the pocket length is measured along the sketch normal. Otherwise and if {{PropertyData|Use Custom Vector}} is used, it is measured along the custom direction.
* {{PropertyData|Up To Face}}: A face the pocket will extrude up to, see [[#Options|Options]].
* {{PropertyData|Refine}}: True or false. Cleans up residual edges left after the operation. This property is initially set according to the user's settings (found in {{MenuCommand|Preferences → Part design → General → Model settings}}). It can be manually changed afterwards. This property will be saved with the FreeCAD document.

==Limitations== <!--T:76-->

<!--T:4-->
* Use the type '''Dimension''' or '''Through All''' wherever possible because the other types sometimes give trouble when they are being patterned
* Otherwise, the pocket feature has the same [[PartDesign_Pad#Limitations|limitations]] as the Pad feature.


<!--T:10-->
{{Docnav
|[[PartDesign_AdditiveWedge|Additive wedge]]
|[[PartDesign_Hole|Hole]]
|[[PartDesign_Workbench|PartDesign]]
|IconL=PartDesign_AdditiveWedge.svg
|IconR=PartDesign_Hole.svg
|IconC=Workbench_PartDesign.svg
}}


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

Revision as of 12:04, 12 December 2021

PartDesign Pocket

Menu location
PartDesign → Create a substractive feature → Pocket
Workbenches
PartDesign
Default shortcut
None
Introduced in version
-
See also
PartDesign Pad

Description

The Pocket tool cuts solids by extruding a sketch or a face of a solid along a straight path.

Sketch profile (A) was mapped to the top face of base solid (B); result after pocketing through on the right.

Usage

  1. Select the sketch or face to be pocketed. introduced in version 0.20 Alternatively you can select several sketches or faces.
  2. Press the Pocket button.
  3. Set the Pocket parameters, see the Options below.
  4. Click OK.

Options

When creating a pocket, the the Pocket parameters dialog will be shown. It offers the following settings:

Type

Type offers four different ways of specifying the length to which the pocket will be extruded:

Dimension

Enter a numeric value for the length of the pocket. The default direction for extrusion is into the support, but it can be changed by ticking the Reversed option. Extrusions occur by default normal to the defining sketch plane. This can be changed by specifying another Direction introduced in version 0.20. With the option Symmetric to plane the pocket will extend half of the given length to either side of the plane. Negative dimensions are not possible. Use the Reversed option instead.

Through all

The pocket will extrude through all objects in the extrusion direction. With the option Symmetric to plane the pad will cut through all material in both directions.
Note: For technical reasons, Through All is actually a 10 meter deep pocket. If you need deeper pockets, use the type Dimension.

To first

The pocket will extrude up to the first face of the support in the extrusion direction. In other words, it will cut through all material until it reaches an empty space.

Up to face

The pocket will extrude up to a face in the model that can be chosen by clicking on it.

Two dimensions

This allows to enter a second length in which the pocket should extend in the opposite direction (into the support). The directions can be switched by ticking the Reversed option.

Length

Defines the length of the pocket. Multiple units can be used independently of the user's units preferences (m, cm, mm, nm, ft or ', in or "). This option is only available when Type is either Dimension or Two dimensions.

Offset to face

Offset from face at which the pocket will end. This option is only available when Type is either Through all, To first or Up to face.

Direction

introduced in version 0.20

Direction/edge

You can select the direction of the extrusion:

  • Face/Sketch normal The sketch or face is extruded along its normal. If you have selected several sketches or faces to be extruded, the normal of the first one will be used. introduced in version 0.20
  • Select reference... The sketch is extruded along an edge of the 3D model. When this is method selected, you can click on any edge in the 3D model and it becomes the direction vector for the extrusion.
  • Custom direction The sketch is extruded along a direction that can be specified via vector values.

Show direction

If checked, the pocket direction will be shown. In case the pocket uses a Custom direction, it can be changed.

Length along sketch normal

If checked, the pocket length is measured along the sketch normal, otherwise along the custom direction.

Symmetric to plane

Tick the checkbox to extrude half of the given length to either side of the sketch or plane.

Reversed

Reverses the direction of the pocket.

Properties

  • DataType: Type of ways how the pocket will be extruded, see Options.
  • DataLength: Defines the length of the pocket, see Options.
  • DataLength2: Second pocket length in case the DataType is TwoLengths, see Options.
  • DataUse Custom Vector: introduced in version 0.20 If checked, the pocket direction will not be the normal vector of the sketch but the given vector, see Options.
  • DataDirection: introduced in version 0.20 Vector of the pocket direction if DataUse Custom Vector is used.
  • DataAlong Sketch Normal: introduced in version 0.20 If true, the pocket length is measured along the sketch normal. Otherwise and if DataUse Custom Vector is used, it is measured along the custom direction.
  • DataUp To Face: A face the pocket will extrude up to, see Options.
  • DataRefine: True or false. Cleans up residual edges left after the operation. This property is initially set according to the user's settings (found in Preferences → Part design → General → Model settings). It can be manually changed afterwards. This property will be saved with the FreeCAD document.

Limitations

  • Use the type Dimension or Through All wherever possible because the other types sometimes give trouble when they are being patterned
  • Otherwise, the pocket feature has the same limitations as the Pad feature.