Draft Stretch

Description
The tool stretches an object by moving some of its selected vertices. The equivalent action is editing the object and moving the points manually to a new position.

The command can only handle Draft Lines, Draft Wires, Draft Rectangles, Draft BSplines and Draft BezCurves. All other objects are ignored.



Usage
See also: Draft Snap and Draft Constrain.


 * 1) Optionally select one or more objects.
 * 2) There are several ways to invoke the command:
 * 3) * Press the button.
 * 4) * Select the option from the menu.
 * 5) * Use the keyboard shortcut: then.
 * 6) If you have not yet selected an object: select an object in the 3D view.
 * 7) The  task panel opens. See Options for more information.
 * 8) Pick the first point, one corner of a rectangular selection area, in the 3D view, or type coordinates and press the  button.
 * 9) Pick the second point, the opposite corner of the selection area, in the 3D view, or type coordinates and press the  button.
 * 10) The vertices of the selected objects that are inside the selection area are marked.
 * 11) Pick the third point, the base point, in the 3D view, or type coordinates and press the  button.
 * 12) Pick the fourth point, the target point, in the 3D view, or type coordinates and press the  button.

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


 * To manually enter coordinates enter the X, Y and Z component, and press after each. Or you can press the  button when you have the desired values. It is advisable to move the pointer out of the 3D view before entering coordinates.
 * Press or click the  checkbox to toggle relative mode. If relative mode is on, the coordinates of the second point of the displacement are relative to the first point, else they are relative to the coordinate system origin.
 * Press or click the  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.
 * The checkbox has no purpose for this command.
 * The checkbox has no purpose for this command.
 * Press or the  button to abort the command.

Preferences
See also: Preferences Editor and Draft Preferences.


 * To change the number of decimals used for the input of coordinates:.

Scripting
See also: Autogenerated API documentation and FreeCAD Scripting Basics.

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