TechDraw Hatch: Difference between revisions

From FreeCAD Documentation
(New image and caption)
No edit summary
Line 10: Line 10:


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

The Hatch tool fills a closed region in a [[TechDraw NewView]] with a hatch pattern, which can be [[SVG]] or [[bitmap]] files.
The Hatch tool fills a closed region in a [[TechDraw NewView]] with a hatch pattern, which can be [[SVG]] or [[bitmap]] files.


Line 18: Line 19:


==How to use== <!--T:3-->
==How to use== <!--T:3-->

# Select an closed region in a View. The region will turn green.
# Select an closed region in a View. The region will turn green.
# Press the {{Button|[[Image:TechDraw_Hatch.png|16px]] [[TechDraw Hatch|Hatch]]}} button
# Press the {{Button|[[Image:TechDraw_Hatch.png|16px]] [[TechDraw Hatch|Hatch]]}} button
# You may need to press recompute [[Image:View-rotate-right.png|16px]].
# You may need to press recompute [[Image:View-rotate-right.png|16px]].


=== Notes === <!--T:7-->
== Notes == <!--T:7-->

* Hatching objects are vulnerable to "topological naming" issues. See the information in the [[TechDraw Dimension Length]] tool for more information. It is recommended that hatching be one of the last steps in your drawing process.
* Hatching objects are vulnerable to "topological naming" issues. See the information in the [[TechDraw Dimension Length]] tool for more information. It is recommended that hatching be one of the last steps in your drawing process.
* Note that [[SVG]] hatch patterns are not included when a drawing page is saved as an [[SVG]] file.
* Note that [[SVG]] hatch patterns are not included when a drawing page is saved as an [[SVG]] file.
Line 37: Line 40:


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

* {{PropertyData|Source}}: The View and Face to receive the hatch pattern.
* {{PropertyData|Source}}: The View and Face to receive the hatch pattern.
* {{PropertyData|Hatch Pattern}}: Full path and filename to an SVG pattern file.
* {{PropertyData|Hatch Pattern}}: Full path and filename to an SVG pattern file.
Line 43: Line 47:


==Scripting== <!--T:6-->
==Scripting== <!--T:6-->

{{Emphasis|See also:}} [[TechDraw API]] and [[FreeCAD Scripting Basics]].
{{Emphasis|See also:}} [[TechDraw API]] and [[FreeCAD Scripting Basics]].


Line 57: Line 62:


{{TechDraw Tools navi}}
{{TechDraw Tools navi}}

{{Userdocnavi}}
{{Userdocnavi}}
</translate>
</translate>

Revision as of 20:20, 3 January 2019

TechDraw Hatch

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

Description

The Hatch tool fills a closed region in a TechDraw NewView with a hatch pattern, which can be SVG or bitmap files.

SVG hatch pattern on a face

How to use

  1. Select an closed region in a View. The region will turn green.
  2. Press the Hatch button
  3. You may need to press recompute .

Notes

  • Hatching objects are vulnerable to "topological naming" issues. See the information in the TechDraw Dimension Length tool for more information. It is recommended that hatching be one of the last steps in your drawing process.
  • Note that SVG hatch patterns are not included when a drawing page is saved as an SVG file.

Sample SVG patterns are available in

$INSTALL_DIR/Mod/Draft/Resources/patterns

where $INSTALL_DIR is the directory where FreeCAD was installed, for example

/usr/share/freecad/Mod/Draft/Resources/patterns

Properties

  • 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

See also: TechDraw API and FreeCAD Scripting Basics.

The Hatch tool can be used in 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
rc = page.addView(hatch)