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 Stretch tool works for objects like Draft Wires and Draft BSplines which are defined by many points.



Usage

 * 1) Select an object that you wish to stretch.
 * 2) Press the  button. If no object is selected, you will be invited to select one.
 * 3) Click a point on the 3D view, or type a coordinate and press the  button.
 * 4) Click a second point on the 3D view, or type a coordinate and press the  button. The first two points define a selection rectangle. The vertices of the original object enclosed by this rectangle become highlighted.
 * 5) Click a third point on the 3D view, or type a coordinate and press the  button.
 * 6) Click a fourth point on the 3D view, or type a coordinate and press the  button. The second pair of points define a line, whose distance and direction will be used to stretch the figure attached to the highlighted points.

Options

 * Press, or  after the first point to constrain the second point on the given axis.
 * To enter coordinates manually, simply enter the numbers, then press between each X, Y and Z component.
 * Press or click the checkbox to toggle relative mode. If relative mode is on, the coordinates of the second point are relative to the first one; if not, they are absolute, taken from the origin (0,0,0).
 * Press or click the checkbox to toggle continue mode. If continue mode is on, the Stretch tool will restart after you give the final point, allowing you to repeat the operation without pressing the tool button again.
 * Hold while drawing to force snapping your point to the nearest snap location, independently of the distance.
 * Hold while drawing to constrain your second point horizontally or vertically in relation to the first one.
 * Press or the  button to abort the current command.

Scripting
Draft API and FreeCAD Scripting Basics.

There is no programming interface available for the Stretch tool. All it does is change some attributes of the selected Draft objects, like, , , or , which results in a stretched shape.

When using the Stretch tool the Python console shows the individual commands that were used to produce the stretching of the shape.