Draft Edit: Difference between revisions

From FreeCAD Documentation
mNo edit summary
(Alt + Left click)
(48 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand|Name=Draft_Edit|Workbenches=[[Draft Module|Draft]]|MenuLocation=Draft -> Edit}}
<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-->
⚫
====Description====
{{GuiCommand
|Name=Draft Edit
|MenuLocation=Draft → Edit
|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=
}}


⚫
==Description== <!--T:2-->
This tool allows you to edit graphically certain properties of the selected object, such as the vertices of a Wire, or the length and width of a Rectangle, or the radius of a Circle.


<!--T:3-->
⚫
====Usage====
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-->
* The edit tool only works on one selected object at a time.
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.
* The Edit mode 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.
* Pressing {{KEY|CTRL}} will [[Draft_Snap|snap]] your point to available snap locations.
* Pressing {{KEY|SHIFT}} will lock x and y values together, so the shape is not deformed
* Pressing {{KEY|ESC}} will cancel the operation.
* Pressing the Edit button again also exits edit mode
* Enter numbers to [[Draft_Coordinates|manually insert a coordinate]].


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


⚫
==Usage== <!--T:4-->
{{languages | {{se|Draft Edit/se}} }}

<!--T:5-->
# Select an object.
# 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 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.

<!--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-->

<!--T:7-->
* 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. 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.
* Hold {{KEY|Ctrl}} while drawing to force [[Draft_Snap|snapping]] your point to the nearest snap location, independently of the distance.
* 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 {{button|Close}} button or the {{Button|[[Image:Draft Edit.svg|16px]] [[Draft Edit|Draft Edit]]}} button again to finish editing.

<!--T:14-->
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-->
{{Emphasis|See also:}} [[Draft API|Draft API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].

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

Revision as of 17:36, 22 May 2020

Other languages:

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.

Draft
User documentation
Retrieved from "http://wiki.freecad.org/index.php?title=Draft_Edit&oldid=691595"