#set TITLE = "proc line"
#include top


.ig >>
<center>
<img src="../gallery/line0.gif">
</center>
.>>

.SH DESCRIPTION
.LP
\fBproc line\fR may be used to draw arbitrary lines
in scaled space or absolute space.
It is typically used for annotations, etc.
See also \fBproc drawcommands\fR.

.SH MANDATORY ATTRIBUTES
The \fCPoints\fR attribute must be specified.

.SH ATTRIBUTES
.LP
\fBpoints\fR 
.ig >>
<a href="attributetypes.html#text">
.>>
\fI multiline-text\fR
.ig >>
</a>
.>>
.IP
A list of points.  One or more lines.  Ends at first empty (blank) line.  
Each line may have one coordinate pair or two.  If \fBtwo\fR, the
first point is the beginning of a line, and the second point is the end
of a line.  If \fBone\fR, the point is taken as a continuation of line
from previous point.
.br
Example: 
.br
.nf
.ft C
points:	1.0 3.0 1.0 4.5
	3.0 4.5
	3.0 3.0

.fi
.ft R
.LP
\fBnotation\fR \fCabsolute | scaled | locval\fR
.IP
Specifies whether points are to be taken as locations in absolute
space, scaled space, or location values (values ending in \fC(s)\fR
are in scaled space; otherwise absolute space is assumed).
See
.ig >>
<a href="attributetypes.html#positionunits">
.>>
positionunits
.ig >>
</a>
.>>
Default is \fClocval\fR.
.br
Example: \fCnotation: scaled\fR

.LP
\fBlinedetails\fR 
.ig >>
<a href="linedetails.html">
.>>
\fI linedetails \fR
.ig >>
</a>
.>>
.IP
Details controlling the rendering of the line.  
.br
Example: \fClinedetails: width=3 color=green\fR

#include bottom
