GuiCommand: Name: Draft Stretch MenuLocation: Modification , Stretch
Modify , Stretch Workbenches: Draft_Workbench, BIM_Workbench Shortcut: S H Version: 0.17

Draft Stretch

Description

The Draft Stretch command stretches objects by moving selected points.

Usage

See also: Draft Snap and Draft Constrain.

1. Optionally select one or more objects. The objects must be Draft Lines, Draft Wires, Draft Rectangles, Draft BSplines or Draft BezCurves. Other objects are ignored.
2. There are several ways to invoke the command:
   • Press the Stretch button.
   • Draft: Select the Modification → Stretch option from the menu.
   • BIM: Select the Modify → Stretch option from the menu.
   • Use the keyboard shortcut: S then H.
3. If you have not yet selected an object: select an object in the 3D view.
4. The Stretch task panel opens. See Options for more information.
5. Pick the first point, one corner of a rectangular selection area, in the 3D view, or type coordinates and press the Enter point button.
6. Pick the second point, the opposite corner of the selection area, in the 3D view, or type coordinates and press the Enter point button.
7. The points of the selected objects that are inside the selection area are marked.
8. Pick the third point, the base point, in the 3D view, or type coordinates and press the Enter point button.
9. Pick the fourth point, the target point, in the 3D view, or type coordinates and press the Enter point button.

Options

The single character keyboard shortcuts available in the task panel can be changed. See Draft Preferences. The shortcuts mentioned here are the default shortcuts.

• To manually enter coordinates enter the X, Y and Z component, and press Enter after each. Or you can press the Enter point button when you have the desired values. It is advisable to move the pointer out of the 3D view before entering coordinates.
• Press R or click the Relative 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 G or click the Global 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.
• Press S to switch Draft snapping on or off.
• Press Esc or the Close button to abort the 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.

⏵ documentation index > Draft > Draft Stretch

This page is retrieved from https://github.com/FreeCAD/FreeCAD-documentation/blob/main/wiki/Draft_Stretch.md