Donate

Shape2DView

SetStyle

Draft

Description

introduced in 1.0: For each 3D View a separate working plane is stored.

The button in the Draft Tray changes depending on the current working plane. introduced in 1.0: If the working plane is not set to Auto an asterisk (*) is appended to the button label if the origin of the working plane does not match the global origin.

Shapes created on different working planes

Usage with pre-selection

1. Do one of the following:
   • Select a single object. The following objects are supported:
     • Draft WorkingPlaneProxies: the PohledView Data (the camera position) and the PohledVisibility Map (the saved visibility of objects) of the working plane proxy are also restored.
     • Arch Axes (introduced in 1.0)
     • Arch AxisSystems (introduced in 1.0)
     • Arch BuildingParts
     • Arch SectionPlanes
     • Std Parts: to avoid selecting subelements it is advisable to select these in the Tree View.
     • Non-solid objects that consist of a single flat face or a single curved edge, or (introduced in 1.0) that have three or more vertices.
     • Solid objects or objects without a shape that have a ÚdajePlacement property. (introduced in 1.0)
   • Select one or more subelements. You can select:
     • A planar face.
     • A curved edge.
     • Three vertices.
     • An edge and a vertex, or two edges. The combined vertices must define a plane. (introduced in 1.0)
     • A planar face and an edge. (introduced in 1.1)
     • A vertex. The working plane will move its origin to that vertex without changing its orientation (introduced in 1.2)
     • Two vertices. The working plane will move the origin to the first selected vertex and align the X-axis from the first toward the second. (introduced in 1.2)
2. There are several ways to invoke the command:
   • Press the button in the Draft Tray.
   • Draft: Select the Utilities → Working Plane option from the menu, or from the Tree View or 3D View context menu.
   • Draft: Use the keyboard shortcut: W then P.
3. The working plane and the button in the Draft Tray are updated.

Usage with post-selection

1. Invoke the command as explained above.
2. The Working Plane Setup task panel opens. See Options for more information.
3. Do one of the following:
   • Select a single object. See the previous paragraph.
   • Select one or more subelements. See the previous paragraph.
4. Click anywhere in the 3D View to confirm the selection and finish the command.
5. The working plane and the button in the Draft Tray are updated.

Usage with presets

1. Invoke the command as explained above.
2. The Working Plane Setup task panel opens. See Options for more information.
3. Press any of the buttons to finish the command.
4. The working plane and the button in the Draft Tray are updated.

Options

Notes

• It can be useful to align the 3D View with the selected Draft working plane. For example after switching the working plane to Front you may want to switch to the Front view as well.
• The grid can be toggled with the Draft ToggleGrid command.
• By double-clicking Draft WorkingPlaneProxies in the Tree View you can quickly switch between working planes.

Preferences

See also: Preferences Editor and Draft Preferences.

• The grid settings in the task panel as well as several other grid settings are available as preferences: Edit → Preferences → Draft → Grid and Snapping.
• The Snapping radius can also be changed on-the-fly (see Draft Snap) or by changing: Tools → Edit Parameters → BaseApp → Preferences → Mod → Draft → snapRange.

Scripting

introduced in 1.0:

The WorkingPlane module offers two classes to create working plane objects: the PlaneBase class and the PlaneGui class. The second class inherits from the first. Objects of the PlaneGui class interact with the GUI (the Draft Tray button), the 3D View and the grid. PlaneBase objects do not.

Use the get_working_plane() method of the WorkingPlane module to get an instance of the PlaneGui class linked to the current 3D View. The method either returns the existing working plane linked to the view or creates a new working plane if required.

import FreeCAD as App
import WorkingPlane

wp = WorkingPlane.get_working_plane()

origin = App.Vector(0, 0, 0)
normal = App.Vector(1, 1, 1).normalize()
offset = 17
wp.align_to_point_and_axis(origin, normal, offset)

point = App.Vector(10, 15, 2)
projection = wp.project_point(point)
print(projection)

The PlaneBase class can be used to create working planes independent of the GUI:

import WorkingPlane

wp = WorkingPlane.PlaneBase()

Shape2DView

SetStyle

Draft