#set TITLE = "symboldetails attribute type"
#include top
 
.ig >>
<center>
<a href="../gallery/symbols.htm">symbols<br><img src="../gallery/symbols.gif"></a>
</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
Here is an example of a symboldetails attribute:
.br
\fCpointsymbol: shape=tri style=fill color=purple radius=0.1\fR
.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


#include bottom
