Draft Stretch: Difference between revisions

From FreeCAD Documentation
(Options)
(Added Preferences)
Line 57: Line 57:
* The {{MenuCommand|Continue}} checkbox has no purpose for this command.
* The {{MenuCommand|Continue}} checkbox has no purpose for this command.
* Press {{KEY|Esc}} or the {{Button|Close}} button to abort the command.
* Press {{KEY|Esc}} or the {{Button|Close}} button to abort the command.

== Preferences ==

See also: [[Preferences_Editor|Preferences Editor]] and [[Draft_Preferences|Draft Preferences]].

* To change the number of decimals used for the input of coordinates: {{MenuCommand|Edit → Preferences... → General → Units → Units settings → Number of decimals}}.


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

Revision as of 18:11, 10 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

The single character keyboard shortcuts mentioned here can be changed. See Draft Preferences.

  • 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. introduced in version 0.20
  • The Filled checkbox has no purpose for this command.
  • The Continue checkbox has no purpose for this command.
  • Press Esc or the Close button to abort the command.

Preferences

See also: Preferences Editor and Draft Preferences.

  • To change the number of decimals used for the input of coordinates: Edit → Preferences... → General → Units → Units settings → Number of decimals.

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.