TechDraw Workbench: Difference between revisions

From FreeCAD Documentation
(Added command group structure.)
(Docnav)
 
(66 intermediate revisions by 8 users not shown)
Line 5: Line 5:
{{Docnav
{{Docnav
|[[Surface_Workbench|Surface Workbench]]
|[[Surface_Workbench|Surface Workbench]]
|[[External_workbenches|External workbenches]]
|[[Web_Workbench|Web Workbench]]
|IconL=Workbench_Surface.svg
|IconL=Workbench_Surface.svg
|IconR=Workbench_Web.svg
|IconR=AddonManager.svg
}}
}}


Line 20: Line 20:
<!--T:15-->
<!--T:15-->
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]].

<!--T:58-->
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]].


<!--T:11-->
<!--T:11-->
Line 44: Line 41:
<!--T:20-->
<!--T:20-->
* [[File:TechDraw_PageTemplate.svg|32px]] [[TechDraw_PageTemplate|Insert Page using Template]]: 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]].

<!--T:401-->
* [[File:TechDraw_FillTemplateFields.svg|32px]] [[TechDraw_FillTemplateFields|Update template fields]]: {{Version|1.0}}


<!--T:304-->
<!--T:304-->
* [[File:TechDraw_RedrawPage.svg|32px]] [[TechDraw_RedrawPage|Redraw Page]]: forces an update of the selected page. {{Version|0.19}}
* [[File:TechDraw_RedrawPage.svg|32px]] [[TechDraw_RedrawPage|Redraw Page]]: forces an update of the selected page.


<!--T:363-->
<!--T:363-->
* [[File:TechDraw_PrintAll.svg|32px]] [[TechDraw_PrintAll|Print All Pages]]: prints all pages in a document. {{Version|1.0}}
* [[File:TechDraw_PrintAll.svg|32px]] [[TechDraw_PrintAll|Print All Pages]]: prints all pages in a document. {{Version|0.21}}


== Views == <!--T:21-->
== Views == <!--T:21-->
Line 57: Line 57:


