Content-type: text/html; charset=UTF-8
Man page of ADD_INSTANCE
ADD_INSTANCE
Section: PD Piglet Users Manual (1P)
Updated: PD Piglet Users Manual
Index
Return to Main Contents
NAME
ADD_INSTANCE - Add an instance (sub-cell) to the current device
SYNOPSIS
ADD [I] <device> [.<cname>] [@<sname>] [:M<mirror>] [:R<angle>] [:X<x>] [:Y<yxratio>] [:Z<slant>] <xy>... EOC
ADD [I] <device> :S<col>,<row> [.<cname>] [@<sname>] [:M<mirror>] [:R<angle>] [:X<x>] [:Y<yxratio>] [:Z<slant>] <xy1> <xy2> <xy3> EOC
DESCRIPTION
Add a device instance with rotation, scaling, shearing and mirroring.
<mirror> can take the values "X","Y","XY", "0", or "OFF" for mirroring
about the X axis, Y axis, or both. <rotation> is the rotation angle in
decimal degrees in the range -180.00 to +180.00 with 0.01 degree
increment. Multiple devices can be placed with multiple <xy> points.
EOC (or double click) is required to terminate the command.
If the :S option is given, then the instance will be stepped to create
an array of <col> x <row> instances. The <col> columns are spaced evenly
along the line connecting <xy1> and <xy2>, and the <row> rows are
spaced evenly along the line connecting <xy1> and <xy3>. Because there
are no limitations on the placement of the three points, the resulting
array can be rectangular, sheared and/or rotated. Only the placement of
the instances are controlled by <xy1> <xy2> and <xy3> points. The
rotation, mirroring, scaling, and shearing of the individual instances
are controlled independently by the :M,:R,:X,:Y,:Z options as described
above. If it is desired to simulate a rotated rectangular array, then
the appropriate :R option will have to be calculated based on the
placement of the control points. Only one device can be placed with
the :S option and the command terminates after the third required point.
OPTIONS
- <cname>
-
component name
- <sname>
-
signal name
- <mirror>
-
one of "X", "Y", "XY", "0", or "OFF" for mirroring around a specified axis
- <rotation>
-
angle (in degrees) of instance rotation
- <x>
-
scale factor for instance
- <yxratio>
-
y-to-x ratio for creating a "stretched" instance
- <slant>
-
slant angle (degrees) for "shearing" the instance
- <col>,<row>
-
two integers specifying the number of columns and rows
for a stepped instance. ":S1,1" is equivalent to a
non-stepped instance.
- <xy>
-
the location of the instance.
<xy1> <xy2> <xy3>
coordinates controlling the placement and step spacing
for an instance array. <xy1> is the location of the 0,0
corner of the array. There will <row> number of instances
spaced along the line between <xy1> and <xy2>. There will
be <col> number of rows spaced along the line between
<xy1> and <xy3>.
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