TechDraw NewSection

From FreeCAD Documentation
Jump to: navigation, search
Other languages:
Deutsch • ‎English • ‎français • ‎italiano • ‎română • ‎русский

TechDraw NewSection.png TechDraw NewSection

Menu location
TechDraw → Section
Default shortcut
Introduced in version
See also
TechDraw NewView, TechDraw NewProjGroup


The Section tool creates a cross section view based on an existing part view.

TechDraw Section example.png

Sectioning an already placed view, which shows the internal holes and a shaded cut surface

How to use

  1. Select a part view in the 3D window or tree.
  2. If you have multiple drawing pages in your document, you will also need to select the desired page in the tree.
  3. Press the Techdraw-viewsection.svg Section button
  4. A dialog will open which will help calculate the various Section properties. The dialog calculates reasonable starting points for SectionNormal and view Direction, but these may be changed after creation for special needs.
  5. If you make a mistake, or change your mind while setting up the Section parameters, press the Reset button, and you can start over.

TechDraw Section Taskview.png

Taskview to define the sectional cut of a view



  • DATABaseView: The part view on which this ViewSection is based.
  • DATASectionNormal: A vector describing the direction normal to the cutting plane.
  • DATASectionOrigin: A vector describing a point on the cutting plane. Typically the centroid of the original part.
  • DATAFileHatchPattern: Full path to hatch pattern file.
  • DATANameGeomPattern: Name of PAT pattern to use (blank for Svg hatch).


  • VIEWShowCutSurface: Highlight the section surface if true.
  • VIEWCutSurfaceColor: Solid color for surface highlight.
  • VIEWHatchColor: Color for surface hatch lines.
  • VIEWWeightPattern: Line weight for surface hatch lines.

Note: Section inherits all applicable View properties.


See also: TechDraw API and FreeCAD Scripting Basics.

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

view = FreeCAD.ActiveDocument.addObject('TechDraw::DrawViewPart','View')
rc = page.addView(view)
view.Source = box
view.Direction = (0.0,0.0,1.0)

section = FreeCAD.ActiveDocument.addObject('TechDraw::DrawViewSection','Section')
rc = page.addView(section)
section.Source = box
section.BaseView = view
section.Direction = (0.0,1.0,0.0)
section.SectionNormal = (0.0,0.0,1.0)
section.SectionOrigin = (5.0,5.0,5.0)


  • Section Line Format: both the traditional section line format (as depicted above), and the "reference arrow method" are supported. This option is controlled by the Preference setting "Mod/TechDraw/Format/SectionFormat" (see Std_DlgParameter). 0 for traditional line, 1 for reference arrow method.