<!--T:23-->
<!--T:23-->
* [[File:TechDraw View.svg|32px]] [[TechDraw_View|Insert 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.

<!--T:400-->
* [[File:TechDraw_BrokenView.svg|32px]] [[TechDraw_BrokenView|Insert BrokenView]]: adds a broken view of one or more objects. {{Version|1.0}}


<!--T:301-->
<!--T:301-->
* [[File:TechDraw ActiveView.svg|32px]] [[TechDraw_ActiveView|Insert Active View]]: inserts a view of the active 3D view. {{Version|0.19}}
* [[File:TechDraw_ActiveView.svg|32px]] [[TechDraw_ActiveView|Insert Active View]]: inserts a view of the active 3D view.


<!--T:24-->
<!--T:24-->
* [[File:TechDraw_ProjectionGroup.svg|32px]] [[TechDraw_ProjectionGroup|Insert Projection Group]]: invokes a dialog to create multiple views of an object from different directions.
* [[File:TechDraw_ProjectionGroup.svg|32px]] [[TechDraw_ProjectionGroup|Insert Projection Group]]: invokes a dialog to create multiple views of an object from different directions.

<!--T:388-->
* <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-->


<!--T:25-->
<!--T:25-->
* [[File:TechDraw_SectionView.svg|32px]] [[TechDraw_SectionView|Insert Section View]]: inserts a cross-section view of an existing view.
:* [[File:TechDraw_SectionView.svg|32px]] [[TechDraw_SectionView|Insert Simple Section View]]: inserts a cross-section view of an existing view.

<!--T:387-->
:* [[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}}


<!--T:26-->
<!--T:26-->
Line 80: Line 89:
* [[File:TechDraw_SpreadsheetView.svg|32px]] [[TechDraw_SpreadsheetView|Insert Spreadsheet View]]: 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.


<!--T:356-->
<!--T:33-->
* [[File:TechDraw_MoveView.svg|32px]] [[TechDraw_MoveView|Move View]]: moves a view and its dependents to a different page. {{Version|0.20}}
* [[File:TechDraw_ClipGroup.svg|32px]] [[TechDraw_ClipGroup|Insert Clip Group]]: inserts a clip group.


<!--T:357-->
<!--T:357-->
Line 94: Line 103:
These are tools for changing the stacking order which controls the apparent depth of views on a page.
These are tools for changing the stacking order which controls the apparent depth of views on a page.


<!--T:371-->
* [[File:TechDraw_StackTop.svg|x32px]][[Image:Toolbar_flyout_arrow.svg|x32px]] <span id="TechDraw_StackGroup">Adjust Stacking Order of Views:</span><!--Do not edit span id: the TechDraw_StackGroup pages redirect here-->
* <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-->


<!--T:367-->
<!--T:367-->
:* [[File:TechDraw_StackTop.svg|32px]] [[TechDraw_StackTop|Move view to top of stack]]: moves views to the top of the stacking order. {{Version|1.0}}
:* [[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}}


<!--T:368-->
<!--T:368-->
:* [[File:TechDraw_StackBottom.svg|32px]] [[TechDraw_StackBottom|Move view to bottom of stack]]: moves views to the bottom of the stacking order. {{Version|1.0}}
:* [[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}}


<!--T:369-->
<!--T:369-->
:* [[File:TechDraw_StackUp.svg|32px]] [[TechDraw_StackUp|Move view up one level]]: moves views up one level in the stacking order. {{Version|1.0}}
:* [[File:TechDraw_StackUp.svg|32px]] [[TechDraw_StackUp|Move view up one level]]: moves views up one level in the stacking order. {{Version|0.21}}


<!--T:370-->
<!--T:370-->
:* [[File:TechDraw_StackDown.svg|32px]] [[TechDraw_StackDown|Move view down one level]]: moves views down one level in the stacking order. {{Version|1.0}}
:* [[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 == <!--T:31-->

<!--T:32-->
These are tools to create and manage Clip objects (clipped views).

<!--T:33-->
* [[File:TechDraw_ClipGroup.svg|32px]] [[TechDraw_ClipGroup|Insert Clip Group]]: inserts a clip group into a page.

<!--T:34-->
* [[File:TechDraw_ClipGroupAdd.svg|32px]] [[TechDraw_ClipGroupAdd|Add View to Clip Group]]: adds an existing view to a clip group.

<!--T:35-->
* [[File:TechDraw_ClipGroupRemove.svg|32px]] [[TechDraw_ClipGroupRemove|Remove View from Clip Group]]: removes a view from a clip group.


== Decorations == <!--T:48-->
== Decorations == <!--T:48-->
Line 171: Line 167:
* [[File:TechDraw_3PtAngleDimension.svg|32px]] [[TechDraw_3PtAngleDimension|Insert 3-Point Angle Dimension]]: 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.


<!--T:372-->
* [[File:TechDraw_HorizontalExtentDimension.svg|x32px]][[Image:Toolbar_flyout_arrow.svg|x32px]] <span id="TechDraw_ExtentGroup">Insert Extent Dimensions:</span><!--Do not edit span id: the TechDraw_ExtentGroup pages redirect here-->
* <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-->


<!--T:306-->
<!--T:306-->
:* [[File:TechDraw_HorizontalExtentDimension.svg|32px]] [[TechDraw_HorizontalExtentDimension|Insert Horizontal Extent Dimension]]: adds a horizontal extent dimension. {{Version|0.19}}
:* [[File:TechDraw_HorizontalExtentDimension.svg|32px]] [[TechDraw_HorizontalExtentDimension|Insert Horizontal Extent Dimension]]: adds a horizontal extent dimension.


<!--T:307-->
<!--T:307-->
:* [[File:TechDraw_VerticalExtentDimension.svg|32px]] [[TechDraw_VerticalExtentDimension|Insert Vertical Extent Dimension]]: adds a vertical extent dimension. {{Version|0.19}}
:* [[File:TechDraw_VerticalExtentDimension.svg|32px]] [[TechDraw_VerticalExtentDimension|Insert Vertical Extent Dimension]]: adds a vertical extent dimension.


<!--T:44-->
<!--T:44-->
Line 183: Line 180:


<!--T:67-->
<!--T:67-->
* [[File:TechDraw_Balloon.svg|32px]] [[TechDraw_Balloon|Insert Balloon Annotation]]: adds a "balloon" annotation to a page. {{Version|0.19}}
* [[File:TechDraw_Balloon.svg|32px]] [[TechDraw_Balloon|Insert Balloon Annotation]]: adds a "balloon" annotation to a page.

<!--T:390-->
* [[File:TechDraw_AxoLengthDimension.svg|32px]] [[TechDraw_AxoLengthDimension|Insert Axonometric Length Dimension]]: adds an axonometric length dimension. {{Version|0.21}}


<!--T:308-->
<!--T:308-->
* [[File:TechDraw_LandmarkDimension.svg|32px]] [[TechDraw_LandmarkDimension|Insert Landmark Dimension]]: adds a landmark distance dimension. {{Version|0.19}}
* [[File:TechDraw_LandmarkDimension.svg|32px]] [[TechDraw_LandmarkDimension|Insert Landmark Dimension - EXPERIMENTAL]]: adds a landmark distance dimension.

<!--T:389-->
* [[File:TechDraw_DimensionRepair.svg|32px]] [[TechDraw_DimensionRepair|Dimension Repair]]: can adjust the 2D or 3D geometry references of a dimension. {{Version|0.21}}


== Annotations == <!--T:70-->
== Annotations == <!--T:70-->
Line 197: Line 200:


<!--T:68-->
<!--T:68-->
* [[File:TechDraw_LeaderLine.svg|32px]] [[TechDraw_LeaderLine|Add Leaderline to View]]: adds a leaderline to a view. {{Version|0.19}}
* [[File:TechDraw_LeaderLine.svg|32px]] [[TechDraw_LeaderLine|Add Leaderline to View]]: adds a leaderline to a view.


<!--T:69-->
<!--T:69-->
* [[File:TechDraw_RichTextAnnotation.svg|32px]] [[TechDraw_RichTextAnnotation|Insert Rich Text Annotation]]: adds an rich text block as annotation to a leaderline or a view. {{Version|0.19}}
* [[File:TechDraw_RichTextAnnotation.svg|32px]] [[TechDraw_RichTextAnnotation|Insert Rich Text Annotation]]: adds an rich text block as annotation to a leaderline or a view.


<!--T:373-->
* [[File:TechDraw_CosmeticVertex.svg|x32px]][[Image:Toolbar_flyout_arrow.svg|x32px]] <span id="TechDraw_CosmeticVertexGroup">Insert Cosmetic Vertices:</span><!--Do not edit span id: the TechDraw_CosmeticVertexGroup pages redirect here-->
* <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-->


<!--T:71-->
<!--T:71-->
:* [[File:TechDraw_CosmeticVertex.svg|32px]] [[TechDraw_CosmeticVertex|Add Cosmetic Vertex]]: adds a Vertex which is not part of the source geometry. {{Version|0.19}}
:* [[File:TechDraw_CosmeticVertex.svg|32px]] [[TechDraw_CosmeticVertex|Add Cosmetic Vertex]]: adds a Vertex which is not part of the source geometry.


<!--T:72-->
<!--T:72-->
:* [[File:TechDraw_Midpoints.svg|32px]] [[TechDraw_Midpoints|Add Midpoint Vertices]]: adds Cosmetic Vertices at midpoints of selected edges. {{Version|0.19}}
:* [[File:TechDraw_Midpoints.svg|32px]] [[TechDraw_Midpoints|Add Midpoint Vertices]]: adds Cosmetic Vertices at midpoints of selected edges.


<!--T:73-->
<!--T:73-->
:* [[File:TechDraw_Quadrants.svg|32px]] [[TechDraw_Quadrants|Add Quadrant Vertices]]: adds Cosmetic Vertices at quarter points of selected (circular) edges. {{Version|0.19}}
:* [[File:TechDraw_Quadrants.svg|32px]] [[TechDraw_Quadrants|Add Quadrant Vertices]]: adds Cosmetic Vertices at quarter points of selected (circular) edges.


<!--T:374-->
* [[File:TechDraw_FaceCenterLine.svg|x32px]][[Image:Toolbar_flyout_arrow.svg|x32px]] <span id="TechDraw_CenterLineGroup">Insert Center Lines:</span><!--Do not edit span id: the TechDraw_CenterLineGroup pages redirect here-->
* <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-->


<!--T:76-->
<!--T:76-->
:* [[File:TechDraw_FaceCenterLine.svg|32px]] [[TechDraw_FaceCenterLine|Add Centerline to Faces]]: adds a centerline to selected face(s). {{Version|0.19}}
:* [[File:TechDraw_FaceCenterLine.svg|32px]] [[TechDraw_FaceCenterLine|Add Centerline to Faces]]: adds a centerline to selected face(s).


<!--T:77-->
<!--T:77-->
:* [[File:TechDraw 2LineCenterLine.svg|32px]] [[TechDraw_2LineCenterLine|Add Centerline between 2 Lines]]: adds a centerline between 2 lines. {{Version|0.19}}
:* [[File:TechDraw 2LineCenterLine.svg|32px]] [[TechDraw_2LineCenterLine|Add Centerline between 2 Lines]]: adds a centerline between 2 lines.


<!--T:78-->
<!--T:78-->
:* [[File:TechDraw 2PointCenterLine.svg|32px]] [[TechDraw_2PointCenterLine|Add Centerline between 2 Points]]: adds a centerline between 2 points. {{Version|0.19}}
:* [[File:TechDraw 2PointCenterLine.svg|32px]] [[TechDraw_2PointCenterLine|Add Centerline between 2 Points]]: adds a centerline between 2 points.


<!--T:82-->
<!--T:82-->
* [[File:TechDraw_2PointCosmeticLine.svg|32px]] [[TechDraw_2PointCosmeticLine|Add Cosmetic Line Through 2 points]]: adds a cosmetic line connecting 2 vertices. {{Version|0.19}}
* [[File:TechDraw_2PointCosmeticLine.svg|32px]] [[TechDraw_2PointCosmeticLine|Add Cosmetic Line Through 2 points]]: adds a cosmetic line connecting 2 vertices.


<!--T:75-->
<!--T:395-->
* [[File:TechDraw_CosmeticEraser.svg|32px]] [[TechDraw_CosmeticEraser|Remove Cosmetic Object]]: removes cosmetic objects from a page. {{Version|0.19}}
* [[File:TechDraw_CosmeticCircle.svg|32px]] [[TechDraw_CosmeticCircle|Add Cosmetic Circle]]: adds a cosmetic circle. {{Version|1.0}}


<!--T:79-->
<!--T:79-->
* [[File:TechDraw_DecorateLine.svg|32px]] [[TechDraw_DecorateLine|Change Appearance of Lines]]: changes the appearance of selected line(s). {{Version|0.19}}
* [[File:TechDraw_DecorateLine.svg|32px]] [[TechDraw_DecorateLine|Change Appearance of Lines]]: changes the appearance of selected line(s).


<!--T:80-->
<!--T:80-->
* [[File:TechDraw_ShowAll.svg|32px]] [[TechDraw_ShowAll|Show/Hide Invisible Edges]]: shows/hides invisible lines/edges in a view. {{Version|0.19}}
* [[File:TechDraw_ShowAll.svg|32px]] [[TechDraw_ShowAll|Show/Hide Invisible Edges]]: shows/hides invisible lines/edges in a view.


<!--T:81-->
<!--T:81-->
* [[File:TechDraw_WeldSymbol.svg|32px]] [[TechDraw_WeldSymbol|Add Welding Information to Leader]]: adds welding specifications to an existing leaderline. {{Version|0.19}}
* [[File:TechDraw_WeldSymbol.svg|32px]] [[TechDraw_WeldSymbol|Add Welding Information to Leader]]: adds welding specifications to an existing leaderline.


<!--T:362-->
<!--T:362-->
* [[File:TechDraw_SurfaceFinishSymbol.svg|32px]] [[TechDraw_SurfaceFinishSymbol|Add Surface Finish Symbol]]: adds a surface finish symbol to a page. {{Version|1.0}}
* [[File:TechDraw_SurfaceFinishSymbol.svg|32px]] [[TechDraw_SurfaceFinishSymbol|Add Surface Finish Symbol]]: adds a surface finish symbol to a page. {{Version|0.21}}

<!--T:391-->
* [[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 == <!--T:310-->
== Extensions == <!--T:310-->
Line 255: Line 263:
* [[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}}
* [[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}}


<!--T:375-->
* [[File:TechDraw_ExtensionExtendLine.svg|x32px]][[Image:Toolbar_flyout_arrow.svg|x32px]] <span id="TechDraw_ExtensionExtendShortenLineGroup">Change Length of Cosmetic Lines and CenterLines:</span><!--Do not edit span id: the TechDraw_ExtensionExtendShortenLineGroup pages redirect here-->
* <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-->


<!--T:323-->
<!--T:323-->
Line 269: Line 278:
* [[File:TechDraw_ExtensionPositionSectionView.svg|32px]] [[TechDraw_ExtensionPositionSectionView|Position Section View]]: orthogonally aligns a section view with its source 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}}


<!--T:376-->
* [[File:TechDraw_ExtensionPosHorizChainDimension.svg|x32px]][[Image:Toolbar_flyout_arrow.svg|x32px]] <span id="TechDraw_ExtensionPosChainDimensionGroup">Align Dimensions:</span><!--Do not edit span id: the TechDraw_ExtensionPosChainDimensionGroup pages redirect here-->
* <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-->


<!--T:327-->
<!--T:327-->
Line 280: Line 290:
:* [[File:TechDraw_ExtensionPosObliqueChainDimension.svg|32px]] [[TechDraw_ExtensionPosObliqueChainDimension|Position Oblique Chain Dimensions]]: aligns oblique 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}}


<!--T:377-->
* [[File:TechDraw_ExtensionCascadeHorizDimension.svg|x32px]][[Image:Toolbar_flyout_arrow.svg|x32px]] <span id="TechDraw_ExtensionCascadeDimensionGroup">Evenly Space Dimensions:</span><!--Do not edit span id: the TechDraw_ExtensionCascadeDimensionGroup pages redirect here-->
* <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-->


<!--T:330-->
<!--T:330-->
Line 293: Line 304:
<!--T:360-->
<!--T:360-->
* [[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_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}}

<!--T:396-->
* [[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|1.0}}


<!--T:361-->
<!--T:361-->
Line 299: Line 313:
=== Centerlines and threading === <!--T:334-->
=== Centerlines and threading === <!--T:334-->


<!--T:378-->
* [[File:TechDraw_ExtensionCircleCenterLines.svg|x32px]][[Image:Toolbar_flyout_arrow.svg|x32px]] <span id="TechDraw_ExtensionCircleCenterLinesGroup">Add Centerlines:</span><!--Do not edit span id: the TechDraw_ExtensionCircleCenterLinesGroup pages redirect here-->
* <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-->


<!--T:335-->
<!--T:335-->
Line 307: Line 322:
:* [[File:TechDraw_ExtensionHoleCircle.svg|32px]] [[TechDraw_ExtensionHoleCircle|Add Bolt Circle Centerlines]]: adds centerlines to a circular pattern of circles. {{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}}


<!--T:379-->
* [[File:TechDraw_ExtensionThreadHoleSide.svg|x32px]][[Image:Toolbar_flyout_arrow.svg|x32px]] <span id="TechDraw_ExtensionThreadsGroup">Add Cosmetic Threads:</span><!--Do not edit span id: the TechDraw_ExtensionThreadsGroup pages redirect here-->
* <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-->


<!--T:314-->
<!--T:314-->
Line 320: Line 336:
<!--T:317-->
<!--T:317-->
:* [[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}}
:* [[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}}

<!--T:397-->
* <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-->


<!--T:337-->
<!--T:337-->
* [[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_ExtensionVertexAtIntersection.svg|32px]] [[TechDraw_ExtensionVertexAtIntersection|Add Cosmetic Intersection Vertex(es)]]: adds cosmetic vertex(es) at the intersection(s) of selected edges. {{Version|0.20}}

<!--T:398-->
:* [[File:TechDraw_CommandAddOffsetVertex.svg|32px]] [[TechDraw_CommandAddOffsetVertex|Add an offset vertex]]: adds a cosmetic vertex at a specified offset from a selected vertex. {{Version|1.0}}


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


<!--T:338-->
<!--T:338-->
Line 335: Line 358:
:* [[File:TechDraw_ExtensionDrawCosmCircle3Points.svg|32px]] [[TechDraw_ExtensionDrawCosmCircle3Points|Add Cosmetic Circle 3 Points]]: adds a cosmetic circle 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}}


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


