Jump to content

TechDraw Hatch

From FreeCAD Documentation
Revision as of 16:37, 1 October 2025 by Roy 043 (talk | contribs)

(diff) ← Older revision | Approved revision (diff) | Latest revision (diff) | Newer revision → (diff)

TechDraw Hatch

Menu location
TechDraw → Hatching → Image Hatch
Workbenches
TechDraw
Default shortcut
None
Introduced in version
-
See also
TechDraw Geometric Hatch, TechDraw Hatching

Description[edit | edit source]

The TechDraw Hatch tool fills a closed region in a view with a tiled SVG or bitmap (introduced in 0.21) based hatch pattern. Alternatively the TechDraw GeometricHatch tool uses PAT based hatch patterns. See Hatching for details.

SVG hatch pattern on a face

Usage[edit | edit source]

  1. Select a closed region in a view.
  2. There are several ways to invoke the tool:
    • Press the Image Hatch button.
    • Select the TechDraw → Hatching → Image Hatch option from the menu.
  3. The Create Hatch Face task panel opens.
  4. Optionally change the Pattern file, the SVG pattern scale, the SVG line color, the Rotation, the Offset X and the Offset Y. The SVG settings are ignored for bitmap patterns.
  5. Press the OK button.

Notes[edit | edit source]

  • For a solid color fill select solid.svg as the Pattern File.
  • Hatching objects are vulnerable to the "topological naming problem". See TechDraw LengthDimension for more information. It is recommended that hatching be one of the last steps in your drawing process.
  • Sample SVG patterns are available locally in:
$INSTALL_DIR/data/Mod/TechDraw/Patterns
Where $INSTALL_DIR is the directory where FreeCAD was installed, for example:
/usr/share/freecad/data/Mod/TechDraw/Patterns
They are also available on GitHub.

Properties[edit | edit source]

  • DataSource: The View and Face to receive the hatch pattern.
  • DataHatch Pattern: Full path and filename to an SVG pattern file.
  • ViewHatch Color: Hatch pattern will be displayed in this color.
  • ViewHatch Scale: Hatch pattern size modifier.

Scripting[edit | edit source]

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

A Hatch can be created with macros and from the Python console by using the following functions:

hatch = FreeCAD.ActiveDocument.addObject("TechDraw::DrawHatch", "Hatch")
hatch.Source = (view1, ["Face0"])
hatch.HatchPattern = hatchFileSpec
page.addView(hatch)