Draft SelectPlane/tr: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
No edit summary
(9 intermediate revisions by one other user not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav
{{Docnav
|[[Draft_Shape2DView|Shape2DView]]
|[[Draft_Stretch|Stretch]]
|[[Draft_SetStyle|SetStyle]]
|[[Draft_FinishLine|Finish line]]
|[[Draft_Module|Draft]]
|[[Draft_Workbench|Draft]]
|IconL=Draft_Stretch.svg
|IconL=Draft_Shape2DView.svg
|IconR=Draft_SetStyle.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_FinishLine.svg
}}
}}


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
{{GuiCommand/tr
{{GuiCommand/tr|Name=Draft SelectPlane|Name/tr=Çalışma düzlemini ayarla|Workbenches=[[Draft Module/tr|Draft]], [[Arch Module/tr|Arch]]|MenuLocation=Draft → Utilities → Select Plane}}
|Name=Draft SelectPlane
|Name/tr=Çalışma düzlemini ayarla
|MenuLocation=Draft → Utilities → Select Plane
|Workbenches=[[Draft_Workbench/tr|Draft]], [[Arch_Workbench/tr|Arch]]
}}
</div>
</div>


==Description==
==Description==


The [[Image:Workbench_Draft.svg|24px]] [[Draft Module|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:
The [[Image:Draft_SelectPlane.svg|24px]] '''Draft SelectPlane''' command selects the current Draft working plane. This is the plane in the [[3D_view|3D view]] where new [[Draft_Workbench|Draft]] objects are created. A new working plane can be based on one of several [[#Usage_with_presets|presets]] or on a selection. The selection can be created before ([[#Usage_with_pre-selection|pre-selection]]) or after ([[#Usage_with_post-selection|post-selection]]) starting the command.
* 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.


[[Image:WorkingPlane_example.png|400px]]
[[Image:WorkingPlane_example.png|400px]]
{{Caption|Different working planes can be set on which to draw shapes}}
{{Caption|Shapes created on different working planes}}


==Usage==
==Usage with pre-selection==


# Do one of the following:
The {{Button|[[Image:Draft SelectPlane.svg|16px]] [[Draft SelectPlane|SelectPlane]]}} button is present in the [[Draft Tray|Draft Tray]] toolbar, which only appears in the [[Draft Module|Draft]] and [[Arch Module|Arch]] workbenches.
#* Select a single object. The following objects are supported:
#** [[Draft_WorkingPlaneProxy|Draft WorkingPlaneProxies]]: the {{PropertyView|View Data}} (the camera position) and the {{PropertyView|Visibility Map}} (the saved visibility of objects) of the working plane proxy are also restored.
#** [[Arch_BuildingPart|Arch BuildingParts]].
#** [[Arch_SectionPlane|Arch SectionPlanes]].
#** [[Std_Part|Std Parts]]: to avoid selecting subelements it is advisable to select these in the [[Tree_view|Tree view]].
#** [[Part_Feature|Part Feature]] objects that have a single face. [[Part_Plane|Part Planes]] for example.
#** Objects that are not [[Part_Feature|Part Feature]] objects and have a {{PropertyData|Placement}} property.
#* Select one or more subelements. You can select:
#** A flat face.
#** Three vertices.
#** A circular edge.
#** Two straight edges that are co-planar but not co-linear.
#** A straight edge and a vertex that does not lie on the (extended) edge.
# There are several ways to invoke the command:
#* Press the {{Button|[[Image:Draft_SelectPlane.svg|16px]] [[Draft_SelectPlane|Draft SelectPlane]]}} button in the [[Draft_Tray|Draft Tray]]. Depending on the current working plane this button can look different.
#* Select the {{MenuCommand|Utilities → [[Image:Draft_SelectPlane.svg|16px]] Select Plane}} option from the menu.
#* Use the keyboard shortcut: {{KEY|W}} then {{KEY|P}}.
# The working plane and the button in the [[Draft_Tray|Draft Tray]] are updated.


==Usage with post-selection==
=== Without element selected ===


# There are several ways to invoke the command:
# Press the {{Button|[[Image:Draft_SelectPlane.svg|16px]] [[Draft SelectPlane|SelectPlane]]}} button, or use {{KEY|Draft}} → {{KEY|Utilities}} → {{KEY|[[Image:Draft_SelectPlane.svg|16px]] [[Draft SelectPlane|SelectPlane]]}} from the top menu, or the keyboard shortcut {{KEY|W}} then {{KEY|P}}
#* Press the {{Button|[[Image:Draft_SelectPlane.svg|16px]] [[Draft_SelectPlane|Draft SelectPlane]]}} button in the [[Draft_Tray|Draft Tray]]. Depending on the current working plane this button can look different.
# Select the offset, the grid spacing, and the main lines
#* Select the {{MenuCommand|Utilities → [[Image:Draft_SelectPlane.svg|16px]] Select Plane}} option from the menu.
# Select one of the presets: {{Button|[[Image:View-top.svg|16px]] XY (top)}}, {{Button|[[Image:View-front.svg|16px]] XZ (front)}}, {{Button|[[Image:View-right.svg|16px]] YZ (side)}}, {{Button|[[Image:View-isometric.svg|16px]] View}}, or {{Button|[[Image:View-axonometric.svg|16px]] Auto}}.
#* Use the keyboard shortcut: {{KEY|W}} then {{KEY|P}}.
# The {{MenuCommand|Working plane setup}} task panel opens. See [[#Options|Options]] for more information.
# Do one of the following:
#* Select a single object. See the [[#Usage_with_pre-selection|previous paragraph]] for the supported objects.
#* Select one or more subelements. You can select:
#** A flat face.
#** Three vertices.
# Click anywhere in the [[3D_view|3D view]] to confirm the selection and finish the command.
# The working plane and the button in the [[Draft_Tray|Draft Tray]] are updated.


==Usage with presets==
Once the plane is set, the button will change to indicate the active plane {{Button|[[Image:Draft_SelectPlane.svg|16px]] Top}}, {{Button|[[Image:Draft SelectPlane.svg|16px]] Front}}, {{Button|[[Image:Draft SelectPlane.svg|16px]] Side}}, {{Button|[[Image:Draft_SelectPlane.svg|16px]] Auto}}, {{Button|[[Image:Draft SelectPlane.svg|16px]] d(0.0,-1.0,0.0)}}.


# There are several ways to invoke the command:
You can show and hide the grid with the shortcut {{KEY|G}} {{KEY|R}}.
#* Press the {{Button|[[Image:Draft_SelectPlane.svg|16px]] [[Draft_SelectPlane|Draft SelectPlane]]}} button in the [[Draft_Tray|Draft Tray]]. Depending on the current working plane this button can look different.
#* Select the {{MenuCommand|Utilities → [[Image:Draft_SelectPlane.svg|16px]] Select Plane}} option from the menu.
#* Use the keyboard shortcut: {{KEY|W}} then {{KEY|P}}.
# The {{MenuCommand|Working plane setup}} task panel opens. See [[#Options|Options]] for more information.
# Press any of the buttons to finish the command.
# The working plane and the button in the [[Draft_Tray|Draft Tray]] are updated.


==Options==
=== With element selected ===


* Press the {{Button|[[Image:View-top.svg|16px]] Top (XY)}} button to align the working plane with the XY plane of the global coordinate system.
# Select a face of an existing object in the [[3D view]], or hold {{KEY|Ctrl}} and select three vertices of any object. {{Version|0.17}}
# Press the {{Button|[[Image:Draft SelectPlane.svg|16px]] [[Draft SelectPlane|SelectPlane]]}} button, or right click and select {{MenuCommand|Utilities [[Image:Draft SelectPlane.svg|16px]] [[Draft SelectPlane|SelectPlane]]}}.
* Press the {{Button|[[Image:View-front.svg|16px]] Front (XZ)}} button to align the working plane with the XZ plane of the global coordinate system.
* Press the {{Button|[[Image:View-right.svg|16px]] Side (YZ)}} button to align the working plane with the YZ plane of the global coordinate system.
* Press the {{Button|[[Image:View-isometric.svg|16px]] Align to view}} button to align the working plane with the current [[3D_view|3D view]]. If the {{MenuCommand|Center plane on view}} 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|3D view]].
* Press the {{Button|[[Image:View-axonometric.svg|16px]] Automatic}} button to automatically align the working plane with the current [[3D_view|3D view]] whenever a Draft or [[Arch_Workbench|Arch]] command requiring point input is started. This is equivalent to pressing the {{Button|[[Image:View-isometric.svg|16px]] Align to view}} button before using the command.
* The {{MenuCommand|Offset}} defines the perpendicular distance between the calculated plane and the actual working plane.
* Check the {{MenuCommand|Center plane on view}} checkbox to put the origin of the working plane in the center of to the current [[3D_view|3D view]]. This option really only makes sense if the {{Button|[[Image:View-isometric.svg|16px]] Align to view}} button is used.
* Select a vertex in the [[3D_view|3D view]] and press the {{Button|[[Image:Draft_Move.svg|16px]] Move working plane}} button to move the working plane so that its origin matches the position of the selected vertex.
* The {{MenuCommand|Grid spacing}} defines the distance between grid lines.
* The {{MenuCommand|Main line every}} 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 {{Value|0.5 m}} and there is a main line every {{Value|10 lines}}, such a line will occur every {{Value|5 m}}.
* The {{MenuCommand|Grid extension}} value determines the number of grid lines in the X and Y direction of the grid.
* The {{MenuCommand|Snapping radius}} is the maximum distance at which [[Draft_Snap_Grid|Draft Snap Grid]] detects the intersections of grid lines.
* Press the {{Button|[[Image:view-fullscreen.svg|16px]] Center view}} button to use the origin of the current working plane as the center of the [[3D_view|3D view]].
* Press the {{Button|[[Image:edit-undo.svg|16px]] Previous}} button to reset the working plane to its previous position.
* Press {{KEY|Esc}} or the {{button|Close}} button to abort the command.


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


* It can be useful to align the [[3D_view|3D view]] with the selected Draft working plane. For example after switching the working plane to Front you may want to switch to the [[Std_ViewFront|Front view]] as well.
==Options==
* The grid can be toggled with the [[Draft_ToggleGrid|Draft ToggleGrid]] command.
* By double-clicking [[Draft_WorkingPlaneProxy|Draft WorkingPlaneProxies]] in the [[Tree_view|Tree view]] you can quickly switch between working planes.

==Preferences==

See also: [[Preferences_Editor|Preferences Editor]] and [[Draft_Preferences|Draft Preferences]].


* The grid settings in the task panel as well as several other grid settings are available as preferences: {{MenuCommand|Edit → Preferences... → Draft → Grid and snapping → Grid}}.
* Press the {{Button|[[Image:View-top.svg|16px]] XY (top)}} button to set the working plane on the XY plane. To easily draw on this plane, you should set the view to the top or bottom (the normal is in the positive or negative Z direction). Press {{KEY|2}} or {{KEY|5}} to quickly switch to these views.
* To use the grid the {{MenuCommand|Edit → Preferences... → Draft → Grid and snapping → Grid → Use grid}} option must be selected. After changing this preference you must restart FreeCAD.
* Press the {{Button|[[Image:View-front.svg|16px]] XZ (front)}} button to set the working plane on the XZ plane. To easily draw on this plane, you should set the view to the front or rear (the normal is in the negative or positive Y direction). Press {{KEY|1}} or {{KEY|4}} to quickly switch to these views.
* The Snapping radius can also be changed on-the-fly (see [[Draft_Snap#Preferences|Draft Snap]]) or by changing: {{MenuCommand|Tools → Edit parameters... → BaseApp → Preferences → Mod → Draft → snapRange}}.
* Press the {{Button|[[Image:View-right.svg|16px]] YZ (side)}} button to set the working plane on the YZ plane. To easily draw on this plane, you should set the view to the left or right side (the normal is in the positive or negative X direction). Press {{KEY|3}} or {{KEY|6}} to quickly switch to these views.
* Press the {{Button|[[Image:View-isometric.svg|16px]] View}} button to set the working plane to the current 3D view, perpendicular to the camera axis and passing through the origin (0,0,0).
* Press the {{Button|[[Image:View-axonometric.svg|16px]] Auto}} button to unset any current working plane, and automatically set a working plane when a tool is used. When a drawing tool is selected the grid will be automatically updated to the current view; then, if the view is rotated, and another tool is selected, the grid redraws in the new view. This is equivalent of pressing {{Button|[[Image:View-isometric.svg|16px]] View}} automatically before using a tool.
* Set the "Offset" value to set the working plane at a certain perpendicular distance from the plane you selected.
* Set the "Grid spacing" value to define the space between each line in the grid.
* Set the "Main line every" value to draw a slightly thicker line in the grid at the set value. For example, if the grid spacing is 0.5 m, and there is a main line every 20 lines, there will be slightly thicker line every 10 m.
* Click on the "Center plane on view" checkbox to draw the plane and grid closer to the camera view in the 3D view.
* Press {{KEY|Esc}} or the {{button|Close}} button to abort the current command.


==Scripting==
==Scripting==
{{emphasis|See also:}} [[Draft API|Draft API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]]. See the [http://www.freecadweb.org/api/DraftWorkingPlane.html WorkingPlane API].


See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
Working plane objects can easily be created and manipulated in [[macros|macros]] and from the [[Python|Python]] console.


You can access the current Draft working plane, and apply transformations to it:
If the [[Draft_Workbench|Draft Workbench]] is active the FreeCAD application object has a {{incode|DraftWorkingPlane}} property which stores the current Draft working plane. You can access this property and apply transformations to it:


{{Code|code=
{{Code|code=
# This code only works if the Draft Workbench is active!

import FreeCAD as App
import FreeCAD as App
import FreeCADGui as Gui
import FreeCADGui as Gui
Line 80: Line 127:
}}
}}


It is also possible to create planes independently of the Draft working plane. This can be useful for calculations and projections:
A Draft command must be issued after changing the working plane to update the visible grid, for example, [[Draft_Line|Line]], or just [[Draft_ToggleGrid|ToggleGrid]].

You can create your own planes, and use them independently of the current working plane. This is useful if you need to make calculations or projections in these other planes.


{{Code|code=
{{Code|code=
Line 97: Line 142:
}}
}}


To display a new grid use a new tracker object. First set up the normal working plane as you need, then create a new tracker object, then set it to the current plane, and then you can turn it on or off.
{{Code|code=
import FreeCAD as App
import DraftTrackers

App.DraftWorkingPlane.alignToPointAndAxis(App.Vector(0, 0, 0),
App.Vector(1, 0, 0),
0)

my_grid = DraftTrackers.gridTracker()
my_grid.set()
my_grid.on()
my_grid.off()
}}

This grid is merely a visual aid and doesn't allow snapping.

To have the possibility of switching quickly to different grids, in different positions, you should create a {{Button|[[File:Draft_SetWorkingPlaneProxy.svg|16px]] [[Draft_SetWorkingPlaneProxy|Working plane proxy]]}}.


{{Docnav
{{Docnav
|[[Draft_Shape2DView|Shape2DView]]
|[[Draft_Stretch|Stretch]]
|[[Draft_SetStyle|SetStyle]]
|[[Draft_FinishLine|Finish line]]
|[[Draft_Module|Draft]]
|[[Draft_Workbench|Draft]]
|IconL=Draft_Stretch.svg
|IconL=Draft_Shape2DView.svg
|IconR=Draft_SetStyle.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_FinishLine.svg
}}
}}


{{Draft Tools navi{{#translation:}}}}
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Revision as of 19:03, 4 September 2021

Çalışma düzlemini ayarla

Menü konumu
Draft → Utilities → Select Plane
Tezgahlar
Draft, Arch
Varsayılan kısayol
Hiçbiri
Versiyonda tanıtıldı
-
Ayrıca bkz
Hiçbiri

Description

The Draft SelectPlane command selects the current Draft working plane. This is the plane in the 3D view where new Draft objects are created. A new working plane can be based on one of several presets or on a selection. The selection can be created before (pre-selection) or after (post-selection) starting the command.

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:
    • Select one or more subelements. You can select:
      • A flat face.
      • Three vertices.
      • A circular edge.
      • Two straight edges that are co-planar but not co-linear.
      • A straight edge and a vertex that does not lie on the (extended) edge.
  2. There are several ways to invoke the command:
    • Press the Draft SelectPlane button in the Draft Tray. Depending on the current working plane this button can look different.
    • Select the Utilities → Select Plane option from the menu.
    • 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. There are several ways to invoke the command:
    • Press the Draft SelectPlane button in the Draft Tray. Depending on the current working plane this button can look different.
    • Select the Utilities → Select Plane option from the menu.
    • Use the keyboard shortcut: W then P.
  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 for the supported objects.
    • Select one or more subelements. You can select:
      • A flat face.
      • Three vertices.
  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. There are several ways to invoke the command:
    • Press the Draft SelectPlane button in the Draft Tray. Depending on the current working plane this button can look different.
    • Select the Utilities → Select Plane option from the menu.
    • Use the keyboard shortcut: W then P.
  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

  • Press the Top (XY) button to align the working plane with the XY plane of the global coordinate system.
  • Press the Front (XZ) button to align the working plane with the XZ plane of the global coordinate system.
  • Press the Side (YZ) button to align the working plane with the YZ plane of the global coordinate system.
  • Press the Align to view button to align the working plane with the current 3D view. If the Center plane on view 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 Automatic button to automatically align the working plane with the current 3D view whenever a Draft or Arch command requiring point input is started. This is equivalent to pressing the Align to view button before using the command.
  • The Offset defines the perpendicular distance between the calculated plane and the actual working plane.
  • Check the Center plane on view 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 Align to view button is used.
  • Select a vertex in the 3D view and press the Move working plane button to move the working plane so that its origin matches the position of the selected vertex.
  • The Grid spacing defines the distance between grid lines.
  • The Main line every 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 0.5 m and there is a main line every 10 lines, such a line will occur every 5 m.
  • The Grid extension value determines the number of grid lines in the X and Y direction of the grid.
  • The Snapping radius is the maximum distance at which Draft Snap Grid detects the intersections of grid lines.
  • Press the Center view button to use the origin of the current working plane as the center of the 3D view.
  • Press the Previous button to reset the working plane to its previous position.
  • Press Esc or the Close button to abort the command.

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 → Grid.
  • To use the grid the Edit → Preferences... → Draft → Grid and snapping → Grid → Use grid option must be selected. After changing this preference you must restart FreeCAD.
  • 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

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

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

# This code only works if the Draft Workbench is active!

import FreeCAD as App
import FreeCADGui as Gui

workplane = App.DraftWorkingPlane

v1 = App.Vector(0, 0, 0)
v2 = App.Vector(1, 1, 1).normalize()

workplane.alignToPointAndAxis(v1, v2, 17)
Gui.Snapper.toggleGrid()
Gui.Snapper.toggleGrid()

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

import WorkingPlane

my_plane = WorkingPlane.plane()

v1 = App.Vector(0, 0, 0)
v2 = App.Vector(1, 1, 1).normalize()
my_plane.alignToPointAndAxis(v1, v2, 17)

projection = my_plane.projectPoint(App.Vector(10, 15, 2))
print(projection)