<!--T:341-->
<!--T:341-->
Line 345: Line 369:
=== Dimensions === <!--T:342-->
=== Dimensions === <!--T:342-->


<!--T:382-->
* [[File:TechDraw_ExtensionCreateHorizChainDimension.svg|x32px]][[Image:Toolbar_flyout_arrow.svg|x32px]] <span id="TechDraw_ExtensionCreateChainDimensionGroup">Create Chain Dimensions:</span><!--Do not edit span id: the TechDraw_ExtensionCreateChainDimensionGroup pages redirect here-->
* <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-->


<!--T:350-->
<!--T:350-->
Line 356: Line 381:
:* [[File:TechDraw_ExtensionCreateObliqueChainDimension.svg|32px]] [[TechDraw_ExtensionCreateObliqueChainDimension|Create Oblique Chain Dimensions]]: creates a sequence of aligned oblique 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}}


<!--T:383-->
* [[File:TechDraw_ExtensionCreateHorizCoordDimension.svg|x32px]][[Image:Toolbar_flyout_arrow.svg|x32px]] <span id="TechDraw_ExtensionCreateCoordDimensionGroup">Create Coordinate Dimensions:</span><!--Do not edit span id: the TechDraw_ExtensionCreateCoordDimensionGroup pages redirect here-->
* <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-->


