PartDesign: Gaură/Hole

From FreeCAD Documentation
Jump to navigation Jump to search
This page is a translated version of the page PartDesign Hole and the translation is 45% complete.
Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎Türkçe • ‎español • ‎français • ‎italiano • ‎polski • ‎português do Brasil • ‎română • ‎русский
Arrow-left.svg Previous: PartDesign Pocket.svg Pocket
Next: Groove PartDesign Groove.svg Arrow-right.svg

PartDesign Hole.svg PartDesign Hole

Menu location
Part Design → Hole
Default shortcut
Introduced in version
See also
PartDesign Pocket


Instrumentul Hole găurește una sau mai multe găuri dintr-o schiță selectată. Pot fi setați mai mulți parametri, cum ar fi filetarea și mărimea, potrivirea, tipul orificiilor (locaș cap de șurub conic, cilindric, gaură dreaptă) și multe altele.

Countersunk and counterbored holes cross-section1.png

Countersunk (to the left) and counterbored (to the right) holes cross section.

Cum se folosește

  1. Apăsați butonul PartDesign Hole.png Hole .
  2. If an existing unused sketch is found, it will be automatically be used. If more than one sketch is found, a Select feature panel appears to make a selection. Alternatively, a sketch can be selected before launching the Hole command.
  3. Define the Hole parameters. See Options.
  4. Apăsați tasta OK.


Depending on which selection is made, some fields will activate or stay disabled.

PartDesign Hole parameters.png

Filetarea și mărime

  • Profile: if set to None, no threading info is defined. ISO and UTS thread profiles enable the Direction, Size, Fit and Class fields.
  • Threaded: check will add threading data to the Hole feature and the hole minor diameter is used. If left unchecked, the hole is considered non-threaded, and the nominal major diameter with defined Fit is chosen.
  • Direction: sets the thread direction (Right Hand or Left hand) if Threaded is checked.
  • Size: Sets the thread size. Requires Profile to be set to one of the ISO or UTS profiles.
  • Fit: defines standard or close fit for threaded profiles.
  • Class: defines the tolerance class.
  • Diameter: defines the hole diameter if the Profile was set to None.
  • Depth: depth of the hole from the sketch plane. Dimension enables a field to type a value. Through All will cut the hole through the whole Body.


  • Type: sets type of hole cut: None is a straight hole; other types are Counterbore, Countersink, Cheesehead, Countersink socket screw and Cap screw.
  • Diameter: sets the major diameter for all hole cut types except None. Value is non-editable if a thread profile was selected in Profile.
  • Depth: depth of the hole cut type from the sketch plane. Value is non-editable if a thread profile was selected in Profile.
  • Countersink angle: angle of the conical hole cut. Value is non-editable if a thread profile was selected in Profile.

Drill point

  • Type: definește capătul orificiului dacă "Adâncimea" este setată la "Dimensiunea". Flat produce un fund plat; Unghiul stabilește un capăt conic.


  • Tapered: sets a taper angle to the hole. Value is calculated from the sketch plane normal. 90 degrees sets a straight hole. A value under 90 generates a smaller hole radius at the bottom; a value over 90 enlarges the hole radius at the bottom.


Much of the Data properties are the same as those shown in Options.

  • DateLabel: name given to the object, this name can be changed at convenience.
  • DateReversed: true or false. Reverses extrusion direction.
  • DateRefine: true or false. If set to true, cleans the solid from residual edges left by features. See Part RefineShape for more details.


  • The selected sketch must contain one or more circle(s). The radius of the circle(s) inside the sketch is not taken into account. The generated holes will be identical even if the circles in the sketch have varying radii.
  • By default, the hole feature extrudes below the sketch plane. If the solid lies on the XY_Plane, and the hole sketch is attached to the XY_Plane, it will try to extrude away from the solid and seemingly produce no result. In such a case, the Reversed property needs to be manually set to true; otherwise the sketch needs to be mapped to the bottom face of the solid.

Cut Type Definitions

Cut types (screw-types) are defined in json files since version 0.19. There is a set of files distributed with FreeCAD, but users can create their own definitions. Files are searched in <UserAppDataDir>/PartDesign/Hole. The UserAppDataDir can be found by typing App.getUserAppDataDir() in the Python console.

The file should contain:

  • name: The name of the definition. This must be unique as it will be used as identifier in the FreeCAD UI and as internal index.
  • cut_type: Either countersink or counterbore.
  • thread_type: Either metric or metricfine.
  • angle: The angle of a countersink (not necessary for counterbore).
  • data: A list of sizes, consisting of:
    • thread: Name of thread known to FreeCAD.
    • diameter: The diameter of the cut.
    • depth: Depth of the counterbore (not necessary for countersink).


    "name": "DIN 7984",
    "cut_type": "counterbore",
    "thread_type": "metric",
    "data": [
        { "thread": "M2",   "diameter":  4.3, "depth":  1.6 },
        { "thread": "M2.5", "diameter":  5.0, "depth":  2.0 },

Arrow-left.svg Previous: PartDesign Pocket.svg Pocket
Next: Groove PartDesign Groove.svg Arrow-right.svg