Draft SelectPlane

Description
The Draft Workbench features a working plane system. A plane in the 3D view indicates where a Draft shape will be built. There are several methods to define the working plane:
 * From a selected face.
 * From three selected vertices.
 * From the current view.
 * From a preset: top, front, or side.
 * None, in which case the working plane is adapted automatically to the current view when you start a command, or to a face if you start drawing on an existing face.



Usage
The button is present in the Draft Tray toolbar, which only appears in the Draft and Arch workbenches.

Without element selected

 * 1) Press the  button, or use  →  →  from the top menu, or the keyboard shortcut  then
 * 2) Select the offset, the grid spacing, and the main lines
 * 3) Select one of the presets:, , , , or.

Once the plane is set, the button will change to indicate the active plane, , , ,.

With element selected

 * 1) Select a face of an existing object in the 3D view, or hold  and select three vertices of any object.
 * 2) Press the  button, or right click and select.

The plane will be created aligned to the face of the object, or to the plane defined by the three vertices.

Options

 * Pressing any of the buttons will finish the command.
 * Press the button to align the working plane with the XY plane of the global coordinate system.
 * Press the button to align the working plane with the XZ plane of the global coordinate system.
 * Press the button to align the working plane with the YZ plane of the global coordinate system.
 * Press the button to align the working plane with the current 3D view. If the  checkbox is unchecked the working plane origin will match the origin of the global coordinate system, else it will match the center of the current 3D view.
 * Press the button to automatically align the working plane with the current 3D view whenever a Draft command requiring point input is started. This is equivalent to pressing the  button before using the command.
 * The defines the perpendicular distance between the selected plane and the working plane.
 * Check the checkbox to put the origin of the working plane in the center of to the current 3D view. This option really only makes sense if the  button is used.
 * Select a vertex in the 3D view and press the button to move the working plane so that its origin matches the position of the selected vertex.
 * The defines the distance between grid lines.
 * The value determines where main grid lines are drawn. Main grid lines are slightly thicker than normal grid lines. For example, if the grid spacing is  and there is a main line every, such a line will occur every.
 * The value determines the number of grid lines in the X and Y direction of the grid.
 * The is the distance at which Draft Snap Grid detects the intersections of grid lines.
 * Press the button to center the 3D view around the origin of the current working plane.
 * Press the button to reset the working plane to its previous position.
 * Press or the  button to abort the command.

Scripting
See also: Autogenerated API documentation and FreeCAD Scripting Basics.

If the Draft Workbench is active the FreeCAD application object has a property which stores the current Draft working plane. You can access this property and apply transformations to it:

It is also possible to create planes independently of the Draft working plane. This can be useful for calculations and projections: