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:
{{Page_in_progress}}
<languages/>
<languages/>

{{Docnav
{{Docnav
|[[Draft_PointLinkArray|PointLinkArray]]
|[[Draft_Scale|Scale]]
|[[Draft_SubelementHighlight|Subelement highlight]]
|[[Draft_SubelementHighlight|SubelementHighlight]]
|[[Draft_Module|Draft]]
|[[Draft_Module|Draft]]
|IconL=Draft_Scale.svg
|IconL=Draft_PointLinkArray.svg
|IconR=Draft_SubelementHighlight.svg
|IconR=Draft_SubelementHighlight.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
Line 11: Line 13:
{{GuiCommand
{{GuiCommand
|Name=Draft Edit
|Name=Draft Edit
|MenuLocation=Draft → Edit
|MenuLocation=Modification → Edit
|Workbenches=[[Draft_Module|Draft]], [[Arch_Module|Arch]]
|Workbenches=[[Draft_Module|Draft]], [[Arch_Module|Arch]]
|Shortcut={{KEY|D}} {{KEY|E}}
|Shortcut={{KEY|D}} {{KEY|E}}
Line 24: Line 26:
* the length and width of a {{Button|[[Image:Draft_Rectangle.svg|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.svg|16px]] [[Draft Circle|Draft Circle]]}}
* the radius of a {{Button|[[Image:Draft_Circle.svg|16px]] [[Draft Circle|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.
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_ex_01.jpg|400px]]
{{Caption|Editing a wire, an arc and a cubic bezier curve. Context menu is displayed for a knot of the curve}}
{{Caption|Example presentation of a wire, an arc and a cubic bezier curve.}}

[[Image:Draft_edit_ex_02.jpg|400px]]
{{Caption|Here wire selected}}

[[Image:Draft_edit_ex_03.jpg|400px]]
{{Caption|Here selected wire marked for editing}}


==Usage==
==Usage==


# Select the object you want to change in the [[tree_view|tree view]]. The selected object becomes {{ColoredText|rgb(102, 255, 102)|rgb(8, 8, 8)| green}} in drawing window. {{Version|0.19}}
# 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.
# Press the {{Button|[[Image:Draft_Edit.svg|16px]] [[Draft_Edit|Draft Edit]]}} button, or double-click the object in the [[Tree_view|tree view]], or Select the {{MenuCommand|Edit → [[Image:Std_Edit.svg|16px]] Toggle Edit mode}} option from the menu. The selected object becomes {{ColoredText|rgb(8, 8, 8)|rgb(255, 255, 255)| black}} with {{Value|white}} vertices and in the [[combo_view|Combo View]] panel an edit window is opened.
# 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.


[[Image:Draft_edit_Combo_View_start.jpg|300px]]
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.
{{Caption|Draft Edit Combo View start}}


[[Image:Draft_edit_Combo_View_editmode.jpg|300px]]
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.
{{Caption|Draft Edit Combo View change after selecting specific vertex}}

# Then press {{Button|Ctrl}} + {{Button|alt}} or {{Button|Shift}} + {{Button|alt}} buttons (for Linux OS) respectively {{Button|alt}} button (for Windows OS) and move mouse cursor
##* '''over a line''', then {{Button|Left click}} and the appearing white field shows {{Value|add point}}. If you click on that field a new vertex is added to the line. If you release buttons and push {{Button|esc}} the command will be canceled.
[[Image:Draft_edit_add_point.jpg|500px]]
{{Caption|Draft Edit 3D View add point}}
##* '''over a vertex''', then {{Button|Left click}} and the appearing white field shows {{Value|delete point}}. If you click on that field the vertex is removed from the line. If you release buttons and push {{Button|esc}} the command will be canceled.
[[Image:Draft_edit_delete_point.jpg|500px]]
{{Caption|Draft Edit 3D View delete point}}

# Press {{Button|Esc}} or the {{Button|Close (O)}} button in the task panel to complete the current command.

<strike>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.
</strike>

The tool {{ColoredText||DarkRed|mostly ??}} works on Draft objects: [[Image:Draft_Wire.svg|24px]][[Draft_Wire|Draft Wires]], [[Image:Draft_Line.svg|24px]][[Draft_Line|Draft Lines]], [[Image:Draft_Rectangle.svg|24px]][[Draft_Rectangle|Draft Rectangles]], [[Image:Draft_Circle.svg|24px]][[Draft_Circle|Draft Circles]], [[Image:Draft_Arc.svg|24px]][[Draft_Arc|Draft Arcs]], [[Image:Draft_Polygon.svg|24px]][[Draft_Polygon|Draft Polygons]], and [[Image:Draft_BSpline.svg|24px]][[Draft_BSpline|Draft BSplines]]. Other object types must first be converted to these objects.


==Options==
==Options==
Line 55: Line 78:


==Scripting==
==Scripting==

{{Emphasis|See also:}} [[Draft_API|Draft API]] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].
See also: [https://www.freecadweb.org/api Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].


There is no programming interface available for the Edit tool. Each object is modified by changing its attributes directly.
There is no programming interface available for the Edit tool. Each object is modified by changing its attributes directly.



{{Docnav
{{Docnav
|[[Draft_PointLinkArray|PointLinkArray]]
|[[Draft_Scale|Scale]]
|[[Draft_SubelementHighlight|Subelement highlight]]
|[[Draft_SubelementHighlight|SubelementHighlight]]
|[[Draft_Module|Draft]]
|[[Draft_Module|Draft]]
|IconL=Draft_Scale.svg
|IconL=Draft_PointLinkArray.svg
|IconR=Draft_SubelementHighlight.svg
|IconR=Draft_SubelementHighlight.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
Line 70: Line 95:
{{Draft Tools navi{{#translation:}}}}
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Revision as of 09:47, 20 May 2021

This documentation is a work in progress. Please don't mark it as translatable since it will change in the next hours and days.

Draft Edit

Menu location
Modification → 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.

Example presentation of a wire, an arc and a cubic bezier curve.

Here wire selected

Here selected wire marked for editing

Usage

  1. Select the object you want to change in the tree view. The selected object becomes green in drawing window. introduced in version 0.19
  2. Press the Draft Edit button, or double-click the object in the tree view, or Select the Edit → Toggle Edit mode option from the menu. The selected object becomes black with white vertices and in the Combo View panel an edit window is opened.

Draft Edit Combo View start

Draft Edit Combo View change after selecting specific vertex

  1. Then press Ctrl + alt or Shift + alt buttons (for Linux OS) respectively alt button (for Windows OS) and move mouse cursor
      • over a line, then Left click and the appearing white field shows add point. If you click on that field a new vertex is added to the line. If you release buttons and push esc the command will be canceled.

Draft Edit 3D View add point

      • over a vertex, then Left click and the appearing white field shows delete point. If you click on that field the vertex is removed from the line. If you release buttons and push esc the command will be canceled.

Draft Edit 3D View delete point

  1. Press Esc or the Close (O) button in the task panel 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: Autogenerated API documentation and FreeCAD Scripting Basics.

There is no programming interface available for the Edit tool. Each object is modified by changing its attributes directly.