GuiCommand: Name: TechDraw SectionView MenuLocation: TechDraw , TechDraw Views , Insert Section View Workbenches: TechDraw_Workbench SeeAlso: TechDraw_ComplexSection, TechDraw_View
TechDraw SectionView
Description
The TechDraw SectionView tool inserts a cross-section view based on an existing part view.
![](https://raw.githubusercontent.com/FreeCAD/FreeCAD-documentation/master/wiki/images/TechDraw_section_ANSI.png)
![](https://raw.githubusercontent.com/FreeCAD/FreeCAD-documentation/master/wiki/images/TechDraw_section_ISO.png)
The top image shows the ANSI arrow format.
The bottom image shows the ISO arrow format. *
Usage
- Select a part view in the 3D view or Tree view.
- There are several ways to invoke the tool:
- Press the
Insert Section View button.
- Select the TechDraw → TechDraw Views →
Insert Section View option from the menu.
- Press the
- A task panel opens which will help calculate the various properties. Reasonable values for the view Direction are calculated, but these can be changed.
Taskview to define the sectional cut of a view
Properties
See also: Property editor.
In the properties of the Base View you can change the appearance of the section line.
A Section View, formally a {{Incode|TechDraw::DrawViewSection}} object, is derived from a Part View, formally a {{Incode|TechDraw::DrawViewPart}} object, and inherits all its properties. It also has the following additional properties:
Data
{{TitleProperty|Appearance}}
- Section Line Stretch|FloatConstraint: Adjusts the length of the section line. {{Value|1.0}} is normal length, {{Value|1.1}} would be 10% longer, {{Value|0.9}} would be 10% shorter. (v1.0)
{{TitleProperty|Cut Operation}}
-
Fuse Before Cut|Bool: Fuse the source shapes before performing the section cut.
-
Trim After Cut|Bool: Additionally trim the resulting shape after the section cut to remove any unwanted pieces. (v0.21)
-
Use Previous Cut|BoolUse the cut shape from the base view instead of the original object. (v1.0)
{{TitleProperty|Cut Surface Format}}
-
Cut Surface Display|Enumeration: Appearance of the cut surface. Options:
-
{{Value|Hide}}
: Hides the cut surface, only the outline will be displayed.
-
{{Value|Color}}
: Colors the cut surface using the setting of **Cut Surface Color** in the [TechDraw preferences](wiki-test2.php?gitpage=TechDraw_Preferences).
-
{{Value|SvgHatch}}
: Hatches the section cut using a [hatch](wiki-test2.php?gitpage=TechDraw_Hatch)
-
{{Value|PatHatch}}
: Hatches the section cut using a [geometric hatch](wiki-test2.php?gitpage=TechDraw_GeometricHatch)
-
File Hatch Pattern|File: Full path to SVG hatch pattern file.
-
File Geom Pattern|File: Full path to PAT pattern file.
-
Svg Included|FileIncluded: Full path to the included SVG hatch pattern file.
-
Pat Included|FileIncluded: Full path to the included PAT pattern file.
-
Name Geom Pattern|String: Name of the PAT pattern to use.
-
Hatch Scale|Float: Hatch pattern size adjustment.
-
Hatch Rotation|Float: Rotation of hatch pattern in degrees counter-clockwise. (v0.21)
-
Hatch Offset|Vector|Hidden: Hatch pattern offset. (v0.21)
{{TitleProperty|Section}}
-
Section Symbol|String: The identifier for this section.
-
Base View|Link: The view on which this section is based.
-
Section Normal|Vector: A vector describing the direction normal to the cutting plane.
-
Section Origin|Vector: A vector describing a point on the cutting plane. Typically the centroid of the original part.
-
Section Direction|Enumeration: The direction in the Base View for this section. Options: {{Value|Aligned}}, {{Value|Right}}, {{Value|Left}}, {{Value|Up}} or {{Value|Down}}.
View
{{TitleProperty|Cut Surface}}
-
Cut Surface Color|Color: Solid color for surface highlight. Used if Cut Surface Display is set to {{Value|Color}}.
-
Show Cut Surface|Bool|Hidden: Show/hide the cut surface.
{{TitleProperty|Surface Hatch}}
-
Geom Hatch Color|Color: The color of the Geometric hath pattern.
-
Hatch Color|Color: The color of the Svg hatch pattern.
-
Hatch Cut Surface|Bool|Hidden: Hatch the cut surface.
-
Weight Pattern|Float: Line weight of the Geometric hatch pattern.
Notes
- Section Line Format: two section line formats are supported (as depicted above) and controlled by the Preference setting \"Section Line Standard\" on the Annotation tab. The {{Value|ANSI}} option uses \"pulling arrows\" (known as the \"traditional format\" in some areas) and the {{Value|ISO}} option uses \"pushing arrows\" (also known as the \"reference arrow format\").
- Fuse Before Cut: the section operation sometimes fails to cut the source shapes. If Fuse Before Cut 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.
- Trim After Cut: the section cut operation sometimes leaves behind a portion of the source shape. If Trim After Cut is true, an additional cut operation is performed on the result of the first cut which should remove any unwanted pieces.
- Cut Surface Display: 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.
Scripting
See also: Autogenerated API documentation and FreeCAD Scripting Basics.
A SectionView can be created with macros and from the Python console by using the following functions:
doc = FreeCAD.ActiveDocument
box = doc.Box
page = doc.Page
view = doc.addObject("TechDraw::DrawViewPart", "View")
page.addView(view)
view.Source = box
view.Direction = (0, 0, 1)
section = doc.addObject("TechDraw::DrawViewSection", "Section")
page.addView(section)
section.Source = box
section.BaseView = view
section.Direction = (0, 1, 0)
section.SectionNormal = (-1, 0, 0)
doc.recompute()
Examples
For some more information about section views and some use cases, have a look at: TechDraw section examples.
![](https://raw.githubusercontent.com/FreeCAD/FreeCAD-documentation/master/wiki/images/TechDraw_ExampleSection-10.png)
![](https://raw.githubusercontent.com/FreeCAD/FreeCAD-documentation/master/wiki/images/TechDraw_ExampleSection-13.png)
![](https://raw.githubusercontent.com/FreeCAD/FreeCAD-documentation/master/wiki/images/TechDraw_ExampleSection-15.png)
![](https://raw.githubusercontent.com/FreeCAD/FreeCAD-documentation/master/wiki/images/TechDraw_ExampleSection-17.png)
![](https://raw.githubusercontent.com/FreeCAD/FreeCAD-documentation/master/wiki/images/TechDraw_ExampleSection-34.png)
![](https://raw.githubusercontent.com/FreeCAD/FreeCAD-documentation/master/wiki/images/TechDraw_ExampleSection-35.png)
{{TechDraw_Tools_navi}}
⏵ documentation index > TechDraw > TechDraw SectionView
This page is retrieved from https://github.com/FreeCAD/FreeCAD-documentation/blob/main/wiki/TechDraw_SectionView.md