TechDraw Preferences

From FreeCAD Documentation
Revision as of 23:42, 13 March 2020 by Uwestoehr (talk | contribs) (style)
This documentation is a work in progress. Please don't mark it as translatable since it will change in the next hours and days.

Introduction

The preferences of the TechDraw Workbench are found in the Preferences Editor, Edit → Preferences → TechDraw.

All preferences settings with italic labels are default values for new drawing objects. They have no effect on existing objects.

General

File:TechDraw Preferences1.png

Drawing Update

introduced in version 0.19

  • Update With 3D: Whether or not pages are updated every time the 3D model is changed. This is a global policy setting.
  • Allow Page Override: Whether or not a page's Keep Update property can override the global Update With 3D parameter. This is a global policy setting.
  • Keep Page Up To Date: Keeps the drawing pages in sync with the 3D model in real time. This can slow the response time.
  • Auto-distribute Secondary Views: Automatically distributes secondary views for Projection Groups.

Colors

Setup of the default colors for new pages. Additionally there is an option:

Labels

  • Label Font: The name of the default font for labels.
  • Label Size: Default size for label text.

Files

Scale

File:TechDraw Preferences2.png

Scale

  • ??:??.

Selection

  • ??:??.

Size Adjustments

  • Template Edit Mark: Size of editable text marker in templates (green dots).

Dimensions

File:TechDraw Preferences3.png

Dimensions

  • Standard and Style: The standard to be used for dimensional values. The options are
    • ISO oriented: ??
    • ISO Referencing: ??
    • ASME Inlined: ??
    • ASME Referencing: ??
  • Use Global Decimals: Use number of decimals from the general preferences.
  • Show Units: Appends the unit (mm, in, etc.) to dimension values.
  • Alternate Decimals: Number of decimals if Use Global Decimals is not used.
  • Default Format: Custom format for dimension text. Uses the printf format specifier.
  • Font Size: Font size for dimension text.
  • Diameter Symbol: Character used to indicate diameter dimensions.
  • Arrow Style: Arrowhead style for dimensions.
  • Arrow Size: Arrowhead size of dimensions.

Annotation

  • Section Line Standard: Standard to be used to draw section lines in section views.
  • Section Line Style: Style for section lines.
  • Line Group Name: Name of the default line group specification.
  • Matting Style: Outline shape for detail views.
  • Center Line Style: Default style for centerlines.
  • Balloon Shape: Shape of balloon annotations.
  • Balloon Leader End: Default style for balloon leader line ends.
  • Balloon Leader Kink Length: Length of balloon leader line kink.
  • Balloon Pyramid Vertical: Keep pyramid leader line end in vertical or horizontal position.??
  • Leader Line Auto Horizontal: Forces last leader line segment to be horizontal.
  • Show Center Marks: Show arc center marks in views.
  • Print Center Marks: Show arc centers in printed output.

Conventions

  • Projection Group Angle: If projection groups will use either first- or third-angle projection. See multiview projection for an explanation.
  • Hidden Line Style: The style to be used for hidden lines.

HLR Parameters

File:TechDraw Preferences5.png

HLR stands for hidden line removal.

  • Use Polygon Approximation: Uses an approximation to find hidden lines. This is fast, but the result is a collection of short straight lines.
  • Show Hard Lines: Shows hard and outline edges (visible lines always shown)
  • Show Smooth Lines: Shows smooth lines. A smooth line is ??
  • Show Seam Lines: Show seam lines. A seam line is ??
  • Show UV ISO Lines: Make lines of equal parameterization.??
  • ISO Count: The number of ISO lines per face edge. An ISO line is ??

Advanced

File:TechDraw Preferences4.png
  • Detect Faces: If checked, TechDraw will attempt to build faces using the line segments returned by the hidden line removal algorithm. Faces must be detected in order to use Hatching, but there can be a performance penalty in complex models.
  • Show Section Edges: Highlights the border of the section cut in Section Views.
  • Debug Section: Dumps intermediate results during a Section view processing
  • Debug Detail: Dumps intermediate results during a Detail view processing
  • Allow Crazy Edges: Includes edges with unexpected geometry in results, e.g. zero lengths
  • Fuse Before Section: Performs a fuse operation on the input shape(s) before Section view processing
  • Show Loose 2D Geom: Includes 2D Objects in projections, e.g. loose sketches
  • Line End Cap Shape: Setting of the line end cap shape. Explanation of the options: https://doc.qt.io/qt-5/qt.html#PenCapStyle-enum
  • Max SVG Hatch Tiles: The limit of SVG tiles with a size of 64x64 pixels used to hatch a single face. For large scalings one might get an error about to many SVG tiles, then one needs to increase the tile limit.
  • Max PAT Hatch Segments: The maximum hatch line segments used when hatching a face with a PAT pattern.

Hidden Settings

Note: Since FreeCAD 0.19, all settings are available in the Preferences dialogs. The following only applies for FreeCAD versions older than 0.19:

Some preference settings are only accessible through the Parameter editor, Tools → Edit parameters.

Preferences/Mod/TechDraw/Decorations

  • CenterMarkScale: default scale factor for CenterMarks
  • ShowCenterMarks: default true/false
  • PrintCenterMarks: true/false show CenterMarks when printing introduced in version 0.19

Preferences/Mod/TechDraw/General

  • DefaultScale: initial setting of Page Scale introduced in version 0.19
  • EdgeFuzz: pick radius for Edges
  • MarkFuzz: pick radius for CenterMarks
  • SectionFuseFirst: fuse Source objects before performing Section cut
  • EdgeEndCap: shape of Edge ends 0x00 FlatCap, 0x10 SquareCap, 0x20 RoundCap (Qt::PenCapStyle) introduced in version 0.19

Preferences/Mod/TechDraw/Format

  • SectionFormat: section line style 0-ASME 1-ISO

Preferences/Mod/TechDraw/Standards

  • RadiusAligned: Radius dimension format 0-ISO(aligned) 1-ASME(uniform)