Entwurf SetzeArbeitsEbeneProxy

From FreeCAD Documentation
Revision as of 22:50, 4 December 2019 by Maker (talk | contribs) (Created page with "==Eigenschaften==")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎italiano • ‎română

Draft SetWorkingPlaneProxy.svg Draft SetWorkingPlaneProxy

Menu location
Draft → Utilities → Create WP Proxy
Draft, Arch
Default shortcut
Introduced in version
See also
Draft SelectPlane


Dieser Befehl platziert ein Ebenen Proxy Objekt, das auf die aktuelle Arbeitsebene ausgerichtet ist.

Dieses Proxy Objekt kann wie eine Fläche verwendet werden, um mit dem Draft SelectPlane/de Werkzeug die Bearbeitungsebene schnell zu wechseln. Die Kameraposition und Sichtbarkeit der Objekte in der 3D Ansicht kann im Proxy Objekt gespeichert und bei Verwendung des Werkzeugs Draft SelectPlane/de jederzeit wiederhergestellt werden.

Draft WPProxy example.png

Drei Proxies der Bearbeitungsebene mit unterschiedlichen Ausrichtungen und Versätzen


  1. Stelle sicher, dass die Arbeitsebene so eingestellt ist, wie Du willst.
  2. Dann gehe zum Menü Draft → Utilities → Draft SetWorkingPlaneProxy.png Arbeitsebenen Proxy erstellen.


  • 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 Draft SelectPlane.svg Draft SelectPlane 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 Draft SelectPlane.svg Write camera position.
  • The visibility state of all objects is also stored in the Proxy object upon creation. This state can be updated anytime: set the ViewVisibility property of the objects to True or False as desired, then right-click the Proxy object in the tree view, and select Draft SelectPlane.svg Write objects state.
  • 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.



  • DataPlacement: specifies the position of the proxy object and the corresponding working plane.
    • DataPosition: specifies the coordinates of the proxy object.
    • DataAngle: specifies the rotation angle of the proxy object.
    • DataAxis: specifies the axis to use for the rotation angle.


  • ViewDisplay Size: 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.
  • ViewArrow Size: specifies the size of the arrows indicating the three axes of the plane proxy.
  • ViewRestore View: if it is True the camera position will be restored to the saved position when using the proxy with Draft SelectPlane.svg Draft SelectPlane or by double-clicking on it.
  • ViewRestore State: if it is True the visibility state of all objects will be restored to the saved state when using the proxy with Draft SelectPlane.svg Draft SelectPlane or by double-clicking on it.


See also: 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:

WPProxy = makeWorkingPlaneProxy(placement)
  • Creates a WPProxy object from the given placement which is a FreeCAD.Placement.
    • A placement is defined by a base point, given by its FreeCAD.Vector, and a FreeCAD.Rotation.

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

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


import FreeCAD, FreeCADGui, Draft

currentWP = FreeCAD.DraftWorkingPlane
place = currentWP.getPlacement()

WPProxy = Draft.makeWorkingPlaneProxy(place)
WPProxy.ViewObject.DisplaySize = 3000
WPProxy.ViewObject.ArrowSize = 200

YAxis = FreeCAD.Vector(0, 1, 0)
point2 = FreeCAD.Vector(3000, 0, 0)
place2 = FreeCAD.Placement(point2, FreeCAD.Rotation(YAxis, 90))

WPProxy2 = Draft.makeWorkingPlaneProxy(place2)
WPProxy2.ViewObject.DisplaySize = 3000
WPProxy2.ViewObject.ArrowSize = 200

Axis = FreeCAD.Vector(1, 1, 1)
point3 = FreeCAD.Vector(-3000, 3000, 0)
place3 = FreeCAD.Placement(point3, FreeCAD.Rotation(Axis, 90))

WPProxy3 = Draft.makeWorkingPlaneProxy(place3)
WPProxy3.ViewObject.DisplaySize = 3000
WPProxy3.ViewObject.ArrowSize = 200