Content-type: text/html Manpage of MOVE


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


MOVE - Move a component from one location to another  


MOV [<component>[<layer>]] { [[:P] <xysel>] | [:R <xy1> <xy2>] xyref xynewref } ... <EOC>  


MOves a component in the current device. Can be optionally restricted to move only a specified <component> and <layer>. In any case, only components which have been made modifiable by the SHOW command can be moved.

Components to be moved can be selected either by point or by region. The default mode is select by point. However, if you change to select by region with :R, you can later change back with :P. The selection mode is "sticky" so you can do multiple moves of the same type without re-entering the option.

When selecting by point, an <xysel> selects and highlights the component to be moved. A bounding box is displayed after the <xyref> reference point is given. The box tracks the mouse until the final location of the reference point is given by <xynewref>. Either a double click on <xynewwref> or an EOC will finalize the move. Until finalized, multiple <xynewref> points can be given to fine tune the placement. EOC does not terminate the command, but will still allow for further MOVes to be made.

The :R options allows selection by region. A bounding box is selected with <xy1> and <xy2>. A rubberband rectangle will be displayed once <xy1> is entered. When <xy2> is entered, the box is remembered, but erased. When the <xyref> reference point is given, the bounding box is redisplayed. The box tracks the mouse until the final location of the reference point is given by <xynewref>.



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 number, "0" or omitted designates all layers. Not used when <component> is an instance name.
A point to select the component to be moved.
A reference point on the component.
The new location for the reference point after the move.
Move by Point (default). Move the single component closest to <xysel>.
Move by Region. Identify zero or more components whose bounding boxes are entirely contained within the rectangular region defined by <xy1> & <xy2>. When selecting by region, a rubber-banded rectangle will be drawn after the first coordinate to help the user define the region.


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)  


Rick Walker (walker AT omnisterra DOT com)

The PD Piglet homepage is at




This document was created by man2html, using the manual pages.
Time: 19:41:46 GMT, May 14, 2010