Difference between revisions of "TechDraw Module/id"

From FreeCAD Documentation
Jump to navigation Jump to search
(Updating to match new version of source page)
(Updating to match new version of source page)
(21 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<languages/>
 
<languages/>
{{docnav|[[Surface Module|Surface Module]]|[[Web_Workbench|Web Workbench]]|IconL=Workbench_Surface.svg|IconR=Workbench_Web.svg}}
+
{{Docnav
 +
|[[Surface Module|Surface Module]]
 +
|[[Web_Workbench|Web Workbench]]
 +
|IconL=Workbench_Surface.svg
 +
|IconR=Workbench_Web.svg
 +
}}
  
[[File:Workbench_TechDraw.svg|64px]]
+
[[File:Workbench_TechDraw.svg|240px|center]]
 +
{{Caption|align=center|The FreeCAD TechDraw Workbench Icon}}
  
 
== Introduction ==
 
== Introduction ==
  
The [[TechDraw Workbench|TechDraw Workbench]] is used to produce basic technical drawings from 3D models created with another workbench such as [[Part Workbench|Part]], [[PartDesign Workbench|PartDesign]], or [[Arch Workbench|Arch]], 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.
+
The [[Image:Workbench_TechDraw.svg|24px]] [[TechDraw Workbench|TechDraw Workbench]] is used to produce basic technical drawings from 3D models created with another workbench such as [[Part Workbench|Part]], [[PartDesign Workbench|PartDesign]], or [[Arch Workbench|Arch]], 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|SVG]] symbols can be added to the page, which can be further exported to different formats like [[DXF|DXF]], [[SVG|SVG]], and [[PDF|PDF]].
 
Dimensions, sections, hatched areas, annotations, and [[SVG|SVG]] symbols can be added to the page, which can be further exported to different formats like [[DXF|DXF]], [[SVG|SVG]], and [[PDF|PDF]].
Line 21: Line 27:
 
These are tools for creating Page objects.
 
These are tools for creating Page objects.
  
* [[File:TechDraw_New_Default.png|32px]] [[TechDraw_New_Default|New Default]]: adds a new page using the default [[TechDraw_Templates|template]].
+
* [[File:TechDraw PageDefault.svg|32px]] [[TechDraw_PageDefault|Insert Default Page]]: adds a new page using the default [[TechDraw_Templates|template]].
  
* [[File:TechDraw_New_Pick.png|32px]] [[TechDraw_New_Pick|New Pick]]: adds a new page using a selected [[TechDraw_Templates|template]].
+
* [[File:TechDraw PageTemplate.svg|32px]] [[TechDraw_PageTemplate|Insert Page using Template]]: adds a new page using a selected [[TechDraw_Templates|template]].
 +
 
 +
* [[File:TechDraw RedrawPage.svg|32px]] [[TechDraw_RedrawPage|Redraw Page]]: forces an update of the selected page. {{Version|0.19}}
  
 
== Views ==
 
== Views ==
Line 29: Line 37:
 
These are tools for creating View objects.
 
These are tools for creating View objects.
  
* [[File:techdraw-view.png|32px]] [[TechDraw_NewView|New View]]: adds a 2D projection view of an object.
+
* [[File:TechDraw View.svg|32px]] [[TechDraw_View|Insert View]]: adds a 2D projection view of an object.
  
* [[File:techdraw-projgroup.png|32px]] [[TechDraw_NewProjGroup|New Projection Group]]: invokes a dialog to create many views of an object from multiple directions.
+
* [[File:TechDraw ActiveView.svg|32px]] [[TechDraw_ActiveView|Insert Active View]]: inserts a view of the active 3D view. {{Version|0.19}}
  
* [[File:techdraw-viewsection.png|32px]] [[TechDraw_NewSection|New Section]]: adds a cross-section view of an existing view.
+
* [[File:TechDraw ProjectionGroup.svg|32px]] [[TechDraw_ProjectionGroup|Insert Projection Group]]: invokes a dialog to create many views of an object from multiple directions.
  
* [[File:techdraw-viewdetail.png|32px]] [[TechDraw_NewDetail|New Detail]]: adds a detail view of a portion of an existing view.
+
* [[File:TechDraw SectionView.svg|32px]] [[TechDraw_SectionView|Insert Section View]]: inserts a cross-section view of an existing view.
  
* [[File:techdraw-annotation.png|32px]] [[TechDraw_NewAnnotation|New Annotation]]: adds a text block to serve as an annotation.
+
* [[File:TechDraw DetailView.svg|32px]] [[TechDraw_DetailView|Insert Detail View]]: inserts a detail view of a portion of an existing view.
  
