TechDraw Workbench/zh: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
(22 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}}
[[File:preferences-techdraw.svg|64px]]


[[File:Workbench_TechDraw.svg|64px]]
FreeCAD is primarily a 3D modelling tool. There are times, however, when we must produce 2D drawings for documentation, contracts, permits, etc. The Technical Drawing workbench (TechDraw) is used to produce basic technical drawings based on the 3D model. Each drawing is a Page, and a Page contains many Views of Drawable Objects. The list of Drawable Objects includes Part::Features, PartDesign::Bodies, App::Part groups and Document Object groups.


== Introduction ==
Dimensions and hatched areas can be added to Views.


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.
Note if your primary goal is the production of complex 2D drawings, you may wish to consider a dedicated tool such as LibreCad, QCad, TurboCad, 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]].
{{Version|0.17}}


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}}
[[File:TechDraw Workbench Example.png|600px]]
[[File:TechDraw Workbench Example.png|600px]]


== Pages ==

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-new-pick.svg|32px]] [[TechDraw_New_Pick|New Pick]]: adds a new page using a selected [[TechDraw_Templates|template]].

== Views ==

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-projgroup.svg|32px]] [[TechDraw_NewProjGroup|New Projection Group]]: invokes a dialog to create many views of an object from multiple directions.

* [[File:techdraw-viewsection.svg|32px]] [[TechDraw_NewSection|New Section]]: adds a cross-section view of an existing view.

* [[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-arch-view.svg|32px]] [[TechDraw_NewArch|New Arch]]: adds a view of a [[Arch Workbench|Arch Workbench]] [[Arch SectionPlane|SectionPlane]] object.

* [[File:techdraw-spreadsheet.svg|32px]] [[TechDraw_Spreadsheet|Spreadsheet]]: inserts a view of a [[Spreadsheet Workbench|Spreadsheet Workbench]] sheet.

== Clips ==

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-clipplus.svg|32px]] [[TechDraw_ClipPlus|ClipPlus]]: adds an existing view to a clip group.
===Pages===


* [[File:techdraw-clipminus.svg|32px]] [[TechDraw_ClipMinus|ClipMinus]]: removes a view from a clip group.
These are tools for creating Pages.


== Dimensions ==
* [[File:TechDraw_New_Default.png|32px]] [[TechDraw_New_Default|New Default]]: Adds a new Page using the default [[TechDraw_Templates|Template]].


These are tools for creating and working with Dimension objects.
* [[File:TechDraw_New_Pick.png|32px]] [[TechDraw_New_Pick|New Pick]]: Adds a new Page using a selected [[TechDraw_Templates|Template]].


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


* [[File:TechDraw_Dimension_Length.svg|32px]] [[TechDraw_Dimension_Length|New Length]]: adds a length dimension.
These are tools for creating Views.


* [[File:techdraw-view.png|32px]] [[TechDraw_NewView|New View]]: Adds a 2D View of a one or more Drawable Objects.
* [[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-projgroup.png|32px]] [[TechDraw_NewProjGroup|New Projection Group]]: Invokes a dialog for creating Views of one or more Drawable Objects from multiple directions.


* [[File:techdraw-viewsection.png|32px]] [[TechDraw_NewSection|New Section]]: Adds a cross-section View of one or more Drawable Objects.
* [[File:TechDraw_Dimension_Radius.svg|32px]] [[TechDraw_Dimension_Radius|New Radius]]: adds a radius dimension to a circle or circular arc.


* [[File:techdraw-viewdetail.png|32px]] [[TechDraw_NewDetail|New Detail]]: Adds a detail View of a portion of an existing View.
* [[File:TechDraw_Dimension_Diameter.svg|32px]] [[TechDraw_Dimension_Diameter|New Diameter]]: adds a diameter dimension to a circle or a circular arc.


* [[File:techdraw-annotation.png|32px]] [[TechDraw_NewAnnotation|New Annotation]]: Adds a text block to a Page.
* [[File:TechDraw_Dimension_Angle.svg|32px]] [[TechDraw_Dimension_Angle|New Angle]]: adds an angle dimension between two straight edges.


* [[File:techdraw-draft-view.png|32px]] [[TechDraw_NewDraft|New Draft]]: Adds a View of a Draft module object.
* [[File:TechDraw_Dimension_Angle3Pt.svg|32px]] [[TechDraw_Dimension_Angle3Pt|New Angle3Pt]]: adds an angle dimension using three vertices.


