Draft Stretch: Difference between revisions

Revision as of 02:35, 17 November 2018

Other languages:

Menu location
Draft Stretch
Draft → Stretch
Workbenches
Draft, Arch
Default shortcut
None
Introduced in version
0.17
See also
Draft Offset, Draft Scale

Description

The Stretch tool stretches an object by moving some of its vertices.

How to use

Select an object that you wish to stretch.
Press the Draft Stretch button. If no object is selected, you will be invited to select one.
Click a point on the 3D view, or type a coordinate and press the add point button.
Click a second point on the 3D view, or type a coordinate and press the add point button. The first two points define a selection rectangle. The vertices of the original object enclosed by this rectangle become highlighted.
Click a third point on the 3D view, or type a coordinate and press the add point button.
Click a fourth point on the 3D view, or type a coordinate and press the add point 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.

The Stretch tool is designed to work with objects that are comprised of many points. By moving these points, the original figure is stretched in the desired direction. So far, only Draft Line, Draft Wire, Draft BSpline, Draft BezCurve and Draft Rectangle work with this tool. Draft Circles and Draft Polygons are only defined by their centers, therefore the individual edges of those shapes don't have selectable points, and can't be stretched. Performing a stretch operation on them will simply move the object, like using Draft Move.

Options

Press X, Y or Z after the first point to constrain the second point on the given axis.
To enter coordinates manually, simply enter the numbers, then press Enter between each X, Y and Z component.
Press R 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 T 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 Ctrl while drawing to force snapping your point to the nearest snap location, independently of the distance.
Hold Shift while drawing to constrain your second point horizontally or vertically in relation to the first one.
Press Esc or the Close button to abort the current command.

Scripting

The Stretch tool has no direct python function because all it does is modify properties of the selected objects, such as the Placement or Points properties of Draft objects. By looking at the python output when using the stretch tool, it is easy to reproduce its working manually.

@@ Line 20: / Line 20: @@
 # Select an object that you wish to stretch.
 # Press the {{Button|[[Image:Draft Stretch.svg|16px]] [[Draft Stretch]]}} button. If no object is selected, you will be invited to select one.
+# Click a 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.
-# Pick the first corner of a selection rectangle.
-# Pick the opposite corner of the selection rectangle. The enclosed vertices become highlighted.
+# Click a second 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. The first two points define a selection rectangle. The vertices of the original object enclosed by this rectangle become highlighted.
+# Click a third 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.
-# Pick the first point of the displacement you wish to give to these vertices.
+# Click a fourth 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. The second pair of points define a line, whose distance and direction will be used to stretch the figure attached to the highlighted points.
-# Pick the end point of the displacement.
-The Stretch tool is designed to work with objects that are comprised of many points. By moving these points, the original figure is stretched in the desired direction. So far, only [[Draft Line]], [[Draft Wire]], [[Draft BSpline]], [[Draft BezCurve]] and [[Draft Rectangle]] work with this tool. [[Draft Circle]]s and [[Draft Polygon]]s are only defined by their centers, therefore the individual edges of those shapes don't have selectable points, and can't be stretched. Performing a stretch operation on them will simply move the object, like using [[Draft Move]].
+The Stretch tool is designed to work with objects that are comprised of many points. By moving these points, the original figure is stretched in the desired direction. So far, only [[Draft Line]], [[Draft Wire]], [[Draft BSpline]], [[Draft BezCurve]] and [[Draft Rectangle]] work with this tool. [[Draft Circle]]s and [[Draft Polygon]]s are only defined by their centers, therefore the individual edges of those shapes don't have selectable points, and can't be stretched. Performing a stretch operation on them will simply move the object, like using {{Button|[[Image:Draft Move.svg|16px]] [[Draft Move]]}}.
 ==Options== <!--T:5-->