TechDraw SectionView

From FreeCAD Documentation
Revision as of 15:09, 27 October 2022 by Wandererfan (talk | contribs)

TechDraw SectionView

Menu location
TechDraw → Insert Section View
Workbenches
TechDraw
Default shortcut
None
Introduced in version
-
See also
TechDraw View, TechDraw Projection Group

Description

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

File:TechDraw Section example.png

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

Usage

  1. Select a part view in the 3D window or tree.
  2. Press the Insert Section View button
  3. 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.
  4. If you make a mistake, or change your mind while setting up the Section parameters, press the Reset button, and you can start over.

Taskview to define the sectional cut of a view

Properties Section View

See also TechDraw View.

Data

Cut Surface Format

  • DataCut Surface Display (Enumeration): Appearance of the cut surface. Options:
    • Hide: Hides the cut surface, only the outline will be displayed.
    • Color: Colors the cut surface using the setting of Cut Surface Color in the TechDraw preferences.
    • SvgHatch: Hatches the section cut using a hatch
    • PatHatch: Hatches the section cut using a geometric hatch
  • DataFile Hatch Pattern (File): Full path to SVG hatch pattern file.
  • DataFile Geom Pattern (File): Full path to PAT pattern file.
  • DataSvg Included (FileIncluded): Full path to the included SVG hatch pattern file.
  • DataPat Included (FileIncluded): Full path to the included PAT pattern file.
  • DataName Geom Pattern (String): Name of the PAT pattern to use.
  • DataHatch Scale (Float): Hatch pattern size adjustment.

Section

  • DataSection Symbol (String): The identifier for this section.
  • DataBase View (Link): The view on which this section is based.
  • DataSection Normal (Vector): A vector describing the direction normal to the cutting plane.
  • DataSection Origin (Vector): A vector describing a point on the cutting plane. Typically the centroid of the original part.
  • DataSection Direction (Vector): The direction in the Base View for this section.
  • DataFuse Before Cut (Bool): Fuse the source shapes before performing the section cut.

View

Cut Surface

  • ViewCut Surface Color (Color): Solid color for surface highlight. Used if DataCut Surface Display is set to Color.
  • View (Hidden)Show Cut Surface (Bool): Show/hide the cut surface.

Surface Hatch

  • ViewGeom Hatch Color (Color): The color of the Geometric hath pattern.
  • ViewHatch Color (Color): The color of the Svg hatch pattern.
  • View (Hidden)Hatch Cut Surface (Bool): Hatch the cut surface.
  • ViewWeight Pattern (Float): Line weight of the Geometric hatch pattern.

Properties Base View

A Section view inherits all applicable properties of the view specified as DataBase View. In the properties of this view you can change the appearance of the section line:

  • ViewSection Line Color: The section line color.
  • ViewSection Line Style: The section line style.

The default settings for these parameters are set via the settings Section Line and Section Line Style in the TechDraw preferences.

Notes

  • 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.
  • CutSurfaceDisplay: the cut surface can be hidden, painted in a solid color, hatched using an Svg pattern (default) or hatched using a PAT pattern. See Hatching.
  • FuseBeforeCut: the section operation sometimes fails to cut the source shapes. If FuseBeforeCut is true, the source shapes are merged into a single shape before the section operation is attempted. If you encounter problems with the section operation, try flipping this value.

Scripting

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)