Draft Edit: Difference between revisions

From FreeCAD Documentation
m (template fr)
m ([[ | ]](Vertical Docnav))
(26 intermediate revisions by 4 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]]
}}


==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 Edit tool allows you to edit graphically certain properties of the selected object, such as the vertices of a [[Draft Wire|Draft Wire]], the length and width of a [[Draft Rectangle|Draft Rectangle]], or the radius of a [[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]].
* Pressing the {{KEY|+}} button allows you to add points to Wires and BSplines by clicking on the segments
* Pressing the {{KEY|-}} button allows you to remove points from Wires and BSplines by clicking on the points to remove


</translate>
[[Image:Draft edit example.jpg|400px]]
<translate>
<!--T:11-->
{{Caption|Editing a wire}}


==How to use== <!--T:4-->
{{languages | {{es|Draft Edit/es}} {{fr|Draft Edit/fr}} {{it|Draft Edit/it}} {{se|Draft Edit/se}} }}

<!--T:5-->
# Select an 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.
# 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-->
The Edit tool only works on one selected object at a time.

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

==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
}}

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

<!--T:18-->
{{Userdocnavi}}
</translate>
{{clear}}

Revision as of 09:47, 29 November 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 Wire|Draft Wires]s, 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.