* [[File:techdraw-draft-view.png|32px]] [[TechDraw_NewDraft|New Draft]]: adds a view of a [[Draft Workbench|Draft Workbench]] object.
+
* [[File:TechDraw DraftView.svg|32px]] [[TechDraw_DraftView|Insert Draft Workbench Object]]: inserts a view of a [[Draft Workbench|Draft Workbench]] object.
  
* [[File:techdraw-arch-view.png|32px]] [[TechDraw_NewArch|New Arch]]: adds a view of a [[Arch Workbench|Arch Workbench]] [[Arch SectionPlane|SectionPlane]] object.
+
* [[File:TechDraw ArchView.svg|32px]] [[TechDraw_ArchView|Insert Arch Workbench Object]]: inserts a view of an [[Arch Workbench|Arch Workbench]] [[Arch SectionPlane|Section Plane]] object.
  
* [[File:techdraw-spreadsheet.svg|32px]] [[TechDraw_Spreadsheet|Spreadsheet]]: inserts a view of a [[Spreadsheet Workbench|Spreadsheet Workbench]] sheet.
+
* [[File:TechDraw SpreadsheetView.svg|32px]] [[TechDraw_SpreadsheetView|Insert Spreadsheet View]]: inserts a view of a [[Spreadsheet Workbench|Spreadsheet Workbench]] sheet.
  
 
== Clips ==
 
== Clips ==
Line 49: Line 57:
 
These are tools to create and manage Clip objects (clipped views).
 
These are tools to create and manage Clip objects (clipped views).
  
* [[File:techdraw-clip.svg|32px]] [[TechDraw_Clip|Clip]]: inserts a clip group into a page.
+
* [[File:TechDraw ClipGroup.svg|32px]] [[TechDraw_ClipGroup|Insert Clip Group]]: inserts a clip group into a page.
  
* [[File:techdraw-clipplus.svg|32px]] [[TechDraw_ClipPlus|ClipPlus]]: adds an existing view to a clip group.
+
* [[File:TechDraw ClipGroupAdd.svg|32px]] [[TechDraw_ClipGroupAdd|Add View to Clip Group]]: adds an existing view to a clip group.
  
* [[File:techdraw-clipminus.svg|32px]] [[TechDraw_ClipMinus|ClipMinus]]: removes a view from a clip group.
+
* [[File:TechDraw ClipGroupRemove.svg|32px]] [[TechDraw_ClipGroupRemove|Remove View from Clip Group]]: removes a view from a clip group.
  
 
== Dimensions ==
 
== Dimensions ==
Line 61: Line 69:
 
Linear dimensions can be based on two points, on one line, or on two lines.
 
Linear dimensions can be based on two points, on one line, or on two lines.
  
* [[File:Techdraw_Dimension_Length.png|32px]] [[TechDraw_Dimension_Length|New Length]]: adds a length dimension.
+
* [[File:TechDraw_Dimension_Length.svg|32px]] [[TechDraw_Dimension_Length|New Length]]: adds a length dimension.
 +
 
 +
* [[File:TechDraw_Dimension_Horizontal.svg|32px]] [[TechDraw_Dimension_Horizontal|New Horizontal]]: adds a horizontal length dimension.
 +
 
 +
* [[File:TechDraw_Dimension_Vertical.svg|32px]] [[TechDraw_Dimension_Vertical|New Vertical]]: adds a vertical length dimension.
 +
 
 +
* [[File:TechDraw_Dimension_Radius.svg|32px]] [[TechDraw_Dimension_Radius|New Radius]]: adds a radius dimension to a circle or circular arc.
  
* [[File:Techdraw_Dimension_Horizontal.png|32px]] [[TechDraw_Dimension_Horizontal|New Horizontal]]: adds a horizontal length dimension.
+
* [[File:TechDraw_Dimension_Diameter.svg|32px]] [[TechDraw_Dimension_Diameter|New Diameter]]: adds a diameter dimension to a circle or a circular arc.
  
* [[File:Techdraw_Dimension_Vertical.png|32px]] [[TechDraw_Dimension_Vertical|New Vertical]]: adds a vertical length dimension.
+
* [[File:TechDraw_Dimension_Angle.svg|32px]] [[TechDraw_Dimension_Angle|New Angle]]: adds an angle dimension between two straight edges.
  
* [[File:Techdraw_Dimension_Radius.png|32px]] [[TechDraw_Dimension_Radius|New Radius]]: adds a radius dimension to a circle or circular arc.
+
* [[File:TechDraw_Dimension_Angle3Pt.svg|32px]] [[TechDraw_Dimension_Angle3Pt|New Angle3Pt]]: adds an angle dimension using three vertices.
  
