TechDraw BrokenView

From FreeCAD Documentation
Other languages:

TechDraw BrokenView

Menu location
TechDraw → TechDraw Views → Insert Broken View
Default shortcut
Introduced in version
See also
TechDraw Section, TechDraw View, TechDraw Projection Group


The TechDraw BrokenView tool inserts a "broken view" that is either based on an existing part view, or one or more objects, such as Bodies or Parts. The broken view also requires one or more sketches that define the location and size of the areas to be removed. The BrokenView behaves similarly to other Views. The projection direction is taken from the existing part view, the 3D camera direction or the normal of a selected face.

A shape to be broken and the sketches defining the breaks

The result


  1. Select a part view and one or more break sketches in the Tree view. Breaks are typically described by sketches, but any object whose shape can be made into an edge will work.
  2. There are several ways to invoke the tool:
    • Press the Insert Broken View button.
    • Select the TechDraw → TechDraw Views → Insert Broken View option from the menu.



Broken View

  • DataBreaks: Objects in the 3d view that define the start/end points and direction of breaks in this view.
  • DataGap: The separation distance for breaks in this view (unscaled 3d length).


  • Breaks must be vertical or horizontal. Oblique breaks are not supported.
  • See also TechDraw View.


See also: Autogenerated API documentation and FreeCAD Scripting Basics.

A BrokenView can be created with macros and from the Python console by using the following functions:

doc = FreeCAD.ActiveDocument
box = doc.Box
profile = doc.Sketch
page = doc.Page

brokenView = doc.addObject("TechDraw::DrawBrokenView", "BrokenView")
brokenView.Source= box
brokenView.Breaks = [doc.Sketch]