Draft Edit/en: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
Line 1: Line 1:
<languages/>
<languages/>
{{GuiCommand
{{GuiCommand|Name=Draft Edit|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]|MenuLocation=Draft → Edit}}
|Name=Draft Edit
|MenuLocation=Draft → Edit
|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]
}}


==Description==
==Description==


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. It does nothing more than enter the object's edit mode, so other ways to enter edit mode (such as double-clicking the object in the Tree view) give the same result.
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]].

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.


[[Image:Draft edit example.jpg|400px]]
[[Image:Draft edit example.jpg|400px]]
{{Caption|Editing a wire}}


==How to use==
==How to use==


# Select an object.
# Select a [[Draft Wire|wire]], [[Draft Line|line]], [[Draft Rectangle|rectangle]], [[Draft BSpline|bspline]] or [[Draft Circle|circle]]
# Press the {{KEY|[[Image:Draft Edit.png|16px]] [[Draft Edit]]}} button, or double-click the object in the Tree panel, or use the {{KEY|[[Image:Std Edit.png|16px]] [[Std Edit]]}} tool.
# 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.
# Click on a point 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]]
# 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 {{KEY|'''Finish'''}} button
# Press {{KEY|Esc}} or the {{Button|Close}} button to complete the current command.

The Edit tool only works on one selected object at a time.

The tool mostly works on Draft objects: [[Draft Wire]]s, [[Draft Line]]s, [[Draft Rectangle]]s, [[Draft Circle]]s, [[Draft Arc]]s, [[Draft Polygon]]s, and [[Draft BSpline]]s. Other object types must first be converted to these objects.


==Options==
==Options==


* 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]]}} 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
Some objects allow you to insert or delete points:
* 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
* 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==
==Scripting==
{{Emphasis|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 Tools navi}}
Not available. Each of the above object can be modified by changing its properties directly.
{{Userdocnavi}}
{{clear}}

Revision as of 13:00, 8 January 2019

Draft Edit

Menu location
Draft → Edit
Workbenches
Draft, Arch
Default shortcut
None
Introduced in version
-
See also
None

Description

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.

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

How to use

  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.

The Edit tool only works on one selected object at a time.

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.