* [[File:Techdraw_Dimension_Diameter.png|32px]] [[TechDraw_Dimension_Diameter|New Diameter]]: adds a diameter dimension to a circle or a circular arc.
+
* [[File:TechDraw_Dimension_Link.svg|32px]] [[TechDraw_Dimension_Link|New Links]]: links an existing dimension to the 3D geometry.
  
* [[File:Techdraw_Dimension_Angle.png|32px]] [[TechDraw_Dimension_Angle|New Angle]]: adds an angle dimension between two straight edges.
+
* [[File:TechDraw_Balloon.svg|32px]] [[TechDraw_Balloon|New Balloon]]: adds a "balloon" annotation to a page. {{Version|0.19}}
  
* [[File:TechDraw_Dimension_Angle3Pt.png|32px]] [[TechDraw_Dimension_Angle3Pt|New Angle3Pt]]: adds an angle dimension using three vertices.
+
* [[File:TechDraw_Dimension_HExtent.svg|32px]] [[TechDraw Dimension Horizontal Extent|New Horizontal Extent]]: adds a horizontal extent dimension. {{Version|0.19}}
  
* [[File:Dimension_Link.png|32px]] [[TechDraw_Dimension_Link|New Links]]: links an existing dimension to the 3D geometry.
+
* [[File:TechDraw_Dimension_VExtent.svg|32px]] [[TechDraw Dimension Vertical Extent|New Vertical Extent]]: adds a vertical extent dimension. {{Version|0.19}}
  
 
== Import/Export ==
 
== Import/Export ==
Line 81: Line 95:
 
These are tools for exporting pages to other applications.
 
These are tools for exporting pages to other applications.
  
* [[File:techdraw-saveSVG.svg|32px]] [[TechDraw_SaveSVG|Save SVG]]: saves a page as an [[SVG|SVG]] file.
+
* [[File:TechDraw ExportPageSVG.svg|32px]] [[TechDraw_ExportPageSVG|Export Page as SVG]]: saves the current page as [[SVG|SVG]] file.
* [[File:techdraw-saveDXF.svg|32px]] [[TechDraw_SaveDXF|Save DXF]]: saves a page as a [[DXF|DXF]] file.
+
* [[File:TechDraw ExportPageDXF.svg|32px]] [[TechDraw_ExportPageDXF|Export Page as DXF]]: saves the current page as [[DXF|DXF]] file.
 +
 
 +
== Decorations ==
 +
 
 +
These are tools to decorate pages or views:
 +
 
 +
* [[File:TechDraw Hatch.svg|32px]] [[TechDraw_Hatch|Hatch Face using Image File]]: applies a hatch pattern from a file to a face.
 +
 
 +
* [[File:TechDraw GeometricHatch.svg|32px]] [[TechDraw_GeometricHatch|Apply Geometric Hatch to Face]]: applies a hatch pattern to a face using an Autodesk PAT specification.
 +
 
 +
* [[File:TechDraw Symbol.svg|32px]] [[TechDraw_Symbol|Insert SVG Symbol]]: inserts a symbol from a [[SVG|SVG]] file into a page.
 +
 
 +
* [[File:TechDraw Image.svg|32px]] [[TechDraw_Image|Insert Bitmap Image]]: inserts a PNG or JPG [[bitmap|bitmap]] image into a page.
  
== Decoration ==
+
* [[File:TechDraw ToggleFrame.svg|32px]] [[TechDraw_ToggleFrame|Turn View Frames On/Off]]: turns on/off frames and labels surrounding a view.
  
These are tools for changing the appearance of pages and views.
+
== Annotation ==
  
* [[File:techdraw-hatch.png|32px]] [[TechDraw_Hatch|Hatch Area]]: applies a hatch pattern from a file to a face.
+
The annotation tools are for "marking up" a drawing with additional information.
  
* [[File:techdraw-geomhatch.png|32px]] [[TechDraw_GeomHatch|Geometric Hatch]]: applies a hatch pattern to a face using an Autodesk PAT specification.
+
* [[File:TechDraw Annotation.svg|32px]] [[TechDraw_Annotation|Insert Annotation]]: adds a plain text block as annotation.
  
* [[File:techdraw-symbol.png|32px]] [[TechDraw_Symbol|New Symbol]]: inserts an [[SVG|SVG]] symbol into a page.
+
* [[File:TechDraw LeaderLine.svg|24px]] [[TechDraw_LeaderLine|Add Leaderline to View]]: adds an annotation line to a view. {{Version|0.19}}
  
