Content-type: text/html; charset=UTF-8 Man page of STRETCH

STRETCH

Section: PD Piglet Users Manual (1P)
Updated: PD Piglet Users Manual
Index Return to Main Contents

NAME

STRETCH - Move an internal point of a component

SYNOPSIS

STR [[<component>[<layer>]] {[:P] <xysel> <xyref> <xynewref> } ...

STR [[<component>[<layer>]] {:R <xyll> <xyur> <xyref> <xynewref> } ...

DESCRIPTION

STRetch can move either single vertices or edges of components as selected by <xysel>, or multiple vertices selected by the bounding box <xyll> <xyur>. The default mode is to STRetch by point. To select by region, the ":R" option can be given. Once the mode has been switched to region, the :P option can be used to return to point selection mode.

STRetch by point

STRetch moves either a vertex or an edge of a Rectangle, Line or Polygon to a new location with respect to a specified reference point.

STRetch applied to a Circle modifies the point on the circumference of the circle.

As a convenience, and because STRetch is commonly used to "tidy up" a drawing, a STRetch applied to Notes, Text and Instances behaves the same as the MOVE command.

The <xysel> point selects the component to be modified. The <xyref> point selects the edge or vertex to be modified and acts a reference point for the move. Only components matching the optional <component> and <layer> descriptors will be selected.

The distance between <xyref> and each of the vertices is tested along with the distance between <xyref> and the mid-point of each line, polygon or rectangle segment. If <xyref> is closer to a vertex, then the delta between <xyref> and <xynewref> will be added to the vertex. If <xyref> is closer to a midpoint, then the delta between <xyref> and <xynewref> will be added to both the endpoints of the selected segment.

The placement of <xynewref> is snapped to the nearest grid point such that the angle between <xyref> and <xynewref> satisfies the current <lock> angle set by the LOCK command. This can be used to keep manhattan geometries precisely orthogonal.

STRetch by region

When the :R option is given, STRetch will pull all component points matching the <component> and <layer> descriptors that lie within the bounding box given by <xyll> and <xyur>. Any two diagonal corners of the bounding box may be specified. After entering <xyll> a rubber-banded outline will track the mouse to help with the placement of <xyur>.

Once the components and nodes have been selected, they are moved by the vector difference between <xyref> and <xynewref>. After entering <xyref> all affected components are drawn in rubber-band mode until finally entering <xynewref>.

Components fully enclosed by the bounding box are simply moved.

OPTIONS

<component>: A designator limiting the command to a given component. One of E=everything, A=arc, C=circle, I=instances, L=lines, N=notes, O=oval, P=polygons, R=rectangles, T=text, or a valid instance name. If an instance name is given, only instances of that name will be selected. If no <component> is given, then components of any type may be selected.
<layer>: Layer number, "0" or omitted designates all layers. Not used when <component> is an instance name.
<xysel>: xy-coordinate to select the component to be modified.
<xyll>: xy-coordinate of one corner of the bounding box used to select multiple vertices
<xyur>: xy-coordinate diagonally opposite <xyll> specifying the bounding box used to select multiple vertices
<xyref>: A reference point on the component which selects which vertex or line segment to modify.
<xynewref>: The location for the reference point of the new copy.

AUTHOR

Rick Walker (walker AT omnisterra DOT com)

The PD Piglet homepage is at http://www.omnisterra.com/walker/linux/piglet/intro.htm.

Index

NAME

SYNOPSIS

DESCRIPTION

STRetch by point
STRetch by region
OPTIONS

SEE ALSO

AUTHOR

This document was created by man2html, using the manual pages.
Time: 23:02:03 GMT, May 05, 2026