Draft Edit: Difference between revisions

From FreeCAD Documentation
No edit summary
Line 92: Line 92:
#* Use the keyboard shortcut: {{KEY|D}} then {{KEY|E}}.
#* Use the keyboard shortcut: {{KEY|D}} then {{KEY|E}}.
# If you have not yet selected an object: select an object in the [[3D_view|3D view]].
# If you have not yet selected an object: select an object in the [[3D_view|3D view]].
# The selected object is marked with temporary nodes, and the [[#Main_task_panel|main task panel]] opens. See [[#Options|Options]] for more information.
# The selected object is marked with temporary nodes, and the [[#Main_task_panel|Main task panel]] opens. See [[#Options|Options]] for more information.
# Optionally use a node or edge context menu. These context menus are only available for some Draft objects.
# Optionally use a node or edge context menu. These context menus are only available for some Draft objects.
#* Do one of the following:
#* Do one of the following:
Line 102: Line 102:
# Optionally move a node:
# Optionally move a node:
#* Click the node in the [[3D_view|3D view]].
#* Click the node in the [[3D_view|3D view]].
#* The [[#Move_node_task_panel|move node task panel]] opens.
#* The [[#Move_node_task_panel|Move node task panel]] opens.
#* Pick a new point in the [[3D_view|3D view]], or type [[Draft_Coordinates|coordinates]] and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button.
#* Pick a new point in the [[3D_view|3D view]], or type [[Draft_Coordinates|coordinates]] and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button.
#* The result of moving a node depends on the object and the selected node, and in some case on the option selected in the node context menu.
#* The result of moving a node depends on the object and the selected node, and in some case on the option selected in the node context menu.

Revision as of 09:14, 9 June 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.


Usage

See also: Draft Snap and Draft Constrain.

  1. Optionally select one or more objects. Note that although multiple objects can be in Draft Edit mode, objects can only be edited separately.
  2. There are several ways to invoke the command:
    • If you have not yet selected an object: double-click an object in the Tree view. This only work for Draft objects.
    • Press the Draft Edit button.
    • Select the Modification → Edit option from the menu.
    • Use the keyboard shortcut: D then E.
  3. If you have not yet selected an object: select an object in the 3D view.
  4. The selected object is marked with temporary nodes, and the Main task panel opens. See Options for more information.
  5. Optionally use a node or edge context menu. These context menus are only available for some Draft objects.
    • Do one of the following:
      • On all operating systems: hold down E and click the node or edge. To use E you may have to click in the 3D view once to ensure that it has the focus.
      • On Windows: hold down Alt and click the node or edge.
      • On Linux: hold down Shift+Alt, or Ctrl+Alt, and click the node or edge.
      • On macOS: hold down Option and click the node or edge.
    • Select an option from the context menu.
  6. Optionally move a node:
    • Click the node in the 3D view.
    • The Move node task panel opens.
    • Pick a new point in the 3D view, or type coordinates and press the Enter point button.
    • The result of moving a node depends on the object and the selected node, and in some case on the option selected in the node context menu.
  7. Press Esc or the Close button to finish the command.

Options

The single character keyboard shortcuts mentioned here can be changed. See Draft Preferences.

Main task panel

  • Press O or the Close button to finish the command. If a single Draft Wire has been selected the wire is closed.
  • Press Esc or the Close button to finish the command.

Move node task panel

  • To manually enter coordinates enter the X, Y and Z component, and press Enter after each. Or you can press the Enter point button when you have the desired values. It is advisable to move the pointer out of the 3D view before entering coordinates.
  • To use polar coordinates enter a value for the Length and a value for the Angle, and press Enter after each.
  • Check the Angle checkbox to constrain the pointer to the specified angle.
  • The Relative checkbox has no purpose for this command.
  • Press G or click the Global checkbox to toggle global mode. If global mode is on, coordinates are relative to the global coordinate system, else they are relative to the working plane coordinate system. introduced in version 0.20
  • The Continue checkbox has no purpose for this command.
  • The Undo button has no purpose for this command.

Scripting

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

There is no Python method to Draft Edit objects. To emulate the results of the command geometric properties of objects have to be modified.