Arch SectionPlane: Difference between revisions

Revision as of 19:32, 8 April 2017

Menu location
Arch SectionPlane
Arch -> Section Plane
Workbenches
Arch
Default shortcut
S P
Introduced in version
-
See also
None

Description

This tool places in the current Document a section plane gizmo, which defines a section or view plane. The gizmo take his placement according to the current Draft Working Plane and can be relocated and reoriented by moving and rotating it, until it describes the 2D view you want to obtain. The Section plane object will only consider a certain set of objects. Objects that are selected when you create a Section Plane will be added to that set automatically. Other objects can later be added or removed from a SectionPlane object with the Arch Add and Arch Remove tools, or by double-clicking the Section Plane in the tree view.

The Section Plane alone won't create any view of its objects set. For that, you must either create a Drawing DraftView to create a view on a Drawing page, a Draft Shape2DView to create a view in the 3D document itself, or a TechDraw ArchView to create a view in a TechDraw page.

How to use

Optionally, set the Draft Working Plane to reflect the plane where you want to place the Section Plane
Select objects you want to be included in your section view
Press the SectionPlane button or press S then P keys
Move/rotate the Section Plane into correct position if needed
Select the Section Plane if not selected already
Use either Drawing DraftView, Draft Shape2DView or TechDraw ArchView to create a view

Options

The Section plane object will only consider a certain set of objects, not all the objects of the document. Objects can be added or removed from a SectionPlane object by using the Arch Add and Arch Remove tools, or by double-clicking the Section Plane in the tree view, selecting objects either in the list of in the 3D scene, and pressing the add or remove buttons.

With a section plane object selected, use the Draft Shape2DView tool to create a shape object representing the section view in the document

Create Drawing DraftViews if you are working with the Drawing Workbench, or TechDraw ArchView if you are using the TechDraw Workbench.

The Section Plane can also be used to show the entire 3D view cut by an infinite plane. This is only visual, and won't affect the geometry of the objects being cut.

Properties

DataOnly Solids: If this is True, non-solid objects in the set will be disregarded
ViewDisplay Length: The length of the section plane gizmo in the 3D view. Doesn't affect the resulting view
ViewDisplay Height: The height of the section plane gizmo in the 3D view. Doesn't affect the resulting view
ViewArrow Size: The size of the arrows of the section plane gizmo in the 3D view. Doesn't affect the resulting view
ViewCut View: If this is true, the whole 3D view will be cut at the location of this section plane (experimental).

Scripting

The Section Plane tool can by used in macros and from the python console by using the following function:

makeSectionPlane ([objectslist])

Creates a Section plane objects including the given objects.

Example:

import FreeCAD, Draft, Arch
trace = Draft.makeLine(FreeCAD.Vector (0, 0, 0),FreeCAD.Vector (2, 2, 0))
wall = Arch.makeWall(trace,width=0.1,height=1,align="Center")
Arch.makeSectionPlane([wall])

Other languages:

@@ Line 6: / Line 6: @@
 <!--T:3-->
-This tool places in the current Document a section plane gizmo, which defines a section or view plane. The gizmo take his placement according to the current [[Draft_SelectPlane|Draft Working Plane]] and can be relocated and reoriented by moving and rotating it, until it describes the 2D view you want to obtain. The Section plane object will only consider objects that were selected when it got created. Objects can later be added or removed from a SectionPlane object with the [[Arch Add]] and [[Arch Remove]] tools.
+This tool places in the current Document a section plane gizmo, which defines a section or view plane. The gizmo take his placement according to the current [[Draft_SelectPlane|Draft Working Plane]] and can be relocated and reoriented by moving and rotating it, until it describes the 2D view you want to obtain. The Section plane object will only consider  a certain set of objects. Objects that are selected when you create a Section Plane will be added to that set automatically. Other objects can later be added or removed from a SectionPlane object with the [[Arch Add]] and [[Arch Remove]] tools, or by double-clicking the Section Plane in the tree view.
 <!--T:4-->
-Upon creation, SectionPlane objects also insert a [[Drawing View|view]] of themselves into the active [[Drawing Module|Drawing page]], or create a new page if none exist. You can also add views of Section planes directly in the document, by using the [[Draft Shape2DView]] tool with a section plane selected.
+The Section Plane alone won't create any view of its objects set. For that, you must either create a [[Drawing DraftView|Drawing DraftView]] to create a view on a [[Drawing Module|Drawing page]], a [[Draft Shape2DView]] to create a view in the 3D document itself, or a [[TechDraw NewArch|TechDraw ArchView]] to create a view in a [[TechDraw Module|TechDraw page]].
 <!--T:16-->
@@ Line 17: / Line 17: @@
 <!--T:6-->
-# Set the [[Draft_SelectPlane|Draft Working Plane]]
+# Optionally, set the [[Draft_SelectPlane|Draft Working Plane]] to reflect the plane where you want to place the Section Plane
 # Select objects you want to be included in your section view
 # Press the {{KEY|[[Image:Arch SectionPlane.png|16px]] '''SectionPlane'''}} button or press {{KEY|S}} then {{KEY|P}} keys
-# [[Draft Move|Move]]/[[Draft Rotate|rotate]] the Section Plane into correct position
+# [[Draft Move|Move]]/[[Draft Rotate|rotate]] the Section Plane into correct position if needed
+# Select the Section Plane if not selected already
-# Press the {{KEY|[[Image:Std Recompute.png|16px]] '''Recompute'''}} button to update the view
+# Use either [[Drawing DraftView|Drawing DraftView]], [[Draft Shape2DView]] or [[TechDraw NewArch|TechDraw ArchView]] to create a view
 ==Options== <!--T:7-->
+* The Section plane object will only consider  a certain set of objects, not all the objects of the document. Objects can be added or removed from a SectionPlane object by using the [[Arch Add]] and [[Arch Remove]] tools, or by double-clicking the Section Plane in the tree view, selecting objects either in the list of in the 3D scene, and pressing the '''add''' or remove '''buttons'''.
 <!--T:8-->
@@ Line 32: / Line 35: @@
 <!--T:9-->
+* Create [[Drawing DraftView|Drawing DraftViews]] if you are working with the [[Drawing Module|Drawing Workbench]], or [[TechDraw NewArch|TechDraw ArchView]] if you are using the [[TechDraw Module|TechDraw Workbench]].
-* Create additional [[Drawing View|views]] of a section plane by selecting it, then using the [[Draft Drawing]] tool
 <!--T:18-->
 [[Image:Arch Section example3.jpg|600px]]
+* The Section Plane can also be used to show the entire 3D view cut by an infinite plane. This is only visual, and won't affect the geometry of the objects being cut.
+[[Image:Arch SectionPlane CutView.jpg|600px]]
 ==Properties== <!--T:10-->
 <!--T:11-->
-* {{PropertyView|Display Size}}: The size of the section plane gizmo in the 3D view
+* {{PropertyData|Only Solids}}: If this is True, non-solid objects in the set will be disregarded
+* {{PropertyView|Display Length}}: The length of the section plane gizmo in the 3D view. Doesn't affect the resulting view
+* {{PropertyView|Display Height}}: The height of the section plane gizmo in the 3D view. Doesn't affect the resulting view
+* {{PropertyView|Arrow Size}}: The size of the arrows of the section plane gizmo in the 3D view. Doesn't affect the resulting view
+* {{PropertyView|Cut View}}: If this is true, the whole 3D view will be cut at the location of this section plane (experimental).
 ==Scripting== <!--T:12-->