Draft Stretch: Difference between revisions
(Options for the command are those to constrain a point) |
mNo edit summary |
||
(56 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
<translate> |
<translate> |
||
<!--T:12--> |
|||
{{Docnav |
|||
|[[Draft_Trimex|Trimex]] |
|||
|[[Draft_Clone|Clone]] |
|||
|[[Draft_Workbench|Draft]] |
|||
|IconL=Draft_Trimex.svg |
|||
|IconR=Draft_Clone.svg |
|||
|IconC=Workbench_Draft.svg |
|||
}} |
|||
<!--T:1--> |
<!--T:1--> |
||
{{GuiCommand |
{{GuiCommand |
||
|Name=Draft Stretch |
|Name=Draft Stretch |
||
|MenuLocation= |
|MenuLocation=Modification → Stretch |
||
|Workbenches=[[ |
|Workbenches=[[Draft_Workbench|Draft]], [[Arch_Workbench|Arch]] |
||
|Shortcut={{KEY|S}} {{KEY|H}} |
|||
|SeeAlso=[[Draft Offset]], [[Draft Scale]] |
|||
|Version=0.17 |
|Version=0.17 |
||
}} |
}} |
||
==Description== <!--T: |
==Description== <!--T:15--> |
||
The Stretch tool stretches an object by moving some of its vertices. |
|||
<!--T: |
<!--T:2--> |
||
The [[Image:Draft_Stretch.svg|24px]] '''Draft Stretch''' command stretches objects by moving selected points. |
|||
</translate> |
|||
[[Image:Draft_Stretch_Example.jpg|400px]] |
[[Image:Draft_Stretch_Example.jpg|400px]] |
||
<translate> |
|||
<!--T:3--> |
|||
{{Caption|Stretching three Draft Wires}} |
|||
== |
==Usage== <!--T:16--> |
||
# Select an object that you wish to stretch. |
|||
⚫ | |||
# 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. |
|||
<!--T:20--> |
|||
See also: [[Draft_Snap|Draft Snap]] and [[Draft_Constrain|Draft Constrain]]. |
|||
* Press {{KEY|X}}, {{KEY|Y}} or {{KEY|Z}} after the first point to constrain the second point on the given axis. |
|||
* To enter coordinates manually, simply enter the numbers, then press {{KEY|Enter}} between each X, Y and Z component. |
|||
⚫ | |||
* 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. |
|||
⚫ | |||
<!--T:4--> |
|||
# Optionally select one or more objects. The objects must be [[Draft_Line|Draft Lines]], [[Draft_Wire|Draft Wires]], [[Draft_Rectangle|Draft Rectangles]], [[Draft_BSpline|Draft BSplines]] or [[Draft_BezCurve|Draft BezCurves]]. Other objects are ignored. |
|||
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. |
|||
# There are several ways to invoke the command: |
|||
⚫ | |||
#* Select the {{MenuCommand|Modification → [[Image:Draft_Stretch.svg|16px]] Stretch}} option from the menu. |
|||
#* Use the keyboard shortcut: {{KEY|S}} then {{KEY|H}}. |
|||
# If you have not yet selected an object: select an object in the [[3D_view|3D view]]. |
|||
# The {{MenuCommand|Stretch}} task panel opens. See [[#Options|Options]] for more information. |
|||
# Pick the first point, one corner of a rectangular selection area, in the [[3D_view|3D view]], or type coordinates and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button. |
|||
# Pick the second point, the opposite corner of the selection area, in the [[3D_view|3D view]], or type coordinates and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button. |
|||
# The points of the selected objects that are inside the selection area are marked. |
|||
# Pick the third point, the base point, in the [[3D_view|3D view]], or type coordinates and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button. |
|||
# Pick the fourth point, the target point, in the [[3D_view|3D view]], or type coordinates and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button. |
|||
==Options== <!--T:17--> |
|||
<!--T:21--> |
|||
The single character keyboard shortcuts available in the task panel can be changed. See [[Draft_Preferences|Draft Preferences]]. The shortcuts mentioned here are the default shortcuts. |
|||
<!--T:5--> |
|||
* To manually enter coordinates enter the X, Y and Z component, and press {{KEY|Enter}} after each. Or you can press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button when you have the desired values. It is advisable to move the pointer out of the [[3D_view|3D view]] before entering coordinates. |
|||
⚫ | |||
* Press {{KEY|G}} or click the {{MenuCommand|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 [[Draft_SelectPlane|working plane]] coordinate system. {{Version|0.20}} |
|||
* Press {{KEY|S}} to switch [[Draft_Snap|Draft snapping]] on or off. |
|||
⚫ | |||
==Scripting== <!--T:19--> |
|||
<!--T:6--> |
|||
See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]]. |
|||
<!--T:9--> |
|||
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. |
|||
<!--T:11--> |
|||
{{Docnav |
|||
|[[Draft_Trimex|Trimex]] |
|||
|[[Draft_Clone|Clone]] |
|||
|[[Draft_Workbench|Draft]] |
|||
|IconL=Draft_Trimex.svg |
|||
|IconR=Draft_Clone.svg |
|||
|IconC=Workbench_Draft.svg |
|||
}} |
|||
</translate> |
</translate> |
||
{{Draft Tools navi{{#translation:}}}} |
|||
{{Userdocnavi{{#translation:}}}} |
Latest revision as of 18:42, 6 January 2024
Draft Stretch |
Menu location |
---|
Modification → Stretch |
Workbenches |
Draft, Arch |
Default shortcut |
S H |
Introduced in version |
0.17 |
See also |
None |
Description
The Draft Stretch command stretches objects by moving selected points.
Stretching three Draft Wires
Usage
See also: Draft Snap and Draft Constrain.
- 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.
- There are several ways to invoke the command:
- Press the Stretch button.
- Select the Modification → Stretch option from the menu.
- Use the keyboard shortcut: S then H.
- If you have not yet selected an object: select an object in the 3D view.
- The Stretch task panel opens. See Options for more information.
- Pick the first point, one corner of a rectangular selection area, in the 3D view, or type coordinates and press the Enter point button.
- Pick the second point, the opposite corner of the selection area, in the 3D view, or type coordinates and press the Enter point button.
- The points of the selected objects that are inside the selection area are marked.
- Pick the third point, the base point, in the 3D view, or type coordinates and press the Enter point button.
- 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. introduced in version 0.20
- 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.
Draft
- Drafting: Line, Polyline, Fillet, Arc, Arc by 3 points, Circle, Ellipse, Rectangle, Polygon, B-spline, Cubic Bézier curve, Bézier curve, Point, Facebinder, ShapeString, Hatch
- Annotation: Text, Dimension, Label, Annotation styles, Annotation scale
- Modification: Move, Rotate, Scale, Mirror, Offset, Trimex, Stretch, Clone, Array, Polar array, Circular array, Path array, Path link array, Point array, Point link array, Edit, Subelement highlight, Join, Split, Upgrade, Downgrade, Wire to B-spline, Draft to sketch, Set slope, Flip dimension, Shape 2D view
- Draft Tray: Select plane, Set style, Toggle construction mode, AutoGroup
- Snapping: Snap lock, Snap endpoint, Snap midpoint, Snap center, Snap angle, Snap intersection, Snap perpendicular, Snap extension, Snap parallel, Snap special, Snap near, Snap ortho, Snap grid, Snap working plane, Snap dimensions, Toggle grid
- Miscellaneous: Apply current style, Layer, Manage layers, Add a new named group, Move to group, Select group, Add to construction group, Toggle normal/wireframe display, Create working plane proxy, Heal, Show snap toolbar
- Additional: Constraining, Pattern, Preferences, Import Export Preferences, DXF/DWG, SVG, OCA, DAT
- Context menu:
- Layer container: Merge layer duplicates, Add new layer
- Layer: Activate this layer, Select layer contents
- Text: Open hyperlinks
- Wire: Flatten
- Working plane proxy: Write camera position, Write objects state
User documentation
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub