Draft Edit: Difference between revisions

From FreeCAD Documentation
m (Esc)
(Alt + Left click)
(32 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>
<!--T:16-->
{{Docnav
|[[Draft_Scale|Scale]]
|[[Draft_SubelementHighlight|Subelement highlight]]
|[[Draft_Module|Draft]]
|IconL=Draft_Scale.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_SubelementHighlight.svg
}}

<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand
Line 6: Line 16:
|MenuLocation=Draft → Edit
|MenuLocation=Draft → Edit
|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]
|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]
|Shortcut={{KEY|D}} {{KEY|E}}
|SeeAlso=[[Std Edit|Std Edit]], [[Draft AddPoint|Draft AddPoint]], [[Draft DelPoint|Draft DelPoint]]
|Version=
}}
}}


Line 11: Line 24:


<!--T:3-->
<!--T:3-->
The Edit tool allows you to edit graphically certain properties of the selected object, such as the vertices of a [[Draft Wire]], the length and width of a [[Draft Rectangle]], or the radius of a [[Draft Circle]].
The {{Button|[[Image:Draft_Edit.svg|16px]] [[Draft Edit|Draft Edit]]}} tool allows you to graphically edit certain properties of the selected object, such as:
* the vertices of a {{Button|[[Image:Draft_Wire.svg|16px]] [[Draft Wire|Draft Wire]]}}
* the length and width of a {{Button|[[Image:Draft_Rectangle.svg|16px]] [[Draft Rectangle|Draft Rectangle]]}}
* the radius of a {{Button|[[Image:Draft_Circle.svg|16px]] [[Draft Circle|Draft Circle]]}}


<!--T:10-->
It does nothing more than enter the object's edit mode. Another way to edit the object is by double clicking on the element in the tree view.
It does nothing more than enter the object's edit mode. Another way to edit the object is by double clicking on the element in the tree view.


Line 18: Line 35:
[[Image:Draft edit example.jpg|400px]]
[[Image:Draft edit example.jpg|400px]]
<translate>
<translate>
<!--T:11-->
{{Caption|Editing a wire, an arc and a cubic bezier curve. Context menu is displayed for a knot of the curve}}


==How to use== <!--T:4-->
==Usage== <!--T:4-->


<!--T:5-->
<!--T:5-->
# Select an object.
# Select a [[Draft Wire|Wire]], [[Draft Line|Line]], [[Draft Rectangle|Rectangle]], [[Draft BSpline|BSpline]], [[Draft Circle|Circle]], or [[Draft Polygon|Polygon]], or other object.
# Press the {{Button|[[Image:Draft Edit.png|16px]] [[Draft Edit]]}} button, or double-click the object in the tree view, or use the {{Button|[[Image:Std Edit.png|16px]] [[Std Edit]]}} tool.
# Press the {{Button|[[Image:Draft_Edit.svg|16px]] [[Draft Edit|Draft Edit]]}} button, or double-click the object in the tree view, or use the {{Button|[[Image:Std Edit.png|16px]] [[Std Edit]]}} tool.
# Click on a point that you wish to move.
# Click on a point that you wish to move.
# Click another point on the 3D view, or type a [[Draft_Coordinates|coordinate]] and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint|add point]]}} button.
# Click another point on the 3D view, or type a [[Draft_Coordinates|coordinate]] and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint|add point]]}} button.
# Press {{KEY|Esc}} or the {{Button|Close}} button to complete the current command.
# Press {{KEY|Esc}} or the {{Button|Close}} button to complete the current command.

<!--T:12-->
Version 0.19 added new functionalities to Draft Edit such as multiple object editing and custom context menu. To display the context menu, user can press {{KEY|E}} key or {{KEY|Alt}}+{{KEY|Left click}} while overing an edit node or an edited object. Beware not every object contains custom options, so the context menu will be only displayed for supported objects.

<!--T:13-->
The tool mostly works on Draft objects: [[Draft Wire|Draft Wires]], [[Draft Line|Draft Lines]], [[Draft Rectangle|Draft Rectangles]], [[Draft Circle|Draft Circles]], [[Draft Arc|Draft Arcs]], [[Draft Polygon|Draft Polygons]], and [[Draft BSpline|Draft BSplines]]. Other object types must first be converted to these objects.


==Options== <!--T:6-->
==Options== <!--T:6-->


