Draft Edit: Difference between revisions

From FreeCAD Documentation
m (Put in to unordered list)
No edit summary
(12 intermediate revisions by 5 users not shown)
Line 7: Line 7:
|[[Draft_Module|Draft]]
|[[Draft_Module|Draft]]
|IconL=Draft_Scale.svg
|IconL=Draft_Scale.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_SubelementHighlight.svg
|IconR=Draft_SubelementHighlight.svg
|IconC=Workbench_Draft.svg
}}
}}


Line 15: Line 15:
|Name=Draft Edit
|Name=Draft Edit
|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}}
|Version=
|SeeAlso=[[Std_Edit|Std Edit]], [[Draft_AddPoint|Draft AddPoint]], [[Draft_DelPoint|Draft DelPoint]]
}}
}}


Line 21: Line 24:


<!--T:3-->
<!--T:3-->
The {{Button|[[Image:Draft Edit.png|16px]] [[Draft Edit|Draft Edit]]}} tool allows you to edit graphically 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 33: 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 39: 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 45: 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 {{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.
The Edit tool only works on one selected object at a time.


<!--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 61: Line 64:
<!--T:14-->
<!--T:14-->
Some objects allow you to insert or delete points:
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 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.
* 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]].
{{Emphasis|See also:}} [[Draft_API|Draft API]] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].


<!--T:9-->
<!--T:9-->
Line 76: Line 79:
|[[Draft_Module|Draft]]
|[[Draft_Module|Draft]]
|IconL=Draft_Scale.svg
|IconL=Draft_Scale.svg
|IconR=Draft_SubelementHighlight.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_SubelementHighlight.svg
}}
}}


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

<!--T:18-->
{{Userdocnavi}}
</translate>
</translate>
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}
{{clear}}

Revision as of 16:05, 29 November 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.