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

COPY

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

NAME

COPY - Copy a component from one location to another  

SYNOPSIS

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

DESCRIPTION

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

Components to be copied 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 copied. 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>. Multiple copies can be placed by simply entering more coordinates before terminating the command.

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>. All components lying completely within the bounding box will be selected.

Double clicking on <xyref> will terminate the current copy allowing the selection and copying of a new component.

 

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. Layer number, "0" or omitted designates all layers.
<xysel>
A point to select the component to be copied.
<xyref>
A reference point on the component.
<xynewref>
The location for the reference point of the new copy.
:P
Copy by Point (default). Copy the single component closest to <xysel>.
:R
Copy 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.
 

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
OPTIONS
SEE ALSO
AUTHOR

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