TechDraw Workbench/hr: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(63 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
[[File:Workbench_TechDraw.svg|64px]]
|[[Surface_Workbench|Surface Workbench]]
|[[Web_Workbench|Web Workbench]]
|IconL=Workbench_Surface.svg
|IconR=Workbench_Web.svg
}}

[[Image:Workbench_TechDraw.svg|thumb|128px|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]].


If your primary goal is the production of complex 2D drawings and [[DXF|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 [https://en.wikipedia.org/wiki/LibreCAD LibreCAD] or [https://en.wikipedia.org/wiki/QCad QCad].
TechDraw was officially included in FreeCAD starting with version 0.17; it is intended to replace the unsupported [[Drawing Workbench|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|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 Workbench|Draft]] and [[Sketcher Workbench|Sketcher Workbench]]es. If your primary goal is the production of complex 2D drawings and [[DXF|DXF]] files, and you don't need 3D modelling, you may wish to consider a dedicated software program for technical drafting such as [https://en.wikipedia.org/wiki/LibreCAD LibreCAD], [https://en.wikipedia.org/wiki/QCad QCad], TurboCad, and others.


{{TOCright}}
{{TOCright}}

[[File:TechDraw Workbench Example.png|600px]]
[[File:TechDraw Workbench Example.png|600px]]


Line 21: Line 26:
These are tools for creating Page objects.
These are tools for creating Page objects.


* [[File:techdraw-new-default.svg|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.svg|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.

* [[File:TechDraw_PrintAll.svg|32px]] [[TechDraw_PrintAll|Print All Pages]]: prints all pages in a document. {{Version|0.21}}


== Views ==
== Views ==
Line 29: Line 38:
These are tools for creating View objects.
These are tools for creating View objects.


* [[File:techdraw-view.svg|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.svg|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.


* [[File:techdraw-viewsection.svg|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 multiple views of an object from different directions.


* <span id="TechDraw_SectionGroup">[[File:TechDraw_SectionView.svg|x32px]][[File:Toolbar_flyout_arrow_blue_background.svg|x32px]] Insert Section Views:</span><!--Do not edit span id: the TechDraw_SectionGroup pages redirect here-->
* [[File:techdraw-viewdetail.svg|32px]] [[TechDraw_NewDetail|New Detail]]: adds a detail view of a portion of an existing view.


* [[File:techdraw-draft-view.svg|32px]] [[TechDraw_NewDraft|New Draft]]: adds a view of a [[Draft Workbench|Draft Workbench]] object.
:* [[File:TechDraw_SectionView.svg|32px]] [[TechDraw_SectionView|Insert Simple Section View]]: inserts a cross-section view of an existing view.


* [[File:techdraw-arch-view.svg|32px]] [[TechDraw_NewArch|New Arch]]: adds a view of a [[Arch Workbench|Arch Workbench]] [[Arch SectionPlane|SectionPlane]] object.
:* [[File:TechDraw_ComplexSection.svg|32px]] [[TechDraw_ComplexSection|Insert Complex Section View]]: inserts a cross-section view of an existing view based on a profile. {{Version|0.21}}


* [[File:techdraw-spreadsheet.svg|32px]] [[TechDraw_Spreadsheet|Spreadsheet]]: inserts a view of a [[Spreadsheet Workbench|Spreadsheet Workbench]] sheet.
* [[File:TechDraw_DetailView.svg|32px]] [[TechDraw_DetailView|Insert Detail View]]: inserts a detail view of a portion of an existing view.

* [[File:TechDraw_DraftView.svg|32px]] [[TechDraw_DraftView|Insert Draft Workbench Object]]: inserts a view of a [[Draft_Workbench|Draft Workbench]] 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_SpreadsheetView.svg|32px]] [[TechDraw_SpreadsheetView|Insert Spreadsheet View]]: inserts a view of a [[Spreadsheet_Workbench|Spreadsheet Workbench]] sheet.

* [[File:TechDraw_MoveView.svg|32px]] [[TechDraw_MoveView|Move View]]: moves a view and its dependents to a different page. {{Version|0.20}}

* [[File:TechDraw_ShareView.svg|32px]] [[TechDraw_ShareView|Share View]]: shares a view between multiple pages. {{Version|0.20}}

* [[File:TechDraw_ProjectShape.svg|32px]] [[TechDraw_ProjectShape|Project Shape]]: creates projections of shapes in the [[3D_view|3D view]]. {{Version|0.20}}

== Stacking ==

These are tools for changing the stacking order which controls the apparent depth of views on a page.

* <span id="TechDraw_StackGroup">[[File:TechDraw_StackTop.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Adjust Stacking Order:</span><!--Do not edit span id: the TechDraw_StackGroup pages redirect here-->

:* [[File:TechDraw_StackTop.svg|32px]] [[TechDraw_StackTop|Move view to top of stack]]: moves views to the top of the stacking order. {{Version|0.21}}

:* [[File:TechDraw_StackBottom.svg|32px]] [[TechDraw_StackBottom|Move view to bottom of stack]]: moves views to the bottom of the stacking order. {{Version|0.21}}

:* [[File:TechDraw_StackUp.svg|32px]] [[TechDraw_StackUp|Move view up one level]]: moves views up one level in the stacking order. {{Version|0.21}}

:* [[File:TechDraw_StackDown.svg|32px]] [[TechDraw_StackDown|Move view down one level]]: moves views down one level in the stacking order. {{Version|0.21}}


== Clips ==
== Clips ==
Line 47: Line 82:
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_ClipGroupAdd.svg|32px]] [[TechDraw_ClipGroupAdd|Add View to Clip Group]]: adds an existing view to a clip group.

* [[File:TechDraw_ClipGroupRemove.svg|32px]] [[TechDraw_ClipGroupRemove|Remove View from Clip Group]]: removes a view from a clip group.

== 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-clipplus.svg|32px]] [[TechDraw_ClipPlus|ClipPlus]]: adds an existing view to a clip group.
* [[File:TechDraw_Image.svg|32px]] [[TechDraw_Image|Insert Bitmap Image]]: inserts a PNG or JPG [[bitmap|bitmap]] image into a page.


* [[File:techdraw-clipminus.svg|32px]] [[TechDraw_ClipMinus|ClipMinus]]: removes a view from a clip group.
* [[File:TechDraw_ToggleFrame.svg|32px]] [[TechDraw_ToggleFrame|Turn View Frames On/Off]]: turns on/off frames and labels surrounding a view.


== Dimensions ==
== Dimensions ==
Line 59: Line 108:
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.svg|32px]] [[TechDraw_Dimension_Length|New Length]]: adds a length dimension.
* [[File:TechDraw_LengthDimension.svg|32px]] [[TechDraw_LengthDimension|Insert Length Dimension]]: adds a length dimension.


* [[File:TechDraw_Dimension_Horizontal.svg|32px]] [[TechDraw_Dimension_Horizontal|New Horizontal]]: adds a horizontal length dimension.
* [[File:TechDraw_HorizontalDimension.svg|32px]] [[TechDraw_HorizontalDimension|Insert Horizontal Dimension]]: adds a horizontal length dimension.


* [[File:TechDraw_Dimension_Vertical.svg|32px]] [[TechDraw_Dimension_Vertical|New Vertical]]: adds a vertical length dimension.
* [[File:TechDraw_VerticalDimension.svg|32px]] [[TechDraw_VerticalDimension|Insert Vertical Dimension]]: 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_RadiusDimension.svg|32px]] [[TechDraw_RadiusDimension|Insert Radius Dimension]]: adds a radius dimension to a circle or circular arc.


* [[File:TechDraw_Dimension_Diameter.svg|32px]] [[TechDraw_Dimension_Diameter|New Diameter]]: adds a diameter dimension to a circle or a circular arc.
* [[File:TechDraw_DiameterDimension.svg|32px]] [[TechDraw_DiameterDimension|Insert Diameter Dimension]]: adds a diameter dimension to a circle or a circular arc.


* [[File:TechDraw_Dimension_Angle.svg|32px]] [[TechDraw_Dimension_Angle|New Angle]]: adds an angle dimension between two straight edges.
* [[File:TechDraw_AngleDimension.svg|32px]] [[TechDraw_AngleDimension|Insert Angle Dimension]]: adds an angle dimension between two straight edges.


* [[File:TechDraw_Dimension_Angle3Pt.svg|32px]] [[TechDraw_Dimension_Angle3Pt|New Angle3Pt]]: adds an angle dimension using three vertices.
* [[File:TechDraw_3PtAngleDimension.svg|32px]] [[TechDraw_3PtAngleDimension|Insert 3-Point Angle Dimension]]: adds an angle dimension using three vertices.


* <span id="TechDraw_ExtentGroup">[[File:TechDraw_HorizontalExtentDimension.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Insert Extent Dimensions:</span><!--Do not edit span id: the TechDraw_ExtentGroup pages redirect here-->
* [[File:TechDraw_Dimension_Link.svg|32px]] [[TechDraw_Dimension_Link|New Links]]: links an existing dimension to the 3D geometry.


* [[File:TechDraw_Balloon.svg|32px]] [[TechDraw_Balloon|New Balloon]]: adds a "balloon" annotation to a page. {{Version|0.19}}
:* [[File:TechDraw_HorizontalExtentDimension.svg|32px]] [[TechDraw_HorizontalExtentDimension|Insert Horizontal Extent Dimension]]: adds a horizontal extent dimension.


:* [[File:TechDraw_VerticalExtentDimension.svg|32px]] [[TechDraw_VerticalExtentDimension|Insert Vertical Extent Dimension]]: adds a vertical extent dimension.
== Import/Export ==


* [[File:TechDraw_LinkDimension.svg|32px]] [[TechDraw_LinkDimension|Link Dimension to 3D Geometry]]: links an existing dimension to the 3D geometry.
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_Balloon.svg|32px]] [[TechDraw_Balloon|Insert Balloon Annotation]]: adds a "balloon" annotation to a page.
* [[File:techdraw-saveDXF.svg|32px]] [[TechDraw_SaveDXF|Save DXF]]: saves a page as a [[DXF|DXF]] file.


* [[File:TechDraw_AxoLengthDimension.svg|32px]] [[TechDraw_AxoLengthDimension|Insert Axonometric Length Dimension]]: adds an axonometric length dimension. {{Version|0.21}}
== Decoration ==


* [[File:TechDraw_LandmarkDimension.svg|32px]] [[TechDraw_LandmarkDimension|Insert Landmark Dimension - EXPERIMENTAL]]: adds a landmark distance dimension.
These are tools for changing the appearance of pages and views.


* [[File:techdraw-hatch.svg|32px]] [[TechDraw_Hatch|Hatch Area]]: applies a hatch pattern from a file to a face.
* [[File:TechDraw_DimensionRepair.svg|32px]] [[TechDraw_DimensionRepair|Dimension Repair]]: can adjust the 2D or 3D geometry references of a dimension. {{Version|0.21}}


== Annotations ==
* [[File:techdraw-geomhatch.svg|32px]] [[TechDraw_GeomHatch|Geometric Hatch]]: applies a hatch pattern to a face using an Autodesk PAT specification.


The annotation tools are for "marking up" a drawing with additional information.
* [[File:techdraw-symbol.svg|32px]] [[TechDraw_Symbol|New Symbol]]: inserts an [[SVG|SVG]] symbol into a page.


* [[File:Techdraw-image.svg|32px]] [[TechDraw_Image|New Image]]: inserts a PNG or JPG [[bitmap|bitmap]] image into a page.
* [[File:TechDraw_Annotation.svg|32px]] [[TechDraw_Annotation|Insert Annotation]]: adds a plain text block as annotation.


* [[File:techdraw-toggleframe.svg|32px]] [[TechDraw_Toggle|Toggle Frames]]: turns on and off the frames and labels surrounding a view.
* [[File:TechDraw_LeaderLine.svg|32px]] [[TechDraw_LeaderLine|Add Leaderline to View]]: adds a leaderline to a view.


* [[File:TechDraw_RichTextAnnotation.svg|32px]] [[TechDraw_RichTextAnnotation|Insert Rich Text Annotation]]: adds an rich text block as annotation to a leaderline or a view.
* [[File:TechDraw_Tree_Page_Sync.svg|24px]] [[TechDraw_Redraw|Redraw]]: The Redraw tool attempts to redraw a page without recalculating the 3D model. (This tool was removed in v0.18)


* <span id="TechDraw_CosmeticVertexGroup">[[File:TechDraw_CosmeticVertex.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Add Cosmetic Vertices:</span><!--Do not edit span id: the TechDraw_CosmeticVertexGroup pages redirect here-->
== Annotation ==


:* [[File:TechDraw_CosmeticVertex.svg|32px]] [[TechDraw_CosmeticVertex|Add Cosmetic Vertex]]: adds a Vertex which is not part of the source geometry.
The annotation tools are for "marking up" a drawing with additional information.


* [[File:techdraw-annotation.svg|32px]] [[TechDraw_NewAnnotation|New Annotation]]: adds a plain text block to serve as an annotation.
:* [[File:TechDraw_Midpoints.svg|32px]] [[TechDraw_Midpoints|Add Midpoint Vertices]]: adds Cosmetic Vertices at midpoints of selected edges.


:* [[File:TechDraw_Quadrants.svg|32px]] [[TechDraw_Quadrants|Add Quadrant Vertices]]: adds Cosmetic Vertices at quarter points of selected (circular) edges.
* [[File:techdraw-mline.svg|24px]] [[TechDraw_LeaderLine|Leader Line]]: The Leader Line tool adds an annotation line to a view. {{Version|0.19}}


* <span id="TechDraw_CenterLineGroup">[[File:TechDraw_FaceCenterLine.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Add Centerlines:</span><!--Do not edit span id: the TechDraw_CenterLineGroup pages redirect here-->
* [[File:techdraw-textleader.svg|24px]] [[TechDraw_RichTextBlock|Rich Text Block]]: The Rich Text Block tool adds an rich text annotation block to a [[TechDraw_LeaderLine|Leader Line]] or a View. {{Version|0.19}}


:* [[File:TechDraw_FaceCenterLine.svg|32px]] [[TechDraw_FaceCenterLine|Add Centerline to Faces]]: adds a centerline to selected face(s).
* [[File:techdraw-point.svg|24px]] [[TechDraw_CosmeticVertex|Cosmetic Vertex]]: The Cosmetic Vertex tool adds a Vertex which is not part of the source geometry. {{Version|0.19}}


:* [[File:TechDraw 2LineCenterLine.svg|32px]] [[TechDraw_2LineCenterLine|Add Centerline between 2 Lines]]: adds a centerline between 2 lines.
* [[File:techdraw-midpoint.svg|24px]] [[TechDraw_Midpoints|Midpoints]]: The Midpoints tool adds Cosmetic Vertices at the midpoints of one or more Edges. {{Version|0.19}}


:* [[File:TechDraw 2PointCenterLine.svg|32px]] [[TechDraw_2PointCenterLine|Add Centerline between 2 Points]]: adds a centerline between 2 points.
* [[File:techdraw-quadrant.svg|24px]] [[TechDraw_Quadrant|Quadrant]]: The Quadrant tool adds Cosmetic Vertices at the quarter points of one or more (circular) Edges. {{Version|0.19}}


* [[File:TechDraw_2PointCosmeticLine.svg|32px]] [[TechDraw_2PointCosmeticLine|Add Cosmetic Line Through 2 points]]: adds a cosmetic line connecting 2 vertices.
* [[File:techdraw-facecenterline.svg|24px]] [[TechDraw_FaceCenterLine|FaceCenterLine]]: The FaceCenterLine tool adds a center line to selected Face(s). {{Version|0.19}}


* [[File:techdraw-2linecenterline.svg|24px]] [[TechDraw_2LineCenterLine|2LineCenterLine]]: The 2LineCenterLine tool adds a center line between 2 Edges. {{Version|0.19}}
* [[File:TechDraw_CosmeticCircle.svg|32px]] [[TechDraw_CosmeticCircle|Add Cosmetic Circle]]: adds a cosmetic circle. {{Version|0.22}}


* [[File:TechDraw_CosmeticEraser.svg|32px]] [[TechDraw_CosmeticEraser|Remove Cosmetic Object]]: removes cosmetic objects from a page.
* [[File:techdraw-2pointcenterline.svg|24px]] [[TechDraw_2PointCenterLine|2PointCenterLine]]: The 2PointCenterLine tool adds a center line between 2 Points. {{Version|0.19}}


* [[File:TechDraw_DecorateLine.svg|32px]] [[TechDraw_DecorateLine|Change Appearance of Lines]]: changes the appearance of selected line(s).
* [[File:techdraw-eraser.svg|24px]] [[TechDraw_CosmeticEraser|CosmeticEraser]]: The CosmeticEraser tool removes cosmetic objects from a Page. {{Version|0.19}}


* [[File:TechDraw_ShowAll.svg|32px]] [[TechDraw_ShowAll|Show/Hide Invisible Edges]]: shows/hides invisible lines/edges in a view.
* [[File:techdraw-linedecor.svg|24px]] [[TechDraw_DecorateLine|DecorateLine]]: The DecorateLine tool changes the appearance of Edges. {{Version|0.19}}

* [[File:TechDraw_WeldSymbol.svg|32px]] [[TechDraw_WeldSymbol|Add Welding Information to Leader]]: adds welding specifications to an existing leaderline.

* [[File:TechDraw_SurfaceFinishSymbol.svg|32px]] [[TechDraw_SurfaceFinishSymbol|Add Surface Finish Symbol]]: adds a surface finish symbol to a page. {{Version|0.21}}

* [[File:TechDraw_HoleShaftFit.svg|32px]] [[TechDraw_HoleShaftFit|Add Hole/Shaft Fit]]: adds hole or shaft tolerances using ISO 286 to a dimension. {{Version|0.21}}

== Extensions ==

These are tools to improve your TechDraw drawings.

=== Attributes and modifications ===

* [[File:TechDraw_ExtensionSelectLineAttributes.svg|32px]] [[TechDraw_ExtensionSelectLineAttributes|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. {{Version|0.20}}

* [[File:TechDraw_ExtensionChangeLineAttributes.svg|32px]] [[TechDraw_ExtensionChangeLineAttributes|Change Line Attributes]]: changes the attributes (style, width and color) of cosmetic lines and centerlines. {{Version|0.20}}

* <span id="TechDraw_ExtensionExtendShortenLineGroup">[[File:TechDraw_ExtensionExtendLine.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Change Length of Cosmetic Lines or Centerlines:</span><!--Do not edit span id: the TechDraw_ExtensionExtendShortenLineGroup pages redirect here-->

:* [[File:TechDraw_ExtensionExtendLine.svg|32px]] [[TechDraw_ExtensionExtendLine|Extend Line]]: extends a cosmetic line or centerline at both ends. {{Version|0.20}}

:* [[File:TechDraw_ExtensionShortenLine.svg|32px]] [[TechDraw_ExtensionShortenLine|Shorten Line]]: shortens a cosmetic line or centerline at both ends. {{Version|0.20}}

* [[File:TechDraw_ExtensionLockUnlockView.svg|32px]] [[TechDraw_ExtensionLockUnlockView|Lock/Unlock View]]: locks or unlocks the position of a view. {{Version|0.20}}

* [[File:TechDraw_ExtensionPositionSectionView.svg|32px]] [[TechDraw_ExtensionPositionSectionView|Position Section View]]: orthogonally aligns a section view with its source view. {{Version|0.20}}

* <span id="TechDraw_ExtensionPosChainDimensionGroup">[[File:TechDraw_ExtensionPosHorizChainDimension.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Align Dimensions:</span><!--Do not edit span id: the TechDraw_ExtensionPosChainDimensionGroup pages redirect here-->

:* [[File:TechDraw_ExtensionPosHorizChainDimension.svg|32px]] [[TechDraw_ExtensionPosHorizChainDimension|Position Horizontal Chain Dimensions]]: aligns horizontal dimensions to create a chain dimension. {{Version|0.20}}

:* [[File:TechDraw_ExtensionPosVertChainDimension.svg|32px]] [[TechDraw_ExtensionPosVertChainDimension|Position Vertical Chain Dimensions]]: aligns vertical dimensions to create a chain dimension. {{Version|0.20}}

:* [[File:TechDraw_ExtensionPosObliqueChainDimension.svg|32px]] [[TechDraw_ExtensionPosObliqueChainDimension|Position Oblique Chain Dimensions]]: aligns oblique dimensions to create a chain dimension. {{Version|0.20}}

* <span id="TechDraw_ExtensionCascadeDimensionGroup">[[File:TechDraw_ExtensionCascadeHorizDimension.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Evenly Space Dimensions:</span><!--Do not edit span id: the TechDraw_ExtensionCascadeDimensionGroup pages redirect here-->

:* [[File:TechDraw_ExtensionCascadeHorizDimension.svg|32px]] [[TechDraw_ExtensionCascadeHorizDimension|Cascade Horizontal Dimensions]]: evenly spaces horizontal dimensions. {{Version|0.20}}

:* [[File:TechDraw_ExtensionCascadeVertDimension.svg|32px]] [[TechDraw_ExtensionCascadeVertDimension|Cascade Vertical Dimensions]]: evenly spaces vertical dimensions. {{Version|0.20}}

:* [[File:TechDraw_ExtensionCascadeObliqueDimension.svg|32px]] [[TechDraw_ExtensionCascadeObliqueDimension|Cascade Oblique Dimensions]]: evenly spaces oblique dimensions. {{Version|0.20}}

* [[File:TechDraw_ExtensionAreaAnnotation.svg|32px]] [[TechDraw_ExtensionAreaAnnotation|Calculate the area of selected faces]]: calculates the area of selected faces and inserts an area annotation. {{Version|0.20}}

* [[File:TechDraw_ExtensionArcLengthAnnotation.svg|32px]] [[TechDraw_ExtensionArcLengthAnnotation|Calculate the arc length of selected edges]]: calculates the arc length of selected edges and inserts an arc length annotation. {{Version|0.22}}

* [[File:TechDraw_ExtensionCustomizeFormat.svg|32px]] [[TechDraw_ExtensionCustomizeFormat|Customize format label]]: customizes the formatting of a balloon text or dimension text. GD&T symbols and other special character can be added. {{Version|0.20}}

=== Centerlines and threading ===

* <span id="TechDraw_ExtensionCircleCenterLinesGroup">[[File:TechDraw_ExtensionCircleCenterLines.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Add Centerlines:</span><!--Do not edit span id: the TechDraw_ExtensionCircleCenterLinesGroup pages redirect here-->

:* [[File:TechDraw_ExtensionCircleCenterLines.svg|32px]] [[TechDraw_ExtensionCircleCenterLines|Add Circle Centerlines]]: adds centerlines to circles and arcs. {{Version|0.20}}

:* [[File:TechDraw_ExtensionHoleCircle.svg|32px]] [[TechDraw_ExtensionHoleCircle|Add Bolt Circle Centerlines]]: adds centerlines to a circular pattern of circles. {{Version|0.20}}

* <span id="TechDraw_ExtensionThreadsGroup">[[File:TechDraw_ExtensionThreadHoleSide.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Add Cosmetic Threads:</span><!--Do not edit span id: the TechDraw_ExtensionThreadsGroup pages redirect here-->

:* [[File:TechDraw_ExtensionThreadHoleSide.svg|32px]] [[TechDraw_ExtensionThreadHoleSide|Add Cosmetic Thread Hole Side View]]: adds a cosmetic thread to the side view of a hole. {{Version|0.20}}

:* [[File:TechDraw_ExtensionThreadHoleBottom.svg|32px]] [[TechDraw_ExtensionThreadHoleBottom|Add Cosmetic Thread Hole Bottom View]]: adds a cosmetic thread to the top or bottom view of holes. {{Version|0.20}}

:* [[File:TechDraw_ExtensionThreadBoltSide.svg|32px]] [[TechDraw_ExtensionThreadBoltSide|Add Cosmetic Thread Bolt Side View]]: adds a cosmetic thread to the side view of a bolt/screw/rod. {{Version|0.20}}

:* [[File:TechDraw_ExtensionThreadBoltBottom.svg|32px]] [[TechDraw_ExtensionThreadBoltBottom|Add Cosmetic Thread Bolt Bottom View]]: adds a cosmetic thread to the top or bottom view of bolts/screws/rods. {{Version|0.20}}

* <span id="TechDraw_CommandVertexCreationGroup">[[File:TechDraw_ExtensionVertexAtIntersection.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Add Vertexes:</span><!--Do not edit span id: the TechDraw_CommandVertexCreationGroup pages redirect here-->

:* [[File:TechDraw_ExtensionVertexAtIntersection.svg|32px]] [[TechDraw_ExtensionVertexAtIntersection|Add Cosmetic Intersection Vertex(es)]]: adds cosmetic vertex(es) at the intersection(s) of selected edges. {{Version|0.20}}

:* [[File:TechDraw_CommandAddOffsetVertex.svg|32px]] [[TechDraw_CommandAddOffsetVertex|Add an offset vertex]]: adds a cosmetic vertex at a specified offset from a selected vertex. {{Version|0.22}}

* <span id="TechDraw_ExtensionDrawCirclesGroup">[[File:TechDraw_ExtensionDrawCosmCircle.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Add Cosmetic Circles or Arcs:</span><!--Do not edit span id: the TechDraw_ExtensionDrawCirclesGroup pages redirect here-->

:* [[File:TechDraw_ExtensionDrawCosmCircle.svg|32px]] [[TechDraw_ExtensionDrawCosmCircle|Add Cosmetic Circle]]: adds a cosmetic circle based on two vertexes. {{Version|0.20}}

:* [[File:TechDraw_ExtensionDrawCosmArc.svg|32px]] [[TechDraw_ExtensionDrawCosmArc|Add Cosmetic Arc]]: adds a cosmetic counter clockwise arc based on three vertexes. {{Version|0.20}}

:* [[File:TechDraw_ExtensionDrawCosmCircle3Points.svg|32px]] [[TechDraw_ExtensionDrawCosmCircle3Points|Add Cosmetic Circle 3 Points]]: adds a cosmetic circle based on three vertexes. {{Version|0.20}}

* <span id="TechDraw_ExtensionLinePPGroup">[[File:TechDraw_ExtensionLineParallel.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Add Cosmetic Parallel or Perpendicular Lines:</span><!--Do not edit span id: the TechDraw_ExtensionLinePPGroup pages redirect here-->

:* [[File:TechDraw_ExtensionLineParallel.svg|32px]] [[TechDraw_ExtensionLineParallel|Add Cosmetic Parallel Line]]: adds a cosmetic line parallel to another line through a vertex. {{Version|0.20}}

:* [[File:TechDraw_ExtensionLinePerpendicular.svg|32px]] [[TechDraw_ExtensionLinePerpendicular|Add Cosmetic Perpendicular Line]]: adds a cosmetic line perpendicular to another line through a vertex. {{Version|0.20}}

=== Dimensions ===

* <span id="TechDraw_ExtensionCreateChainDimensionGroup">[[File:TechDraw_ExtensionCreateHorizChainDimension.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Create Chain Dimensions:</span><!--Do not edit span id: the TechDraw_ExtensionCreateChainDimensionGroup pages redirect here-->

:* [[File:TechDraw_ExtensionCreateHorizChainDimension.svg|32px]] [[TechDraw_ExtensionCreateHorizChainDimension|Create Horizontal Chain Dimensions]]: creates a sequence of aligned horizontal dimensions. {{Version|0.20}}

:* [[File:TechDraw_ExtensionCreateVertChainDimension.svg|32px]] [[TechDraw_ExtensionCreateVertChainDimension|Create Vertical Chain Dimensions]]: creates a sequence of aligned vertical dimensions. {{Version|0.20}}

:* [[File:TechDraw_ExtensionCreateObliqueChainDimension.svg|32px]] [[TechDraw_ExtensionCreateObliqueChainDimension|Create Oblique Chain Dimensions]]: creates a sequence of aligned oblique dimensions. {{Version|0.20}}

* <span id="TechDraw_ExtensionCreateCoordDimensionGroup">[[File:TechDraw_ExtensionCreateHorizCoordDimension.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Create Coordinate Dimensions:</span><!--Do not edit span id: the TechDraw_ExtensionCreateCoordDimensionGroup pages redirect here-->

:* [[File:TechDraw_ExtensionCreateHorizCoordDimension.svg|32px]] [[TechDraw_ExtensionCreateHorizCoordDimension|Create Horizontal Coordinate Dimensions]]: creates multiple evenly spaced horizontal dimensions starting from the same baseline. {{Version|0.20}}

:* [[File:TechDraw_ExtensionCreateVertCoordDimension.svg|32px]] [[TechDraw_ExtensionCreateVertCoordDimension|Create Vertical Coordinate Dimensions]]: creates multiple evenly spaced vertical dimensions starting from the same baseline. {{Version|0.20}}

:* [[File:TechDraw_ExtensionCreateObliqueCoordDimension.svg|32px]] [[TechDraw_ExtensionCreateObliqueCoordDimension|Create Oblique Coordinate Dimensions]]: creates multiple evenly spaced oblique dimensions starting from the same baseline. {{Version|0.20}}

* <span id="TechDraw_ExtensionChamferDimensionGroup">[[File:TechDraw_ExtensionCreateHorizChamferDimension.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Create Chamfer Dimensions:</span><!--Do not edit span id: the TechDraw_ExtensionChamferDimensionGroup pages redirect here-->

:* [[File:TechDraw_ExtensionCreateHorizChamferDimension.svg|32px]] [[TechDraw_ExtensionCreateHorizChamferDimension|Create Horizontal Chamfer Dimension]]: creates a horizontal size and angle dimension for a chamfer. {{Version|0.20}}

:* [[File:TechDraw_ExtensionCreateVertChamferDimension.svg|32px]] [[TechDraw_ExtensionCreateVertChamferDimension|Create Vertical Chamfer Dimension]]: creates a vertical size and angle dimension for a chamfer. {{Version|0.20}}

* [[File:TechDraw_ExtensionCreateLengthArc.svg|32px]] [[TechDraw_ExtensionCreateLengthArc|Create Arc Length Dimension]]: creates an arc length dimension. {{Version|0.20}}

* <span id="TechDraw_ExtensionInsertPrefixGroup">[[File:TechDraw_ExtensionInsertDiameter.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Insert Prefix:</span><!--Do not edit span id: the TechDraw_ExtensionInsertPrefixGroup pages redirect here-->

:* [[File:TechDraw_ExtensionInsertDiameter.svg|32px]] [[TechDraw_ExtensionInsertDiameter|Insert '⌀' Prefix]]: inserts a '⌀' symbol at the beginning of the dimension text. {{Version|0.20}}

:* [[File:TechDraw_ExtensionInsertSquare.svg|32px]] [[TechDraw_ExtensionInsertSquare|Insert '〼' Prefix]]: inserts a '〼' symbol at the beginning of the dimension text. {{Version|0.20}}

:* [[File:TechDraw_ExtensionRemovePrefixChar.svg|32px]] [[TechDraw_ExtensionRemovePrefixChar|Remove Prefix]]: removes all symbols at the beginning of the dimension text. {{Version|0.20}}

* <span id="TechDraw_ExtensionIncreaseDecreaseGroup">[[File:TechDraw_ExtensionIncreaseDecimal.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Change Decimal Places:</span><!--Do not edit span id: the TechDraw_ExtensionIncreaseDecreaseGroup pages redirect here-->

:* [[File:TechDraw_ExtensionIncreaseDecimal.svg|32px]] [[TechDraw_ExtensionIncreaseDecimal|Increase Decimal Places]]: increases the number of decimal places of the dimension text. {{Version|0.20}}

:* [[File:TechDraw_ExtensionDecreaseDecimal.svg|32px]] [[TechDraw_ExtensionDecreaseDecimal|Decrease Decimal Places]]: decreases the number of decimal places of the dimension text. {{Version|0.20}}

== Export ==

These are tools for exporting pages to other applications.

* [[File:TechDraw_ExportPageSVG.svg|32px]] [[TechDraw_ExportPageSVG|Export Page as SVG]]: saves the current page as [[SVG|SVG]] file.

* [[File:TechDraw_ExportPageDXF.svg|32px]] [[TechDraw_ExportPageDXF|Export Page as DXF]]: saves the current page as [[DXF|DXF]] file.


== Additional features ==
== Additional features ==


* [[TechDraw_LineGroup|Line Groups]]: to control the appearance of various types of lines.
* [[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.
* [[TechDraw_Templates|Templates]]: the default templates defined for the drawing pages.
* [[TechDraw_Hatching|Hatching]]: explanation of the different hatching techniques.
* [[TechDraw_Geometric_dimensioning_and_tolerancing|Geometric dimensioning and tolerancing]]: explanation on how to achieve geometric dimensioning and tolerancing.


== Preferences ==
== Preferences ==

* [[File:Preferences-techdraw.svg|32px]] [[TechDraw_Preferences|Preferences]]: preferences for the default values of the drawing page such as projection angle, colors, text sizes, and line styles.
* [[File:Preferences-techdraw.svg|32px]] [[TechDraw_Preferences|Preferences]]: preferences for the default values of the drawing page such as projection angle, colors, text sizes, and line styles.


== 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. For more information see:
* [[TechDraw API|TechDraw API]]
* [https://freecad.github.io/SourceDoc/ Autogenerated API documentation]
* [[TechDrawGui API|TechDrawGui API]]
* [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]]
* [[TechDraw_PageDefault#Editable_text_fields|Editable Text Fields]]


== Limitations ==
== Limitations ==

* TechDraw drawings and its API are not interchangeable with the [[Drawing Workbench|Drawing Workbench]] and its API. It is possible to convert Drawing Pages to TechDraw Pages using a Python script ({{incode|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.
* Do not cut, copy and paste TechDraw objects in the [[Tree_view|Tree view]] as this generally does not work out well.
* Do not drag TechDraw objects in the [[Tree_view|Tree view]] with the mouse.
* There are minor differences in specifying editable texts in [[SVG|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 [https://forum.freecadweb.org/viewtopic.php?f=3&t=24981&p=196271#p196271 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 ==
== Tutorials ==
Line 150: Line 335:
* [[Basic TechDraw Tutorial|Basic TechDraw Tutorial]]: introduction to creating drawings with the TechDraw Workbench.
* [[Basic TechDraw Tutorial|Basic TechDraw Tutorial]]: introduction to creating drawings 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.
* [[TechDraw_TemplateHowTo|Creating a new template]]: instructions to create a new page template in Inkscape for using with the TechDraw Workbench.
* [[TechDraw_TemplateGenerator|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|Macro TemplateHelper]].
* [[Measurement Of Angles On Holes|Measurement Of Angles On Holes]]: instructions for adding centerlines and subsequent angle representations on holes.
* [[TechDraw HowTo Page|Miscellaneous]]: instructions for different settings like center marks, etc.
* [[TechDraw_Pitch_Circle_Tutorial|TechDraw Pitch Circle Tutorial]]: instructions for adding a pitch circle.


Video tutorials by sliptonic
Video tutorials by sliptonic
Line 155: Line 345:
* 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)]
* 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)]


== Development ==
{{docnav|[[Surface Module|Surface Module]]|[[Web_Workbench|Web Workbench]]|IconL=Workbench_Surface.svg|IconR=Workbench_Web.svg}}

Do you want to know about the future of the TechDraw Workbench? Visit [[TechDraw_Roadmap|the TechDraw Roadmap Page]] to learn more.


{{TechDraw Tools navi}}


{{Docnav
{{Userdocnavi}}
|[[Surface_Workbench|Surface Workbench]]
|[[Web_Workbench|Web Workbench]]
|IconL=Workbench_Surface.svg
|IconR=Workbench_Web.svg
}}


{{TechDraw_Tools_navi{{#translation:}}}}
[[Category:Workbenches]]
{{Userdocnavi{{#translation:}}}}
[[Category:Workbenches{{#translation:}}]]

Latest revision as of 13:08, 24 December 2023

TechDraw workbench icon

Introduction

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

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.

Pages

These are tools for creating Page objects.

Views

These are tools for creating View objects.

  • Insert Section Views:

Stacking

These are tools for changing the stacking order which controls the apparent depth of views on a page.

  • Adjust Stacking Order:

Clips

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

Decorations

These are tools to decorate pages or 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.

  • Insert Extent Dimensions:

Annotations

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

  • Add Cosmetic Vertices:
  • Add Centerlines:

Extensions

These are tools to improve your TechDraw drawings.

Attributes and modifications

  • Change Length of Cosmetic Lines or Centerlines:
  • Align Dimensions:
  • Evenly Space Dimensions:

Centerlines and threading

  • Add Centerlines:
  • Add Cosmetic Threads:
  • Add Vertexes:
  • Add Cosmetic Circles or Arcs:
  • Add Cosmetic Parallel or Perpendicular Lines:

Dimensions

  • Create Chain Dimensions:
  • Create Coordinate Dimensions:
  • Create Chamfer Dimensions:
  • Insert Prefix:
  • Change Decimal Places:

Export

These are tools for exporting pages to other applications.

Additional features

Preferences

  • 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. For more information see:

Limitations

  • 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

A "few" added lines of code result in a tool like the Macro TemplateHelper.

Video tutorials by sliptonic

Development

Do you want to know about the future of the TechDraw Workbench? Visit the TechDraw Roadmap Page to learn more.