Draft Stretch: Difference between revisions

From FreeCAD Documentation
(Updated Options)
(Removed Notes. Moved the main note to Description.)
Line 28: Line 28:


<!--T:7-->
<!--T:7-->
The Stretch tool works for objects like [[Draft Wire|Draft Wire]]s and [[Draft BSpline|Draft BSpline]]s which are defined by many points.
The command can only handle [[Draft_Line|Draft Lines]], [[Draft_Wire|Draft Wires]], [[Draft_Rectangle|Draft Rectangles]], [[Draft_BSpline|Draft BSplines]] and [[Draft_BezCurve|Draft BezCurves]]. All other objects are ignored.


</translate>
</translate>
Line 53: Line 53:
* 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.
* 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.
* Press {{KEY|Esc}} or the {{Button|Close}} button to abort the current command.
* Press {{KEY|Esc}} or the {{Button|Close}} button to abort the current command.

==Notes== <!--T:18-->

<!--T:8-->
* The Stretch tool is designed to work with objects that are comprised of points. By moving only the selected points, the original figure is stretched in the desired direction.
* So far, only [[Draft Line|Draft Line]], [[Draft Wire|Draft Wire]], [[Draft BSpline|Draft BSpline]], [[Draft BezCurve|Draft BezCurve]] and [[Draft Rectangle|Draft Rectangle]] work with this tool.
* [[Draft Circle|Draft Circle]]s and [[Draft Polygon|Draft Polygon]]s are only defined by their centers; the individual edges of those shapes don't have selectable points, and therefore 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|Draft Move]]}}.


==Scripting== <!--T:19-->
==Scripting== <!--T:19-->

Revision as of 10:37, 2 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 Stretch

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

Description

The Draft Stretch 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.

Stretching of three wires by enclosing some vertices and moving them to another position

Usage

  1. Select an object that you wish to stretch.
  2. Press the Draft Stretch 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 add point button.
  4. 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.
  5. Click a third point on the 3D view, or type a coordinate and press the add point button.
  6. 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.

Options

  • 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.
  • Press Esc or the Close button to abort the current command.

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.