* [[File:techdraw-arch-view.png|32px]] [[TechDraw_NewArch|New Arch]]: Adds a View of a Arch module Section Plane object.
* [[File:TechDraw_Dimension_Link.svg|32px]] [[TechDraw_Dimension_Link|New Links]]: links an existing dimension to the 3D geometry.


* [[File:techdraw-spreadsheet.svg|32px]] [[TechDraw_Spreadsheet|Spreadsheet]]: Inserts a view of a selected [[Spreadsheet_Workbench|spreadsheet]] into a drawing.
* [[File:TechDraw_Balloon.svg|32px]] [[TechDraw_Balloon|New Balloon]]: adds a "balloon" annotation to a page. {{Version|0.19}}


===Clips===
== Import/Export ==


These are tools to create and manage clipped views.
These are tools for exporting pages to other applications.


* [[File:techdraw-clip.svg|32px]] [[TechDraw_Clip|Clip]]: Inserts a clip group into a Page.
* [[File:techdraw-saveSVG.svg|32px]] [[TechDraw_SaveSVG|Save SVG]]: saves a page as an [[SVG|SVG]] file.
* [[File:techdraw-saveDXF.svg|32px]] [[TechDraw_SaveDXF|Save DXF]]: saves a page as a [[DXF|DXF]] file.


== Decoration ==
* [[File:techdraw-clipplus.svg|32px]] [[TechDraw_ClipPlus|ClipPlus]]: Adds a View to a clip group.


These are tools for changing the appearance of pages and views.
* [[File:techdraw-clipminus.svg|32px]] [[TechDraw_ClipMinus|ClipMinus]]: Removes a View from a clip group.


* [[File:techdraw-hatch.svg|32px]] [[TechDraw_Hatch|Hatch Area]]: applies a hatch pattern from a file to a face.
===Dimensions===


* [[File:techdraw-geomhatch.svg|32px]] [[TechDraw_GeomHatch|Geometric Hatch]]: applies a hatch pattern to a face using an Autodesk PAT specification.
These are tools for working with Dimensions. Linear dimensions can be based on two points, one line or two lines.


* [[File:Dimension_Length.png|32px]] [[TechDraw_Dimension_Length|New Length]]: Adds a Length Dimension.
* [[File:techdraw-symbol.svg|32px]] [[TechDraw_Symbol|New Symbol]]: inserts an [[SVG|SVG]] symbol into a page.


* [[File:Dimension_Horizontal.png|32px]] [[TechDraw_Dimension_Horizontal|New Horizontal]]: Adds a horizontal distance dimension.
* [[File:Techdraw-image.svg|32px]] [[TechDraw_Image|New Image]]: inserts a PNG or JPG [[bitmap|bitmap]] image into a page.


* [[File:techdraw-toggleframe.svg|32px]] [[TechDraw_Toggle|Toggle Frames]]: turns on and off the frames and labels surrounding a view.
* [[File:Dimension_Vertical.png|32px]] [[TechDraw_Dimension_Vertical|New Vertical]]: Adds a vertical distance dimension.


