TechDraw SectionView: Difference between revisions

From FreeCAD Documentation
(Moved the info from the Base View paragraph to the Notes paragraph.)
(Properties...)
Line 43: Line 43:


==Properties== <!--T:5-->
==Properties== <!--T:5-->

See also [[TechDraw_View#Properties|TechDraw View]].


=== Data === <!--T:14-->
=== Data === <!--T:14-->

{{TitleProperty|Base}}

See [[TechDraw_View#Properties|TechDraw View]].

{{TitleProperty|Cosmetics}}

See [[TechDraw_View#Properties|TechDraw View]].


{{TitleProperty|Cut Surface Format}}
{{TitleProperty|Cut Surface Format}}
Line 68: Line 62:
* {{PropertyData|Name Geom Pattern|String}}: Name of the PAT pattern to use.
* {{PropertyData|Name Geom Pattern|String}}: Name of the PAT pattern to use.
* {{PropertyData|Hatch Scale|Float}}: Hatch pattern size adjustment.
* {{PropertyData|Hatch Scale|Float}}: Hatch pattern size adjustment.

{{TitleProperty|HLR Parameters}}

See [[TechDraw_View#Properties|TechDraw View]].

{{TitleProperty|Projection}}

See [[TechDraw_View#Properties|TechDraw View]].


{{TitleProperty|Section}}
{{TitleProperty|Section}}
Line 88: Line 74:


=== View === <!--T:15-->
=== View === <!--T:15-->

{{TitleProperty|Base}}

See [[TechDraw_View#Properties|TechDraw View]].


{{TitleProperty|Cut Surface}}
{{TitleProperty|Cut Surface}}
Line 98: Line 80:
* {{PropertyView|Cut Surface Color|Color}}: Solid color for surface highlight. Used if {{PropertyData|Cut Surface Display}} is set to {{Value|Color}}.
* {{PropertyView|Cut Surface Color|Color}}: Solid color for surface highlight. Used if {{PropertyData|Cut Surface Display}} is set to {{Value|Color}}.
* {{PropertyView|Show Cut Surface|Bool}}: Show/hide the cut surface.
* {{PropertyView|Show Cut Surface|Bool}}: Show/hide the cut surface.

{{TitleProperty|Decoration}}

See [[TechDraw_View#Properties|TechDraw View]].

{{TitleProperty|Highlight}}

See [[TechDraw_View#Properties|TechDraw View]].

{{TitleProperty|Lines}}

See [[TechDraw_View#Properties|TechDraw View]].


{{TitleProperty|Surface Hatch}}
{{TitleProperty|Surface Hatch}}

Revision as of 15:50, 10 September 2022

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

See also TechDraw View.

Data

Cut Surface Format

  • DataCut Surface Display (Enumeration): Appearance of 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.
  • ViewShow 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 hath pattern.
  • ViewHatch Cut Surface (Bool): Hatch the cut surface.
  • ViewWeight Pattern (Float): Line weight of the Geometric hatch pattern.

Notes

  • A Section view inherits all applicable properties of the view specified as DataBase View. In the properties of that view you can change the appearance of the section line (ViewSection Line Color and ViewSection Line Style). The default settings for these parameters are set via the settings Section Line and Section Line Style in the TechDraw preferences.
  • 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)