<!--T:346-->
<!--T:346-->
Line 367: Line 393:
:* [[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}}
:* [[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}}


<!--T:384-->
* [[File:TechDraw_ExtensionCreateHorizChamferDimension.svg|x32px]][[Image:Toolbar_flyout_arrow.svg|x32px]] <span id="TechDraw_ExtensionChamferDimensionGroup">Create Chamfer Dimensions:</span><!--Do not edit span id: the TechDraw_ExtensionChamferDimensionGroup pages redirect here-->
* <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-->


<!--T:351-->
<!--T:351-->
Line 378: Line 405:
* [[File:TechDraw_ExtensionCreateLengthArc.svg|32px]] [[TechDraw_ExtensionCreateLengthArc|Create Arc Length Dimension]]: creates an arc length dimension. {{Version|0.20}}
* [[File:TechDraw_ExtensionCreateLengthArc.svg|32px]] [[TechDraw_ExtensionCreateLengthArc|Create Arc Length Dimension]]: creates an arc length dimension. {{Version|0.20}}


<!--T:385-->
* [[File:TechDraw_ExtensionInsertDiameter.svg|x32px]][[Image:Toolbar_flyout_arrow.svg|x32px]] <span id="TechDraw_ExtensionInsertPrefixGroup">Insert Prefix:</span><!--Do not edit span id: the TechDraw_ExtensionInsertPrefixGroup pages redirect here-->
* <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-->


