.ig >>
<STYLE TYPE="text/css">
<!--
        A:link{text-decoration:none}
        A:visited{text-decoration:none}
        A:active{text-decoration:none}
-->
</STYLE>
<title>ploticus: symboldetails 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>symboldetails attribute type</h2></td>
  <td align=right>
  <small>
  <a href="../doc/Welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
  <a href="../doc/Welcome.html">Welcome</a> &nbsp; &nbsp;
  <a href="../gallery/index.html">Gallery</a> &nbsp; &nbsp;
  <a href="../doc/Contents.html">Handbook</a> 
  <td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>

.TH symboldetails_attribute_type PL "25-OCT-2001   PL ploticus.sourceforge.net"
 
.ig >>
<center>
<img src="../gallery/symbols.gif">
</center>
.>>

.SH DESCRIPTION
A \fBsymboldetails\fR attribute
is used to select a geometric 
symbol for marking data points.
An external GIF image file may also be used
as the symbol.
.LP
A symbol detail specification occupies one line in a 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.
Many of the keywords may be abbreviated to two or three characters.

.SH EXAMPLES
.ig >>
<a href="../gallery/symbols2.htm">symbols2<br><img src="../gallery/symbols2.gif"></a>
.>>
.LP
Here is the script that generated the above example:
.IP
.nf
#proc symbol
location: 1 1
symbol: style=outline fillcolor=blue linecolor=red radius=0.1

#proc symbol
location: 2 1
symbol: style=outline fillcolor=blue radius=0.1

#proc symbol
location: 3 1
symbol: style=fill fillcolor=blue radius=0.1

#proc symbol
location: 4 1
symbol: style=outline linecolor=red radius=0.1

#proc symbol
location: 5 1
symbol: style=spokes linecolor=green radius=0.1
.fi
.LP
A Gallery example that uses symbol details specifications (symbol:) is
.ig >>
<a href="../gallery/scatterplot1.htm">
.>>
 scatterplot1 
.ig >>
</a>
.>>

.SH SUB-ATTRIBUTES
.LP
\fBshape\fR=\fIs\fR 
.IP
where \fIs\fR may be one of: \fCtriangle, downtriangle, diamond,
square, pentagon, circle, lefttriangle, righttriangle, nicecircle\fR.  A triangle
points up; a downtriangle points down, etc.  A circle has 12 points; a nicecircle
has 20.
.LP
\fBstyle\fR=\fIs\fR 
.IP
where \fIs\fR may be one of: \fCoutline\fR (draw outline; fill if \fCfillcolor\fR specified),
\fCspokes\fR (draw spokes), and \fCfill\fR (fill with color but don't draw outline).
.LP
\fBradius\fR=\fIr\fR 
.IP
where \fIr\fR is the radius of the symbol in 
.ig >>
<a href="attributetypes.html#positionunits">
.>>
absolute units
.ig >>
</a>
.>>
.LP
\fBfillcolor\fR=
.ig >>
<a href="color.html">
.>>
\fIcolor\fR  
.ig >>
</a>
.>>
.IP
the color to use for filling in the symbol.  
.LP
\fBlinecolor\fR=
.ig >>
<a href="color.html">
.>>
\fIcolor\fR
.ig >>
</a>
.>>
.IP
the color to use for the lines of the symbol.
.LP
\fBlinewidth\fR=\fIlinewidth\fR 
.IP
the linewidth to use for the lines of the symbol.
See 
.ig >>
<a href="linedetails.html">
.>>
 linedetails 
.ig >>
</a>
.>>

.LP
\fBimgfile\fR=\fIname\fR
.IP
the name of an image file to use as the symbol.
Image file format must be the same as the ploticus result.
Formerly called \fCpngfile\fR.


.LP
\fBimgscale\fR=\fIsx\fR[,\fIsy\fR]
.IP
scale factor to apply to symbol imgfile.  If only \fIsx\fR is given,
equal amount of scaling is applied in both X and Y directions.
Otherwise \fIsx\fR is the scale factor in X, and \fIsy\fR the
scale factor in Y.  A scale factor of \fC1.0\fR uses the
original size; a smaller value shrinks the image; a larger value enlarges it.
Formerly called \fCpngscale\fR.

.LP
\fIsymcode\fR 
.IP
a graphcore symcode may be specified directly if desired.
This is a compact specification for selecting a geometric symbol for
marking data points.
The symbol code is a string representation
of the form: \fCsym\fINS\fR[\fIC\fR]\fR,
where \fIN\fR is an integer 1-8 selecting the shape: (1=triangle pointing up;
2=triangle pointing down; 3=diamond; 4=square; 5=pentagon; 6=circle;
7=triangle pointing left; 8=triangle pointing right).
\fIS\fR is either 's' for spokes, 'a' for outline, or 'n' for no outline.
\fIC\fR is a fill color which may be different from current line color
(if omitted, no filling takes place).
.IP
Here is an example:
.br
\fCsym6agreen\fR


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