.ig >>
<STYLE TYPE="text/css">
<!--
        A:link{text-decoration:none}
        A:visited{text-decoration:none}
        A:active{text-decoration:none}
-->
</STYLE>
<title>ploticus: linedetails attribute type</title>
<body bgcolor=D0D0EE vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550 ><tr>
<td>
  <table cellpadding=2 width=550><tr>
  <td><br><h2>linedetails attribute type</h2></td>
  <td align=right>
  <small>
  <a href="Welcome.html"><img src="ploticus.gif" border=0></a><br>
  <a href="Welcome.html">Welcome</a> &nbsp; &nbsp;
  <a href="../gallery/index.html">Gallery</a> &nbsp; &nbsp;
  <a href="Contents.html">Handbook</a> 
  <td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>

.TH linedetails_attribute_type PL "18-JUN-2001   PL www.sgpr.net"

.ig >>
<center>
<a href="../gallery/lines.htm">lines<br><img src="../gallery/lines.gif" border=0></a>
</center>
.>>

.SH DESCRIPTION
A \fBlinedetails\fR attribute type 
controls details
regarding the presentation of line(s), including the line color, width, 
dash pattern, and the scaling of the dashpattern.
These details have defaults that will often be satisfactory; text details
specifications may be used when it is desired to override the defaults.
.LP
Virtually every ploticus attribute comprised of lines has an accompanying 
linedetails attribute.
.LP
A \fBlinedetails\fR attribute occupies one line in the script file,
and contains one or more sub-attribute settings.
A sub-attribute setting has the form \fIsubattribute\fB=\fIvalue\fR
with no embedded spaces.
Multiple sub-attribute settings on the line are separated by white-space.

.SH SUB-ATTRIBUTES

.LP
\fBcolor\fR=
.ig >>
<a href="color.html">
.>>
\fIcolor\fR
.ig >>
</a>
.>>
.IP
specifies the color of the line.  

.LP
\fBwidth\fR=\fIw\fR
.IP
specifies the line width. \fIw\fR is a number between 
0.1 (very thin line) to 10 or so (fat line).  A typical default
value is \fC1.0\fR.

.LP
\fBstyle\fR=\fIn\fR where \fIn\fR is an integer 0 - 9
that controls the dash pattern of the line:
.nf
.ft C
    0 = solid line   1 = _ _ _ _ _  2 = __ __ __ __  3 = ___ ___ ___
    4 = _._._._._   5 = __.__.__.  6 = ___.___.___  7 = _.._.._.._..
    8 = __..__..__  9 = ___..___..__.
.fi
.ft R

.LP
\fBdashscale\fR=\fIz\fR  
.IP
controls scaling of the dash pattern. 1.0 is the default,
2.0 doubles the length of the segments, 3.0 triples it, etc.

.LP
In addition, \fCno\fR or \fCnone\fR may be given as the linedetails
to completely suppress the line in question; likewise \fCyes\fR indicates
that the line be generated using all of the default detail values.

.SH EXAMPLE
Here's an example of a linedetails attribute:
.ft C
.nf
Frame: color=green width=3 style=3 dashscale=4.5
.fi

.ig >>
<br>
<br>
</td></tr>
<td align=right>
<a href="Welcome.html">
<img src="ploticus.gif" border=0></a><br><small>data display engine &nbsp; <br>
<a href="Copyright.html">Copyright Steve Grubb</a>
<br>
<br>
<center>
<img src="../gallery/all.gif">
</center>
</td></tr>
</table>
.>>
