TechDraw DraftView

From FreeCAD Documentation

TechDraw DraftView

Menu location
TechDraw → Views From Other Workbenches → Insert Draft Workbench Object
TechDraw, Draft
Default shortcut
Introduced in version
See also
TechDraw Arch View


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


  1. Optionally rotate the 3D view. The camera direction in the 3D view determines the initial value of the DataDirection property of the View.
  2. Select one or more objects in the 3D view or Tree view. A separate view will created for each object.
  3. If there are multiple drawing pages in the document: optionally add the desired page to the selection by selecting it in the Tree view.
  4. There are several ways to invoke the tool:
    • Press the Insert Draft Workbench Object button.
    • Select the TechDraw → Views From Other Workbenches → Insert Draft Workbench Object option from the menu.
  5. If there are multiple drawing pages in the document and you have not yet selected a page, the Page Chooser dialog box opens: introduced in version 0.20
    1. Select the desired page.
    2. Press the OK button.


  • Creating a DraftView of a layer will recursively handle all objects found in that layer. The View is updated automatically when the contents of the layer 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


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.


See also TechDraw View.


Draft view

  • DataSource (Link): The Draft object to be displayed.
  • DataLine Width (Float): The width of the lines, independently of the scale.
  • DataFont Size (Float): The size of all texts appearing in this view (texts and dimensions).
  • DataDirection (Vector): The projection direction to use.
  • DataColor (Color): The color of lines.
  • DataLine Style (String): A line style to use for this view. Can be Solid, Dashed, Dashdot, Dot or an SVG line pattern like 0.20,0.20.
  • DataLine Spacing (Float): The spacing to use between lines of texts for multiline texts.
  • DataOverride Style (Bool): If true, line color, width and style of this view will override those of the rendered object.


See also: Autogenerated API documentation 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)