* [[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)
* [[File:Dimension_Radius.png|32px]] [[TechDraw_Dimension_Radius|New Radius]]: Adds a Radius dimension to a circle or circular arc.


== Annotation ==
* [[File:Dimension_Diameter.png|32px]] [[TechDraw_Dimension_Diameter|New Diameter]]: Adds a Diameter dimension to a circle or a circular arc.


The annotation tools are for "marking up" a drawing with additional information.
* [[File:Dimension_Angle.png|32px]] [[TechDraw_Dimension_Angle|New Angle]]: Adds an Angle dimension between two straight edges.


* [[File:techdraw-annotation.svg|32px]] [[TechDraw_NewAnnotation|New Annotation]]: adds a plain text block to serve as an annotation.


* [[File:techdraw-mline.svg|24px]] [[TechDraw_LeaderLine|Leader Line]]: The Leader Line tool adds an annotation line to a view. {{Version|0.19}}
* [[File:TechDraw_Dimension_Angle3Pt.png|32px]] [[TechDraw_Dimension_Angle3Pt|New Angle3Pt]]: Adds an Angle dimension using three vertices.


* [[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:Dimension_Link.png|32px]] [[TechDraw_Dimension_Link|New Links]]: Links 1 or more Dimensions to 3D geometry.


* [[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}}
===Import/Export===


* [[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}}
These are tools for exporting Pages to other applications.


* [[File:techdraw-saveSVG.png|32px]] [[TechDraw_SaveSVG|Save SVG]]: Saves a Page as an SVG file.
* [[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_SaveDXF.png|32px]] [[TechDraw_SaveDXF|Save DXF]]: Saves a Page as a DXF file.


* [[File:techdraw-facecenterline.svg|24px]] [[TechDraw_FaceCenterLine|FaceCenterLine]]: The FaceCenterLine tool adds a center line to selected Face(s). {{Version|0.19}}
===Decoration===


* [[File:techdraw-2linecenterline.svg|24px]] [[TechDraw_2LineCenterLine|2LineCenterLine]]: The 2LineCenterLine tool adds a center line between 2 Edges. {{Version|0.19}}
These are tools for changing the appearance of Pages and Views.


* [[File:techdraw-hatch.png|32px]] [[TechDraw_Hatch|Hatch Area]]: Applies a hatch pattern from a file to a Face.
* [[File:techdraw-2pointcenterline.svg|24px]] [[TechDraw_2PointCenterLine|2PointCenterLine]]: The 2PointCenterLine tool adds a center line between 2 Points. {{Version|0.19}}


* [[File:techdraw-geomhatch.png|32px]] [[TechDraw_GeomHatch|Geometric Hatch]]: Hatches a Face using an Autodesk PAT specification.
* [[File:techdraw-eraser.svg|24px]] [[TechDraw_CosmeticEraser|CosmeticEraser]]: The CosmeticEraser tool removes cosmetic objects from a Page. {{Version|0.19}}


* [[File:techdraw-symbol.png|32px]] [[TechDraw_Symbol|New Symbol]]: Inserts an SVG symbol into a Page.
* [[File:techdraw-linedecor.svg|24px]] [[TechDraw_DecorateLine|DecorateLine]]: The DecorateLine tool changes the appearance of Edges. {{Version|0.19}}


* [[File:Techdraw-image.png|32px]] [[TechDraw_Image|New Image]]: Inserts a png/jpg image into a Page.
* [[File:techdraw-showall.svg|24px]] [[TechDraw_ShowAll|ShowAll]]: The ShowAll tool shows/hide invisible edges in a View. {{Version|0.19}}


* [[File:techdraw-toggleframe.png|32px]] [[TechDraw_Toggle|Toggle Frames]]: Turns View frames and labels on or off in a Page.
* [[File:techdraw-weldsymbol.svg|24px]] [[TechDraw_WeldingSymbol|WeldingSymbol]]: The WeldingSymbol tool adds welding specifications to an existing leader line. {{Version|0.19}}


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


* [[TechDraw_Hatching|Hatching]]: TechDraw supports a number of 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_LineGroup|Line Groups]]: default weights can be assigned to various line types.
* [[TechDraw_Templates|Templates]]: the default templates defined for the drawing pages.


== Preferences ==
===Preference settings===
* [[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.
The TechDraw module has a [[TechDraw Preferences|preferences]] screen to adjust default values.


===Scripting===
== Scripting ==
The TechDraw module features a [[TechDraw_API|Python API]] so you can use its functions in scripts and macros.
The TechDraw tools can be used in [[macros]] and from the [[Python|Python]] console by using two APIs.
* [[TechDraw API|TechDraw API]]
* [[TechDrawGui API|TechDrawGui API]]


===Limitations===
== Limitations ==
* TechDraw drawings and Python API are not interchangeable with the Drawing module. It is possible to convert Drawing Pages to TechDraw Pages using Python (moveViews.py). It is possible to have both TechDraw and Drawing Pages in the same FreeCAD document.
* 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 Templates compared to the Drawing module. See forum discussion [https://forum.freecadweb.org/viewtopic.php?f=3&t=24981&p=196271#p196271 here].
* 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.
* TechDraw is available starting with FreeCAD 0.17.
* Do not Cut/Copy/Paste TechDraw objects. This does not generally work out well.
* Do not cut, copy and paste TechDraw objects in the tree view as this generally does not work out well.


===Workarounds===
== Tutorials ==
* None required at the moment.


* [[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.


Video tutorials by sliptonic
Keep up with TechDraw plans and developments. Visit the [[TechDraw_Roadmap|TechDraw Roadmap]].
* 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}}
{{docnav|Start Workbench|Test Framework Workbench}}


{{Userdocnavi}}


[[Category:User Documentation/zh]]
[[Category:Workbenches]]

Revision as of 19:54, 13 August 2019

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.

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.

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.

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

Import/Export

These are tools for exporting pages to other applications.

Decoration

These are tools for changing the appearance of pages and views.

  • Redraw: The Redraw tool attempts to redraw a page without recalculating the 3D model. (This tool was removed in v0.18)

Annotation

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

Additional features

  • Hatching: explanation of the different hatching techniques.
  • Line Groups: default weights can be assigned to various line types.
  • Templates: the default templates defined for the drawing pages.

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