<!--T:343-->
<!--T:343-->
Line 389: Line 417:
:* [[File:TechDraw_ExtensionRemovePrefixChar.svg|32px]] [[TechDraw_ExtensionRemovePrefixChar|Remove Prefix]]: removes all symbols 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}}


<!--T:386-->
* [[File:TechDraw_ExtensionIncreaseDecimal.svg|x32px]][[Image:Toolbar_flyout_arrow.svg|x32px]] <span id="TechDraw_ExtensionIncreaseDecreaseGroup">Change Decimal Places:</span><!--Do not edit span id: the TechDraw_ExtensionIncreaseDecreaseGroup pages redirect here-->
* <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-->


<!--T:354-->
<!--T:354-->
Line 415: Line 444:
* [[TechDraw_Hatching|Hatching]]: explanation of the different hatching techniques.
* [[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.
* [[TechDraw_Geometric_dimensioning_and_tolerancing|Geometric dimensioning and tolerancing]]: explanation on how to achieve geometric dimensioning and tolerancing.

== Obsolete tools == <!--T:399-->

<!--T:34-->
* [[File:TechDraw_ClipGroupAdd.svg|32px]] [[TechDraw_ClipGroupAdd|Add View to Clip Group]]: adds an existing view to a clip group. Not available in {{VersionPlus|1.0}}.

<!--T:35-->
* [[File:TechDraw_ClipGroupRemove.svg|32px]] [[TechDraw_ClipGroupRemove|Remove View from Clip Group]]: removes a view from a clip group. Not available in {{VersionPlus|1.0}}.

<!--T:75-->
* [[File:TechDraw_CosmeticEraser.svg|32px]] [[TechDraw_CosmeticEraser|Remove Cosmetic Object]]: removes cosmetic objects from a page. Not available in {{VersionPlus|1.0}}.

<!--T:356-->
* [[File:TechDraw_MoveView.svg|32px]] [[TechDraw_MoveView|Move View]]: moves a view and its dependents to a different page. Not available in {{VersionPlus|1.0}}.


== Preferences == <!--T:319-->
== Preferences == <!--T:319-->
Line 424: Line 467:


<!--T:5-->
<!--T:5-->
The TechDraw tools can be used in [[macros|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:
* [https://freecad.github.io/SourceDoc/ Autogenerated API documentation]
* [[TechDraw API|TechDraw API]]
* [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]]
* [[TechDrawGui API|TechDrawGui API]]
* [[TechDraw_PageDefault#Editable_text_fields|Editable Text Fields]]


== Limitations == <!--T:321-->
== Limitations == <!--T:321-->


<!--T:7-->
<!--T:394-->
* 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.
* 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|Tree view]] as this generally does not work out well.
* 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.
* Do not drag TechDraw objects in the [[Tree_view|Tree view]] with the mouse.
Line 452: Line 493:
* 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=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)]
* 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 == <!--T:392-->

<!--T:393-->
Do you want to know about the future of the TechDraw Workbench? Visit [[TechDraw_Roadmap|the TechDraw Roadmap Page]] to learn more.




Line 457: Line 503:
{{Docnav
{{Docnav
|[[Surface_Workbench|Surface Workbench]]
|[[Surface_Workbench|Surface Workbench]]
|[[External_workbenches|External workbenches]]
|[[Web_Workbench|Web Workbench]]
|IconL=Workbench_Surface.svg
|IconL=Workbench_Surface.svg
|IconR=Workbench_Web.svg
|IconR=AddonManager.svg
}}
}}



Latest revision as of 18:49, 25 April 2024

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:

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

Obsolete tools

  • Move View: moves a view and its dependents to a different page. Not available in version 1.0 and above.

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.