Content-type: text/html Manpage 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.
 

SEE ALSO

piglet(1p) add_arc(1p) add_circle(1p) add_instance(1p) add_line(1p) add_note(1p) add_oval(1p) add_polygon(1p) add_rectangle(1p) add_text(1p) archive(1p) area(1p) background(1p) bye(1p) change(1p) copy(1p) date(1p) define(1p) delete(1p) display(1p) distance(1p) dump(1p) echo(1p) edit(1p) equate(1p) exit(1p) files(1p) fsize(1p) grid(1p) group(1p) help(1p) identify(1p) input(1p) interrupt(1p) layer(1p) level(1p) list(1p) lock(1p) macro(1p) menu(1p) move(1p) plot(1p) point(1p) process(1p) purge(1p) quit(1p) redo(1p) retrieve(1p) save(1p) search(1p) set(1p) shell(1p) show(1p) smash(1p) split(1p) step(1p) stretch(1p) trace(1p) tslant(1p) undo(1p) units(1p) version(1p) window(1p) wrap(1p) memory(1p) time(1p)  

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: 19:41:46 GMT, May 14, 2010