* [[File:Techdraw-image.png|32px]] [[TechDraw_Image|New Image]]: inserts a PNG or JPG [[bitmap|bitmap]] image into a page.
+
* [[File:TechDraw RichTextAnnotation.svg|24px]] [[TechDraw_RichTextAnnotation|Insert Rich Text Annotation]]: adds an rich text block as annotation to a leaderline or a view. {{Version|0.19}}
  
* [[File:techdraw-toggleframe.png|32px]] [[TechDraw_Toggle|Toggle Frames]]: turns on and off the frames and labels surrounding a view.
+
* [[File:TechDraw CosmeticVertex.svg|24px]] [[TechDraw_CosmeticVertex|Add Cosmetic Vertex]]: adds a Vertex which is not part of the source geometry. {{Version|0.19}}
  
* [[File:TechDraw_Tree_Page_Sync.png|24px]] [[TechDraw_Redraw|Redraw]]: The Redraw tool attempts to redraw a page without recalculating the 3D model. (This tool was removed in v0.18)
+
* [[File:TechDraw Midpoints.svg|24px]] [[TechDraw_Midpoints|Add Midpoint Vertices]]: adds Cosmetic Vertices at midpoints of selected edges. {{Version|0.19}}
 +
 
 +
* [[File:TechDraw Quadrants.svg|24px]] [[TechDraw_Quadrants|Add Quadrant Vertices]]: adds Cosmetic Vertices at quarter points of selected (circular) edges. {{Version|0.19}}
 +
 
 +
* [[File:TechDraw FaceCenterLine.svg|24px]] [[TechDraw_FaceCenterLine|Add Centerline to Face(s)]]: adds a centerline to selected face(s). {{Version|0.19}}
 +
 
 +
* [[File:TechDraw 2LineCenterLine.svg|24px]] [[TechDraw_2LineCenterLine|Add Centerline between 2 Lines]]: adds a centerline between 2 lines. {{Version|0.19}}
 +
 
 +
* [[File:TechDraw 2PointCenterLine.svg|24px]] [[TechDraw_2PointCenterLine|Add Centerline between 2 Points]]: adds a centerline between 2 points. {{Version|0.19}}
 +
 
 +
* [[File:TechDraw CosmeticEraser.svg|24px]] [[TechDraw_CosmeticEraser|Remove Cosmetic Object]]: removes cosmetic objects from a page. {{Version|0.19}}
 +
 
 +
* [[File:TechDraw DecorateLine.svg|24px]] [[TechDraw_DecorateLine|Change Appearance of Line(s)]]: changes the appearance of selected line(s). {{Version|0.19}}
 +
 
 +
* [[File:TechDraw ShowAll.svg|24px]] [[TechDraw_ShowAll|Show/Hide Invisible Edges]]: shows/hides invisible lines/edges in a view. {{Version|0.19}}
 +
 
 +
* [[File:TechDraw WeldSymbol.svg|24px]] [[TechDraw_WeldSymbol|Add Welding Information to Leader]]: adds welding specifications to an existing leaderline. {{Version|0.19}}
  
 
== Additional features ==
 
== Additional features ==
  
 +
* [[TechDraw_LineGroup|Line Groups]]: to control the appearance of various types of lines.
 +
* [[TechDraw_Templates|Templates]]: the default templates defined for the drawing pages.
 
* [[TechDraw_Hatching|Hatching]]: explanation of the different hatching techniques.
 
* [[TechDraw_Hatching|Hatching]]: explanation of the different hatching techniques.
* [[TechDraw_LineGroup|Line Groups]]: default weights can be assigned to various line types.
 
* [[TechDraw_Templates|Templates]]: the default templates defined for the drawing pages.
 
  
 
== Preferences ==
 
== Preferences ==
Line 110: Line 152:
  
 
== Scripting ==
 
== Scripting ==
The TechDraw tools can be used in [[macros]] and from the [[Python|Python]] console by using two APIs.
+
The TechDraw tools can be used in [[macros|macros]] and from the [[Python|Python]] console by using two APIs.
 
* [[TechDraw API|TechDraw API]]
 
* [[TechDraw API|TechDraw API]]
 
* [[TechDrawGui API|TechDrawGui API]]
 
* [[TechDrawGui API|TechDrawGui API]]
Line 125: Line 167:
 
* [[TechDraw_TemplateHowTo|Creating a new template]]: instructions to create a new page template in Inkscape for using with the TechDraw Workbench.
 
* [[TechDraw_TemplateHowTo|Creating a new template]]: instructions to create a new page template in Inkscape for using with the TechDraw Workbench.
  
