Draft Stretch: Difference between revisions
({{Button}} instead of {{KEY}} template) |
(Options for the command are those to constrain a point) |
||
| Line 26: | Line 26: | ||
==Options== <!--T:5--> |
==Options== <!--T:5--> |
||
* Press {{KEY|X}}, {{KEY|Y}} or {{KEY|Z}} after the first point to constrain the second point on the given axis. |
|||
* If no object is selected when starting the command, you will be invited to pick one. But to work on more than one object, you need to have them selected before starting the command. |
|||
* To enter coordinates manually, simply enter the numbers, then press {{KEY|Enter}} between each X, Y and Z component. |
|||
* So far, only [[Draft Wire]], [[Draft Line]], [[Draft BSpline]], [[Draft BezCurve]] and [[Draft Rectangle]] objects will have their individual vertices stretched. All other objects will have their origin point moved if it is inside the selection rectangle. |
|||
* Press {{KEY|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 {{KEY|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 {{KEY|Ctrl}} while drawing to force [[Draft_Snap|snapping]] your point to the nearest snap location, independently of the distance. |
|||
* Hold {{KEY|Shift}} while drawing to [[Draft_Constrain|constrain]] your second point horizontally or vertically in relation to the first one. |
|||
* Press {{KEY|Esc}} or the {{Button|Close}} button to abort the current command. |
|||
==Scripting== <!--T:6--> |
==Scripting== <!--T:6--> |
||
Revision as of 01:58, 17 November 2018
|
|
| Menu location |
|---|
| 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. - Pick the first corner of a selection rectangle.
- Pick the opposite corner of the selection rectangle. The selected vertices get highlighted.
- Pick the first point of the displacement you wish to give to these vertices.
- Pick the end point of the displacement.
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.