TechDraw DraftView: Difference between revisions

From FreeCAD Documentation
(Removed Version=0.19. Tool exists in V0.17 and maybe even in an earlier version.)
No edit summary
Line 15: Line 15:
|Name=TechDraw DraftView
|Name=TechDraw DraftView
|MenuLocation=TechDraw → Insert Draft Workbench Object
|MenuLocation=TechDraw → Insert Draft Workbench Object
|Workbenches=[[TechDraw_Module|TechDraw]]
|Workbenches=[[TechDraw_Module|TechDraw]], [[Draft_Workbench|Draft]]
|SeeAlso=[[Draft_Workbench|Draft Workbench]], [[TechDraw_ArchView|Insert Arch Workbench Object]]
|SeeAlso=, [[TechDraw_ArchView|TechDraw Insert Arch Workbench Object]]
}}
}}


Line 22: Line 22:


<!--T:13-->
<!--T:13-->
The [[Image:TechDraw_DraftView.svg|24px]] [[TechDraw_DraftView|DraftView]] tool inserts a view of a selected [[Part Module|Part]]-based or Group object into a drawing page. Unlike the standard [[Image:TechDraw_View.svg|24px]] [[TechDraw_View|View]] tool, views created with this tool are handled by the [[Image:Workbench_Draft.svg|24px]] [[Draft Workbench|Draft Workbench]], and specially designed for showing 2D objects. See Notes.
The [[Image:TechDraw_DraftView.svg|24px]] [[TechDraw_DraftView|DraftView]] tool inserts a view of a selected [[Part_Module|Part]]-based or Group object into a drawing page. Unlike the standard [[Image:TechDraw_View.svg|24px]] [[TechDraw_View|View]] tool, views created with this tool are handled by the [[Image:Workbench_Draft.svg|24px]] [[Draft_Workbench|Draft Workbench]], and specially designed for showing 2D objects. See Notes.


<!--T:10-->
<!--T:10-->
Line 33: Line 33:
# Select a draft object in the 3D view or in the tree
# Select a draft object in the 3D view or in the tree
# If you have multiple drawing pages in your document, you will need to select the desired page in the tree.
# If you have multiple drawing pages in your document, you will need to select the desired page in the tree.
# Press the {{Button|[[Image:TechDraw DraftView.svg|16px]] [[TechDraw DraftView|Insert Draft Workbench Object]]}} button
# Press the {{Button|[[Image:TechDraw DraftView.svg|16px]] [[TechDraw_DraftView|Insert Draft Workbench Object]]}} button
# A view of the draft object will appear on the page.
# A view of the draft object will appear on the page.


Line 39: Line 39:


<!--T:15-->
<!--T:15-->
The DraftView is rendered within the [[Draft Workbench|Draft Workbench]], therefore TechDraw has limited control over its appearance. You may need to make changes within Draft to get the representation you want.
The DraftView is rendered within the [[Draft_Workbench|Draft Workbench]], therefore TechDraw has limited control over its appearance. You may need to make changes within Draft to get the representation you want.


==Options== <!--T:4-->
==Options== <!--T:4-->
Line 67: Line 67:


<!--T:16-->
<!--T:16-->
{{Emphasis|See also:}} [[TechDraw API|TechDraw API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
{{Emphasis|See also:}} [[TechDraw_API|TechDraw API]] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].


<!--T:17-->
<!--T:17-->
The New Draft tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using the following functions:
The New Draft tool can be used in [[Macros|macros]] and from the [[Python|Python]] console by using the following functions:


</translate>
</translate>

Revision as of 22:00, 22 November 2020

TechDraw DraftView

Menu location
TechDraw → Insert Draft Workbench Object
Workbenches
TechDraw, Draft
Default shortcut
None
Introduced in version
-
See also
, TechDraw Insert Arch Workbench Object

Description

The DraftView tool inserts a view of a selected Part-based or Group object into a drawing page. Unlike the standard View tool, views created with this tool are handled by the Draft Workbench, and specially designed for showing 2D objects. See Notes.

Draft elements like circles and arrays imported into a TechDraw drawing page

Usage

  1. Select a draft object in the 3D view or in the tree
  2. If you have multiple drawing pages in your document, you will need to select the desired page in the tree.
  3. Press the Insert Draft Workbench Object button
  4. A view of the draft object will appear on the page.

Limitations

The DraftView is rendered within the Draft Workbench, therefore TechDraw has limited control over its appearance. You may need to make changes within Draft to get the representation you want.

Options

  • Creating a Draft View of a group will recursively handle all the objects found into that group and in its subgroups. The View is updated automatically when the contents of the group changes
  • There is no hidden line removal. Each face found in the handled object(s) will simply be projected along the Direction vector, no specific action is taken when faces overlap
  • The Draft View also supports all Draft objects that are not Part-based, such as dimensions and texts
  • Color, line width and line pattern can be specified in the properties. Line patterns can be fine-tuned by directly giving a stroke-dasharray value, such as 3,5
  • Projected faces are filled with the face color

Properties

  • DataSource: The draft object to be displayed
  • DataLineWidth: The width of the lines, independently of the scale
  • DataFontSize: The size of all texts appearing in this view (texts and dimensions)
  • DataDirection: The projection direction to use
  • DataColor: The color of lines
  • DataLineStyle: A line style to use for this view. Can be Solid, Dashed, Dashdot, Dot or a SVG line pattern like 0.20,0.20
  • DataLineSpacing: The spacing to use between lines of texts for multiline texts

Note: DraftView inherits all applicable basic View properties.

Scripting

See also: TechDraw API and FreeCAD Scripting Basics.

The New Draft tool can be used in macros and from the Python console by using the following functions:

dv = FreeCAD.ActiveDocument.addObject('TechDraw::DrawViewDraft','TestDraft')
dv.Source = myDraftbject
rc = page.addView(dv)