TechDraw DraftView

From FreeCAD Documentation
Jump to navigation Jump to search

TechDraw DraftView.svg TechDraw DraftView

Menu location
TechDraw → 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 TechDraw View.svg View tool, views created with this tool are handled by the Workbench Draft.svg Draft Workbench, and specially designed for showing 2D objects. See Notes.

TechDraw DraftView example.png

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


  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 TechDraw DraftView.svg Insert Draft Workbench Object button
  4. A view of the draft object will appear on the page.


  • 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


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.


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