Arch SectionPlane/pl

Description
This tool places in the current document a section plane "thing", which defines a section or view plane. The "thing" takes its 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 component and Arch Remove component 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 create a TechDraw ArchView to create a view in a TechDraw page.



Usage

 * 1) Optionally, set the Draft Working Plane to reflect the plane where you want to place the Section Plane.
 * 2) Select objects you want to be included in your section view.
 * 3) Press the  button or press  then  keys.
 * 4) Move/rotate the Section Plane into correct position if needed.
 * 5) Select the Section Plane if not selected already.
 * 6) 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

 * : If this is True, non-solid objects in the set will be disregarded
 * : The length of the section plane gizmo in the 3D view. Doesn't affect the resulting view
 * : The height of the section plane gizmo in the 3D view. Doesn't affect the resulting view
 * : The size of the arrows of the section plane gizmo in the 3D view. Doesn't affect the resulting view
 * : If this is, the whole 3D view will be cut at the location of this section plane.
 * : if this is, it will clip the view to the display height and length of the section plane. This effectively turns the section plane into an orthographic camera, limiting the field of view.



Tweaks

 * Adding manually a property named RotateSolidRender of type App::PropertyAngle to the section plane's View properties (right-click the properties view -> show all, right-click again -> add property) allows to rotate the render when using Solid mode. This is useful when a rendered view has for example both Arch and Draft elements, and the rendering of the Arch elements is rotated in relation to the Draft elements.

Scripting
Arch API and FreeCAD Scripting Basics.

The SectionPlane tool can be used in macros and from the Python console by using the following function:


 * Creates a object from, which is a list of objects.

Example: