TechDraw Workbench
This is the approved revision of this page, as well as being the most recent.
Introduction[edit | edit source]
The TechDraw Workbench is used to produce basic technical drawings from 3D models created with another workbench such as Part, PartDesign, or BIM, or imported from other applications. Each drawing is a Page, which can contain various Views of drawable objects such as Part::Features, PartDesign::Bodies, App::Part groups, and Document Object groups. The resulting drawings can be used for things like documentation, manufacturing instructions, contracts, permits, etc.
Dimensions, sections, hatched areas, annotations, and SVG symbols can be added to the page, which can be further exported to different formats like DXF, SVG, and PDF.
If your primary goal is the production of complex 2D drawings and DXF files, and you don't need 3D modelling, FreeCAD may not be the right choice for you. You may wish to consider a dedicated software program for technical drafting instead, such as LibreCAD or QCad.
Snapping[edit | edit source]
introduced in 1.0: The TechDraw Workbench has a snapping feature. It can be used to automatically align views, section views and dimensions when positioning them by dragging with the mouse. With Snap View Alignment enabled (default) in the preferences, views will snap to alignment with other views when close enough (View Snapping Factor setting). Dimensions are also snapped to other parallel dimensions and the dimension text can be snapped to the middle of the dimension line. Snapping can be temporarily disabled by holding down the Alt key.
Tools[edit | edit source]
Pages[edit | edit source]
New Page From Template: adds a new page using a selected template.
Update Template Fields: automatically fills template fields with document information. introduced in 1.0
Redraw Page: forces an update of the selected page.
Print All Pages: prints all pages in a document. introduced in 0.21
Export Page as SVG: saves the current page as SVG file.
Export Page as DXF: saves the current page as DXF file.
Views[edit | edit source]
TechDraw views[edit | edit source]
New View: adds a representation of one or more objects. introduced in 1.0: It can create a single view, a Projection Group, a Spreadsheet View, an Arch View, a Symbol or an Image View.
Broken View: adds a broken view of one or more objects. introduced in 1.0
Section View: inserts a cross-section view of an existing view.
Complex Section View: inserts a cross-section view of an existing view based on a profile. introduced in 0.21
Detail View: inserts a detail view of a portion of an existing view.
Projection Group: invokes a dialog to create multiple views of an object from different directions. introduced in 1.0: The Insert View tool can be used instead.
Clip Group: inserts a clip group.
SVG Symbol: inserts a symbol from a SVG file into a page. introduced in 1.0: The Insert View tool can be used instead.
Bitmap Image: inserts a PNG or JPG bitmap image into a page. introduced in 1.0: The Insert View tool can be used instead.
Share View: shares a view between multiple pages.
Project Shape: creates projections of shapes in the 3D view.
Views from other workbenches[edit | edit source]
Active View: inserts a view of the active 3D view.
Draft View: inserts a view of a Draft Workbench object.
BIM View: inserts a view of a BIM Workbench Arch Section Plane object. introduced in 1.0: The Insert View tool can be used instead.
Spreadsheet View: inserts a view of a Spreadsheet Workbench sheet. introduced in 1.0: The Insert View tool can be used instead.
Stacking[edit | edit source]
These are tools for changing the stacking order which controls the apparent depth of views on a page.
Stack Top: moves views to the top of the stacking order. introduced in 0.21
Stack Bottom: moves views to the bottom of the stacking order. introduced in 0.21
Stack Up: moves views up one level in the stacking order. introduced in 0.21
Stack Down: moves views down one level in the stacking order. introduced in 0.21
Dimensions[edit | edit source]
Dimension: adds a contextual dimension. introduced in 1.0
Length Dimension: adds a length dimension.
Horizontal Dimension: adds a horizontal length dimension.
Vertical Dimension: adds a vertical length dimension.
Radius Dimension: adds a radius dimension to a circle or circular arc.
Diameter Dimension: adds a diameter dimension to a circle or a circular arc.
Angle Dimension: adds an angle dimension between two straight edges.
Angle Dimension From 3 Points: adds an angle dimension using three vertices.
Area Annotation: adds an area dimension to a face. introduced in 1.0
Arc Length Dimension: creates an arc length dimension.
Horizontal Extent Dimension: adds a horizontal extent dimension.
Vertical Extent Dimension: adds a vertical extent dimension.
Horizontal Chain Dimensions: creates a sequence of aligned horizontal dimensions.
Vertical Chain Dimensions: creates a sequence of aligned vertical dimensions.
Oblique Chain Dimensions: creates a sequence of aligned oblique dimensions.
Horizontal Coordinate Dimensions: creates multiple evenly spaced horizontal dimensions starting from the same baseline.
Vertical Coordinate Dimensions: creates multiple evenly spaced vertical dimensions starting from the same baseline.
Oblique Coordinate Dimensions: creates multiple evenly spaced oblique dimensions starting from the same baseline.
Horizontal Chamfer Dimension: creates a horizontal size and angle dimension for a chamfer.
Vertical Chamfer Dimension: creates a vertical size and angle dimension for a chamfer.
Balloon Annotation: adds a "balloon" annotation to a page.
Axonometric Length Dimension: adds an axonometric length dimension. introduced in 0.21
Dimension Repair: can adjust the 2D or 3D geometry references of a dimension. introduced in 0.21
Hatching[edit | edit source]
Image Hatch: applies a hatch pattern from a file to a face.
Geometric Hatch: applies a hatch pattern to a face using an Autodesk PAT specification.
Annotations[edit | edit source]
Text Annotation: adds a plain text block as annotation.
Leader Line: adds a leader line to a view.
Rich Text Annotation: adds an rich text block as annotation to a leaderline or a view.
Cosmetic Vertex: adds a Vertex which is not part of the source geometry.
Midpoint Vertices: adds Cosmetic Vertices at midpoints of selected edges.
Quadrant Vertices: adds Cosmetic Vertices at quarter points of selected (circular) edges.
Centerline 2 Faces: adds a centerline to selected face(s).
Centerline 2 Lines: adds a centerline between 2 lines.
Centerline 2 Points: adds a centerline between 2 points.
Cosmetic Line Through 2 points: adds a cosmetic line connecting 2 vertices.
Edit Line Appearance: changes the appearance of selected line(s).
Toggle Edge Visibility: shows/hides invisible lines/edges in a view.
Weld Symbol: adds welding specifications to an existing leaderline.
Surface Finish Symbol: adds a surface finish symbol to a page. introduced in 0.21
Hole/Shaft Fit: adds hole or shaft tolerances using ISO 286 to a dimension. introduced in 0.21
Extensions[edit | edit source]
Attributes and modifications[edit | edit source]
Select Line Attributes, Cascade Spacing and Delta Distance: selects the attributes (style, width and color) for new cosmetic lines and centerlines, and specifies the cascade spacing and delta distance.
Change Line Attributes: changes the attributes (style, width and color) of cosmetic lines and centerlines.
Extend Line: extends a cosmetic line or centerline at both ends.
Shorten Line: shortens a cosmetic line or centerline at both ends.
Toggle View Lock: locks or unlocks the position of a view.
Position Section View: orthogonally aligns a section view with its source view.
Horizontal Chain Dimension: aligns horizontal dimensions to create a chain dimension.
Vertical Chain Dimension: aligns vertical dimensions to create a chain dimension.
Oblique Chain Dimensions: aligns oblique dimensions to create a chain dimension.
Horizontal Coordinate Dimension: evenly spaces horizontal dimensions.
Vertical Coordinate Dimensions: evenly spaces vertical dimensions.
Oblique Coordinate Dimension: evenly spaces oblique dimensions.
Area Annotation: calculates the area of selected faces and inserts an area annotation.
Arc Length Annotation: calculates the arc length of selected edges and inserts an arc length annotation. introduced in 1.0
Customize Format Label: customizes the formatting of a balloon text or dimension text. GD&T symbols and other special character can be added.
Centerlines and threading[edit | edit source]
Circle Centerlines: adds centerlines to circles and arcs.
Bolt Circle Centerlines: adds centerlines to a circular pattern of circles.
Cosmetic Thread Hole Side View: adds a cosmetic thread to the side view of a hole.
Cosmetic Thread Hole Bottom View: adds a cosmetic thread to the top or bottom view of holes.
Cosmetic Thread Bolt Side View: adds a cosmetic thread to the side view of a bolt/screw/rod.
Cosmetic Thread Bolt Bottom View: adds a cosmetic thread to the top or bottom view of bolts/screws/rods.
Cosmetic Intersection Vertices: adds cosmetic vertices at the intersection(s) of selected edges.
Offset Vertex: adds a cosmetic vertex at a specified offset from a selected vertex. introduced in 1.0
Cosmetic 1 Point Circle: adds a cosmetic circle based on one vertex. introduced in 1.0
Cosmetic 2 Point Circle: adds a cosmetic circle based on two vertices.
Cosmetic 3 Point Circle: adds a cosmetic circle based on three vertices.
Cosmetic Arc: adds a cosmetic counter clockwise arc based on three vertices.
Cosmetic Parallel Line: adds a cosmetic line parallel to another line through a vertex.
Cosmetic Perpendicular Line: adds a cosmetic line perpendicular to another line through a vertex.
Dimensions[edit | edit source]
Several of the Extensions dimension tools are listed under Dimensions above.
Insert '⌀' Prefix: inserts a '⌀' symbol at the beginning of the dimension text.
Insert '□' Prefix: inserts a '□' symbol at the beginning of the dimension text.
Insert 'n×' Prefix: inserts a repeated feature count at the beginning of the dimension text. introduced in 1.0
Remove Prefix: removes all symbols at the beginning of the dimension text.
Increase Decimal Places: increases the number of decimal places of the dimension text.
Decrease Decimal Places: decreases the number of decimal places of the dimension text.
Miscellaneous[edit | edit source]
Remove Cosmetic Object: removes cosmetic objects from a page.
Obsolete tools[edit | edit source]
Add View to Clip Group: adds an existing view to a clip group. Not available in 1.0 and above.
Remove View from Clip Group: removes a view from a clip group. Not available in 1.0 and above.
Insert Landmark Dimension - EXPERIMENTAL: adds a landmark distance dimension. Not available in 1.1 and above.
Link Dimension to 3D Geometry: links an existing dimension to the 3D geometry (deprecated). Not available in 1.1 and above.
Move View: moves a view and its dependents to a different page. Not available in 1.0 and above.
Turn View Frames On/Off: turns the display of View frames, labels and vertices on or off. Not available in 1.1 and above.
Additional features[edit | edit source]
- Line Groups: to control the appearance of various types of lines.
- Templates: the default templates defined for the drawing pages.
- Hatching: explanation of the different hatching techniques.
- Geometric dimensioning and tolerancing: explanation on how to achieve geometric dimensioning and tolerancing.
Preferences[edit | edit source]
Preferences: preferences for the default values of the drawing page such as projection angle, colors, text sizes, and line styles.
Scripting[edit | edit source]
The TechDraw tools can be used in macros and from the Python console. For more information see:
Limitations[edit | edit source]
- Do not cut, copy and paste TechDraw objects in the Tree view as this generally does not work out well.
- Do not drag TechDraw objects in the Tree view with the mouse.
Tutorials[edit | edit source]
- Basic TechDraw Tutorial: introduction to creating drawings with the TechDraw Workbench.
- Creating a new template: instructions to create a new page template in Inkscape for using with the TechDraw Workbench.
- TechDraw TemplateGenerator: instructions to create a macro for generating a basic template.
- A "few" added lines of code result in a tool like the Macro TemplateHelper.
- Measurement Of Angles On Holes: instructions for adding centerlines and subsequent angle representations on holes.
- Miscellaneous: instructions for different settings like center marks, etc.
- TechDraw Pitch Circle Tutorial: instructions for adding a pitch circle.
Video tutorials by sliptonic
- TechDraw Workbench Part 1 (Basics), Part 2 (Dimensions), Part 3 (Multiview)
- TechDraw Workbench Part 4 (Section and Detail), Part 5 (Customizing Templates)
Development[edit | edit source]
Do you want to know about the future of the TechDraw Workbench? Visit the TechDraw Roadmap Page to learn more.
- Pages: Insert Default Page, Insert Page using Template, Update template fields, Redraw Page, Print All Pages, Export Page as SVG, Export Page as DXF
- Views:
- TechDraw views: Insert View, Insert Broken View, Insert Section View, Insert Complex Section View, Insert Detail View, Insert Projection Group, Insert Clip Group, Insert SVG Symbol, Insert Bitmap Image, Share View, Turn View Frames On/Off, Project Shape
- Views from other workbenches: Insert Active View, Insert Draft Workbench Object, Insert BIM Workbench Object, Insert Spreadsheet View
- Stacking: Move view to top of stack, Move view to bottom of stack, Move view up one level, Move view down one level
- Dimensions: Insert Dimension, Insert Length Dimension, Insert Horizontal Dimension, Insert Vertical Dimension, Insert Radius Dimension, Insert Diameter Dimension, Insert Angle Dimension, Insert 3-Point Angle Dimension, Insert Area Annotation, Create Arc Length Dimension, Insert Horizontal Extent Dimension, Insert Vertical Extent Dimension, Create Horizontal Chain Dimensions, Create Vertical Chain Dimensions, Create Oblique Chain Dimensions, Create Horizontal Coordinate Dimensions, Create Vertical Coordinate Dimensions, Create Oblique Coordinate Dimensions, Create Horizontal Chamfer Dimension, Create Vertical Chamfer Dimension, Insert Balloon Annotation, Insert Axonometric Length Dimension, Insert Landmark Dimension, Dimension Repair, Link Dimension to 3D Geometry
- Hatching: Hatch Face using Image File, Apply Geometric Hatch to Face,
- Annotations: Insert Annotation, Add Leaderline to View, Insert Rich Text Annotation, Add Cosmetic Vertex, Add Midpoint Vertices, Add Quadrant Vertices, Add Centerline to Faces, Add Centerline between 2 Lines, Add Centerline between 2 Points, Add Cosmetic Line Through 2 points, Add Cosmetic Circle, Change Appearance of Lines, Show/Hide Invisible Edges, Add Welding Information to Leader, Add Surface Finish Symbol, Add Hole or Shaft Tolerances
- Extensions:
- Attributes and modifications: Select Line Attributes, Cascade Spacing and Delta Distance, Change Line Attributes, Extend Line, Shorten Line, Lock/Unlock View, Position Section View, Position Horizontal Chain Dimensions, Position Vertical Chain Dimensions, Position Oblique Chain Dimensions, Cascade Horizontal Dimensions, Cascade Vertical Dimensions, Cascade Oblique Dimensions, Calculate the area of selected faces, Calculate the arc length of selected edges, Customize format label
- Centerlines and threading: Add Circle Centerlines, Add Bolt Circle Centerlines, Add Cosmetic Thread Hole Side View, Add Cosmetic Thread Hole Bottom View, Add Cosmetic Thread Bolt Side View, Add Cosmetic Thread Bolt Bottom View, Add Cosmetic Intersection Vertex(es), Add an offset vertex, Add Cosmetic Circle, Add Cosmetic Arc, Add Cosmetic Circle 3 Points, Add Cosmetic Parallel Line, Add Cosmetic Perpendicular Line
- Dimensions: Insert '⌀' Prefix, Insert '□' Prefix, Insert 'n×' Prefix, Remove Prefix, Increase Decimal Places, Decrease Decimal Places
- Miscellaneous: Remove Cosmetic Object
- Additional: Line Groups, Templates, Hatching, Geometric dimensioning and tolerancing, Preferences
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Assembly, BIM, CAM, Draft, FEM, Inspection, Material, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub