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

ADD_CIRCLE

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

NAME

ADD_CIRCLE - Add a circle to the current device  

SYNOPSIS

ADD C<layer> [.<cname>] [@<sname>] [:W<width>] [:R<resolution>] [:Y<yxratio>] <xy1> <xy2>... EOC  

DESCRIPTION

Add a circle. Center point <xy1> and a point on the circumference <xy2> must be specfied. After adding the centerpoint, a "rubber-banded" circle is shown on the screen, creating a circle with a radius coincident with the current mouse position. Entering the second point terminates the command and draws the circle.

The circle will be solid unless a non-zero width is specified, in which case it will be hollow with a wall-thickness of <width>.

NOTE: Circles with width are implemented by drawing a line with width along the perimeter of the circle. This means that the finished circle has an outside dimension <width> larger than drawn.

The <yxratio> argument creates an ellipse with a specified ratio between major and minor axes. In this case, point <xy1> places the center of the oval, and point <xy2> places the extreme of the major axis. Since the major axis follows the second point, the oval can be placed at any arbitrary rotation or size. See "ADD_OVAL" for a method of creating ovals based on foci and radius.

The ":R<resolution>" option gives the resolution in degrees. This is handy for making regular polygons. For instance "ADD C7 :R72" will create a perfect pentagon. The pentagon rotates during rubberband drawing such that the second point, <xy2>, is always on one of the vertices. "ADD C7 :R90" is a way to add a rotated square. "ADD C7 :R120" adds an equilateral triangle.

 

OPTIONS

<layer>
layer number for component
<cname>
component name
<sname>
signal name
<width>
width of line
<resolution>
angle (in degrees) circle resolution (default = 2 degrees)
<yxratio>
y-to-x major/minor ratio for creating ovals (default = 1)
<xy1>
center of the circle.
<xy2>
a point on the radius, or on the major axis if <yxratio>!=1
 

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