<!--T:7-->
<!--T:7-->
* The Edit tool only works on one selected object at a time.
* The Edit tool only works on Draft Wires, Rectangles, Circles and Arcs. Other object types must first be converted to Draft objects.
* Click on an edit vertex to move it, click again to release it.
* Press {{KEY|X}}, {{KEY|Y}} or {{KEY|Z}} after a point to constrain the next point on the given axis.
* Press {{KEY|X}}, {{KEY|Y}} or {{KEY|Z}} after a point to constrain the next point on the given axis.
* To enter coordinates manually, simply enter the numbers, then press {{KEY|ENTER}} between each X, Y and Z component.
* To enter coordinates manually, simply enter the numbers, then press {{KEY|Enter}} between each X, Y and Z component. You can press the {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint|add point]]}} button when you have the desired values to insert the point.
* Press {{KEY|CTRL}} while drawing to force [[Draft_Snap|snapping]] your point to the nearest snap location, independently of the distance.
* Hold {{KEY|Ctrl}} while drawing to force [[Draft_Snap|snapping]] your point to the nearest snap location, independently of the distance.
* Press {{KEY|SHIFT}} while drawing to [[Draft_Constrain|constrain]] your next point horizontally or vertically in relation to the last one.
* Hold {{KEY|Shift}} while drawing to [[Draft_Constrain|constrain]] your next point horizontally or vertically in relation to the last one.
* Press {{KEY|ESC}} or the {{KEY|'''Cancel'''}} button or the {{KEY|[[Image:Draft Edit.png|16px]] [[Draft Edit]]}} button again to finish editing.
* Press {{KEY|Esc}} or the {{button|Close}} button or the {{Button|[[Image:Draft Edit.svg|16px]] [[Draft Edit|Draft Edit]]}} button again to finish editing.

* Pressing the {{KEY|[[Image:Draft AddPoint.png|12px]] [[Draft AddPoint|Add point]]}} button allows you to add points to Wires and BSplines by clicking on the segments
<!--T:14-->
* Pressing the {{KEY|[[Image:Draft DelPoint.png|12px]] [[Draft DelPoint|Del point]]}} button allows you to remove points from Wires and BSplines by clicking on the points to remove
Some objects allow you to insert or delete points:
* Press the {{Button|[[Image:Draft AddPoint.svg|16px]] [[Draft AddPoint|add point]]}} button, and then click on the wire or spline to add a new point.
* Press the {{Button|[[Image:Draft DelPoint.svg|16px]] [[Draft DelPoint|remove point]]}} button, and then click on a point along the wire or spline to remove it.


==Scripting== <!--T:8-->
==Scripting== <!--T:8-->
{{Emphasis|See also:}} [[Draft API|Draft API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].


<!--T:9-->
<!--T:9-->
Not available. Each of the above object can be modified by changing its properties directly.
There is no programming interface available for the Edit tool. Each object is modified by changing its attributes directly.

<!--T:15-->
{{Docnav
|[[Draft_Scale|Scale]]
|[[Draft_SubelementHighlight|Subelement highlight]]
|[[Draft_Module|Draft]]
|IconL=Draft_Scale.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_SubelementHighlight.svg
}}

</translate>
</translate>
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Revision as of 17:36, 22 May 2020

Draft Edit

Menu location
Draft → Edit
Workbenches
Draft, Arch
Default shortcut
D E
Introduced in version
-
See also
Std Edit, Draft AddPoint, Draft DelPoint

Description

The Draft Edit tool allows you to graphically edit certain properties of the selected object, such as:

It does nothing more than enter the object's edit mode. Another way to edit the object is by double clicking on the element in the tree view.

File:Draft edit example.jpg

Editing a wire, an arc and a cubic bezier curve. Context menu is displayed for a knot of the curve

Usage

  1. Select an object.
  2. Press the Draft Edit button, or double-click the object in the tree view, or use the Std Edit tool.
  3. Click on a point that you wish to move.
  4. Click another point on the 3D view, or type a coordinate and press the add point button.
  5. Press Esc or the Close button to complete the current command.

Version 0.19 added new functionalities to Draft Edit such as multiple object editing and custom context menu. To display the context menu, user can press E key or Alt+Left click while overing an edit node or an edited object. Beware not every object contains custom options, so the context menu will be only displayed for supported objects.

The tool mostly works on Draft objects: Draft Wires, Draft Lines, Draft Rectangles, Draft Circles, Draft Arcs, Draft Polygons, and Draft BSplines. Other object types must first be converted to these objects.

Options

  • Press X, Y or Z after a point to constrain the next point on the given axis.
  • To enter coordinates manually, simply enter the numbers, then press Enter between each X, Y and Z component. You can press the add point button when you have the desired values to insert the point.
  • Hold Ctrl while drawing to force snapping your point to the nearest snap location, independently of the distance.
  • Hold Shift while drawing to constrain your next point horizontally or vertically in relation to the last one.
  • Press Esc or the Close button or the Draft Edit button again to finish editing.

Some objects allow you to insert or delete points:

  • Press the add point button, and then click on the wire or spline to add a new point.
  • Press the remove point button, and then click on a point along the wire or spline to remove it.

Scripting

See also: Draft API and FreeCAD Scripting Basics.

There is no programming interface available for the Edit tool. Each object is modified by changing its attributes directly.