Jump to content

TechDraw ComplexSection

From FreeCAD Documentation

TechDraw ComplexSection

Menu location
TechDraw → TechDraw Views → Complex Section View
Workbenches
TechDraw
Default shortcut
None
Introduced in version
0.21
See also
TechDraw Section, TechDraw View

Description

The TechDraw ComplexSection tool inserts a cross-section view based on an existing Part View and a profile.

A Quarter section view created with this tool

An Aligned section view created with this tool

An Offset section view created with this tool

Usage

  1. Select a Part View and a profile object in the 3D View or Tree View. Profiles are typically sketches, but any object whose shape can be made into a wire will work.
  2. There are several ways to invoke the tool:
    • Press the Complex Section View button.
    • Select the TechDraw → TechDraw Views → Complex Section View option from the menu.
  3. A task panel opens which will help calculate the various properties. Reasonable values for the view Direction are calculated, but these can be changed.

Properties

A Complex Section, formally a TechDraw::DrawComplexSection object, is derived from a Section View, formally a TechDraw::DrawViewSection object, and inherits all its properties. It also has the following additional properties:

Data

Cutting Tool

  • DataCutting Tool Wire Object: The document object whose shape will be used to generate the cutting profile.
  • DataProjection Strategy: Controls how the cut is performed and how the result is projected on the page:
    • Offset: Performs a simple cut of the Source shape and projects the result.
    • Aligned: Cuts the Source shape using a tool created from each segment (edge) of the cutting profile. The results of each cut are projected in a vertical or horizontal array, depending on the orientation of the cutting profile.
    • NoParallel: As Aligned, but profile segments which are parallel to the view direction are skipped.

Notes

  • The DataSection Normal (Vector) property controls which side of the profile is removed and should point generally in the opposite direction of the line of sight represented by the arrows on the section line. Avoid selecting a DataSection Normal (Vector) that is parallel to profile segments (especially the first and last segments) as this prevents the correct calculation of section arrow direction and may generate reversed views.
  • See also TechDraw SectionView

Scripting

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

A Complex Section 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

view = doc.addObject("TechDraw::DrawViewPart", "View")
page.addView(view)
view.Source = box
view.Direction = (0, 0, 1)

section = doc.addObject("TechDraw::DrawComplexSection", "ComplexSection")
page.addView(section)
section.BaseView = view
section.CuttingToolWireObject = profile
section.Direction = (0, 1, 0)
section.SectionNormal = (-1, 0, 0)

Examples

For some more information about section views and some use cases, have a look at: TechDraw section examples.