Draft SetWorkingPlaneProxy

Description
This command will place a Plane Proxy object aligned to the current Working Plane.

This proxy object can be used like a face to quickly change the working plane using the Draft SelectPlane tool. The camera position and visibility of the objects in the 3D view can be saved in the proxy object, and restored at anytime when the Draft SelectPlane tool is used.



How to use

 * 1) Make sure the Working Plane is set as you want.
 * 2) Then go to the menu.

Notes:
 * The working plane stored in the Proxy object can be restored by double-clicking the object in the tree view, or by selecting the Proxy object and using the button.
 * The position of the camera is stored in the Proxy object upon creation. This position can be updated anytime: zoom, pan and rotate the view as you wish, then right-click the Proxy object in the tree view, and select.
 * The visibility state of all objects is also stored in the Proxy object upon creation. This state can be updated anytime: set the property of the objects to  or  as desired, then right-click the Proxy object in the tree view, and select.
 * Plane proxies can be moved and rotated like any other object so that they define the desired working plane. Their visual appearance can also be changed in the property editor.

Data

 * : specifies the position of the proxy object and the corresponding working plane.
 * : specifies the coordinates of the proxy object.
 * : specifies the rotation angle of the proxy object.
 * : specifies the axis to use for the rotation angle.

View

 * : specifies both length and width of the proxy object. If the object is created in the tree view but no element is visible in the 3D view, increase this value until it is visible.
 * : specifies the size of the arrows indicating the three axes of the plane proxy.
 * : if it is the camera position will be restored to the saved position when using the proxy with  or by double-clicking on it.
 * : if it is the visibility state of all objects will be restored to the saved state when using the proxy with  or by double-clicking on it.

Scripting
Draft API and FreeCAD Scripting Basics.

Working plane proxy objects can be used in macros and from the Python console by using the following function:


 * Creates a object from the given  which is a.
 * A placement is defined by a base point, given by its, and a.

The size of the Plane Proxy can be changed by overwriting its and  attributes, with units in millimeters.

The Plane Proxy has a "Face" object as its attribute. This face can be used to set the current working plane by calling its method.

Example: