.ig >>
<STYLE TYPE="text/css">
<!--
        A:link{text-decoration:none}
        A:visited{text-decoration:none}
        A:active{text-decoration:none}
        OL,UL,P,BODY,TD,TR,TH,FORM { font-family: arial,helvetica,sans-serif;; font-size:small; color: #333333; }

        H1 { font-size: x-large; font-family: arial,helvetica,sans-serif; }
        H2 { font-size: large; font-family: arial,helvetica,sans-serif; }
        H3 { font-size: medium; font-family: arial,helvetica,sans-serif; }
        H4 { font-size: small; font-family: arial,helvetica,sans-serif; }
-->
</STYLE>
<title>ploticus: symboldetails</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</h2></td>
  <td align=right>
  <small>
  <a href="../doc/welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
  Version 2.41 Mar2009
  <td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>

.TH symboldetails PL "11-MAR-2009   PL ploticus.sourceforge.net"
 

.LP
Ploticus plotting procs that render data points use 
"symboldetails" specifications for controlling the shape, color, and other details
of the data points.
.LP
Syntax: settings are separated from each other by space, but settings
themselves contain no embedded whitespace.  Also, the entire specification
must be on one line.
.LP
Data points are either vector-based or "direct pixel" (2.33+).  It is also possible
to use a small PNG or JPEG image as the data point.
Note: All changes made herein for 2.33 are back compatible - no changes should be necessary to existing applications.

.ig >>
<br><br><br>
.>>

.SH Examples
.LP
An example symboldetails specification: \fCshape=pixcircle style=solid color=blue\fR

.ig >>
<br><br>
.>>
.LP
A script example that generates various data point symbols:
.ig >>
<a href="../gallery/symbols2.htm">symbols2<br><img src="../gallery/symbols2.gif" border=0></a>
.>>
.LP
The first two rows show the new \fBdirect pixel\fR data points, in solid and outline styles.
These are available in ploticus 2.33+ when rendering on raster devices (GD and X11).
The third row shows the \fBvector-based\fR data points that have always been available.
Note that the new type is sharper and more uniform, while the old type offer more
options including fill+outlined and spoke styles, and unlimited size.

.ig >>
<br><br>
.>>

.SH Settings
.LP
\fBshape\fR=\fIs\fR 
.IP \0
To get direct pixel data points 
\fIs\fR can be one of these shapes: \fCpixcircle pixsquare pixdiamond pixtriangle pixdowntriangle\fR.
.IP 
To get vector-based data points \fIs\fR can be one of:
\fCcircle square diamond triangle downtriangle pentagon lefttriangle righttriangle nicecircle\fR.  A triangle
points up; a downtriangle points down, etc.  A circle has 12 points; a nicecircle has 20.
.IP 
We recommend using the \fCpix*\fR shapes for ongoing development.  These give better-looking
data points for typical applications, and fall back to the vector equivalents on non-raster output devices.

.ig >>
<br><br>
.>>

.LP
\fBstyle\fR=\fIs\fR 
.IP \0
For direct pixel data points \fIs\fR may be either \fCoutline\fR (the default), or \fCsolid\fR (solid color).
The \fCcolor\fR setting controls both the outline and fill colors.
.IP 
For vector-based data points \fIs\fR may be one of: \fCoutline\fR (the default), \fCsolid\fR (solid color),
\fCfill+outline\fR (solid color with an outline of a different color), or \fCspokes\fR (like the spokes of a wheel).
The \fCfill+outline\fR style requires that \fCfillcolor\fR and \fClinecolor\fR also be set;
otherwise data point color can be controlled using the \fCcolor\fR setting.
.IP
Note: \fCfill\fR and \fCfilled\fR are equivalent to \fCsolid\fR and can still be used as a style setting.

.ig >>
<br><br>
.>>

.LP
\fBradius\fR=\fIr\fR 
.IP \0
where \fIr\fR is the radius of the symbol in 
.ig >>
<a href="attributetypes.html#positionunits">
.>>
\0inches or cm.
.ig >>
</a>
.>>
Direct-pixel data points can be rendered in sizes from radius=0.01 to about radius=0.1.
Vector-based data points can be rendered in any size.


.ig >>
<br><br>
.>>
.LP
\fBcolor\fR=\fIcolor\fR
.IP \0
The 
.ig >>
<a href="color.html">
.>>
\0color
.ig >>
</a>
.>>
to use for the symbol.  
This may be used for any style of data point except for \fCfill+outlined\fR (where
separate \fCfillcolor\fR and \fClinecolor\fR settings are required).

.ig >>
<br><br>
.>>
.LP
\fBfillcolor\fR=
.ig >>
<a href="color.html">
.>>
\0color
.ig >>
</a>
.>>
.IP \0
The fill color for \fCfill+outlined\fR data points.

.ig >>
<br><br>
.>>
.LP
\fBlinecolor\fR=
.ig >>
<a href="color.html">
.>>
\0color
.ig >>
</a>
.>>
.IP \0
The outline color for \fCfill+outlined\fR data points.

.ig >>
<br><br>
.>>
.LP
\fBlinewidth\fR=\fIlinewidth\fR 
.IP \0
the linewidth to use for the lines in vector-based data points.  See 
.ig >>
<a href="linedetails.html">
.>>
\0linedetails
.ig >>
</a>
.>>

.ig >>
<br><br>
.>>
.LP
\fBimgfile\fR=\fIname\fR
.IP \0
If specified, a PNG/GIF/JPEG image will be loaded and displayed as the data point symbol.
\fIname\fR is the file name of an image.
Note: If generating PNG/GIF/JPEG, the image type must be the same type as your resulting image; with SVG image type doesn't matter.

.ig >>
<br><br>
.>>
.LP
\fBimgwidth\fR=\fIn\fR
.br
\fBimgheight\fR=\fIn\fR
.IP \0
The width and height of the imgfile image in image pixels, or the width and height you want the image to be displayed.

.ig >>
<br><br>
.>>
.LP
\fBimgscale\fR=\fIsx\fR[,\fIsy\fR]
.IP \0
scale factor to apply to the \fCimgfile\fR symbol.  
\fBDiscontinued in version 2.40...\fR use imgwidth and imgheight instead.

.ig >>
<br><br><br>
.>>
.SH Illustration of new direct pixel data points
.LP
.ig >>
<a href="../gallery/pixpts.htm"><img src="../gallery/pixpts.gif" border=0><br>pixpts</a>
.>>
.LP
This illustrates the available shapes, sizes, and styles of the new direct pixel data points.





.ig >>
<br>
<br>
</td></tr>
<td align=right>
<a href="../doc/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>
<br>
<center>
<table><tr><td>
Ploticus is hosted at http://ploticus.sourceforge.net</td><td> &nbsp; </td><td>
<a href="http://sourceforge.net/projects/ploticus"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=38453&type=12" 
width="120" height="30" border="0" 
alt="Get ploticus data display engine at SourceForge.net. Fast, secure and Free Open Source software downloads" /></a>
</td></tr></table>


</center>
.>>
