Draft Edit: Difference between revisions

From FreeCAD Documentation
(Updated for new funtions in 0.19)
(Alt + Left click)
(6 intermediate revisions by 4 users not shown)
Line 16: 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]]
|SeeAlso=[[Std Edit|Std Edit]], [[Draft AddPoint|Draft AddPoint]], [[Draft DelPoint|Draft DelPoint]]
|Version=
|Version=
Line 23: Line 24:


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


<!--T:10-->
<!--T:10-->
Line 35: Line 36:
<translate>
<translate>
<!--T:11-->
<!--T:11-->
{{Caption|Editing a wire}}
{{Caption|Editing a wire, an arc and a cubic bezier curve. Context menu is displayed for a knot of the curve}}


==Usage== <!--T:4-->
==Usage== <!--T:4-->
Line 41: Line 42:
<!--T:5-->
<!--T:5-->
# Select an object.
# Select an object.
# Press the {{Button|[[Image:Draft Edit.png|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.
# 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.
Line 47: Line 48:


<!--T:12-->
<!--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 ''"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.
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-->
<!--T:13-->
The tool mostly works on Draft objects: [[Draft Wire|Draft Wires]s, [[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.
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-->
Line 82: Line 83:
}}
}}


<!--T:17-->
{{Draft Tools navi}}

<!--T:18-->
{{Userdocnavi}}
</translate>
</translate>
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}
{{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.