{{docnav|[[Surface Module|Surface Module]]|[[Web_Workbench|Web Workbench]]|IconL=Workbench_Surface.svg|IconR=Workbench_Web.svg}}
+
Video tutorials by sliptonic
 +
* TechDraw Workbench [https://www.youtube.com/watch?v=7LbOmSGW9F0 Part 1 (Basics)], [https://www.youtube.com/watch?v=z3w84RfvqaE Part 2 (Dimensions)], [https://www.youtube.com/watch?v=uNjXg-m38aI Part 3 (Multiview)]
 +
* TechDraw Workbench [https://www.youtube.com/watch?v=3zSdeFV6I5o Part 4 (Section and Detail)], [https://www.youtube.com/watch?v=kcmdJ7xa7gg Part 5 (Customizing Templates)]
 +
 
 +
{{Docnav
 +
|[[Surface Module|Surface Module]]
 +
|[[Web_Workbench|Web Workbench]]
 +
|IconL=Workbench_Surface.svg
 +
|IconR=Workbench_Web.svg
 +
}}
 +
 
 +
 
  
{{TechDraw Tools navi}}
+
{{TechDraw Tools navi{{#translation:}}}}
  
{{Userdocnavi}}
+
{{Userdocnavi{{#translation:}}}}
  
[[Category:Workbenches]]
+
[[Category:Workbenches{{#translation:}}]]

Revision as of 07:04, 20 February 2020

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Türkçe • ‎español • ‎français • ‎hrvatski • ‎italiano • ‎magyar • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎svenska • ‎čeština • ‎български • ‎русский • ‎українська • ‎中文 • ‎中文(中国大陆)‎ • ‎中文(台灣)‎ • ‎中文(繁體)‎ • ‎日本語
Workbench TechDraw.svg

The FreeCAD TechDraw Workbench Icon


Introduction

The Workbench TechDraw.svg TechDraw Workbench is used to produce basic technical drawings from 3D models created with another workbench such as Part, PartDesign, or Arch, 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.

TechDraw was officially included in FreeCAD starting with version 0.17; it is intended to replace the unsupported Drawing Workbench. Both workbenches are still provided in v0.17, but the Drawing Workbench may be removed in future releases. To keep up with TechDraw plans and developments, visit the TechDraw Roadmap.

FreeCAD is primarily a 3D modelling application, and thus doesn't have many 2D drawing tools, which are mostly included in the Draft and Sketcher Workbenches. If your primary goal is the production of complex 2D drawings and DXF files, and you don't need 3D modelling, you may wish to consider a dedicated software program for technical drafting such as LibreCAD, QCad, TurboCad, and others.

TechDraw Workbench Example.png

Pages

These are tools for creating Page objects.

Views

These are tools for creating View objects.

Clips

These are tools to create and manage Clip objects (clipped views).

Dimensions

These are tools for creating and working with Dimension objects.

Linear dimensions can be based on two points, on one line, or on two lines.

  • TechDraw Dimension Radius.svg New Radius: adds a radius dimension to a circle or circular arc.
  • TechDraw Dimension Diameter.svg New Diameter: adds a diameter dimension to a circle or a circular arc.
  • TechDraw Dimension Angle.svg New Angle: adds an angle dimension between two straight edges.
  • TechDraw Dimension Angle3Pt.svg New Angle3Pt: adds an angle dimension using three vertices.
  • TechDraw Dimension Link.svg New Links: links an existing dimension to the 3D geometry.

Import/Export

These are tools for exporting pages to other applications.

Decorations

These are tools to decorate pages or views:

Annotation

The annotation tools are for "marking up" a drawing with additional information.

Additional features

  • 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.

Preferences

  • Preferences-techdraw.svg Preferences: preferences for the default values of the drawing page such as projection angle, colors, text sizes, and line styles.

Scripting

The TechDraw tools can be used in macros and from the Python console by using two APIs.

Limitations

  • TechDraw drawings and its API are not interchangeable with the Drawing Workbench and its API. It is possible to convert Drawing Pages to TechDraw Pages using a Python script (moveViews.py).
  • It is possible to have both TechDraw and Drawing Pages in the same FreeCAD document, as each page is completely independent from each other.
  • There are minor differences in specifying editable texts in SVG templates compared to the Drawing module. In TechDraw the scaling of the SVG document affects the position of the editable text fields. See the forum discussion TechDraw templates scale for more details.
  • Do not cut, copy and paste TechDraw objects in the tree view as this generally does not work out well.

Tutorials

Video tutorials by sliptonic