<html>
<head>
<!-- This file has been generated by unroff 1.0, 03/11/09 12:56:23. -->
<!-- Do not edit! -->
<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>
<title>Manual page for symboldetails(PL)</title>
</head>
<body>
<p>
Ploticus plotting procs that render data points use
"symboldetails" specifications for controlling the shape, color, and other details
of the data points.<tt> </tt>
<p>
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.<tt> </tt>
<p>
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.<tt> </tt>
Note: All changes made herein for 2.33 are back compatible - no changes should be necessary to existing applications.<tt> </tt>
<br><br><br>
<h2>Examples</h2>
<p>
An example symboldetails specification: <tt>shape=pixcircle style=solid color=blue</tt>
<br><br>
<p>
A script example that generates various data point symbols:
<a href="../gallery/symbols2.htm">symbols2<br><img src="../gallery/symbols2.gif" border=0></a>
<p>
The first two rows show the new <b>direct pixel</b> data points, in solid and outline styles.<tt> </tt>
These are available in ploticus 2.33+ when rendering on raster devices (GD and X11).<tt> </tt>
The third row shows the <b>vector-based</b> data points that have always been available.<tt> </tt>
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.<tt> </tt>
<br><br>
<h2>Settings</h2>
<p>
<b>shape</b>=<i>s</i>
<dl>
<dt> <dd>
To get direct pixel data points
<i>s</i> can be one of these shapes: <tt>pixcircle pixsquare pixdiamond pixtriangle pixdowntriangle</tt>.<tt> </tt>
<dt><dd><p>
To get vector-based data points <i>s</i> can be one of:
<tt>circle square diamond triangle downtriangle pentagon lefttriangle righttriangle nicecircle</tt>. A triangle
points up; a downtriangle points down, etc. A circle has 12 points; a nicecircle has 20.<tt> </tt>
<dt><dd><p>
We recommend using the <tt>pix*</tt> 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.<tt> </tt>
<br><br>
</dl>
<p>
<b>style</b>=<i>s</i>
<dl>
<dt> <dd>
For direct pixel data points <i>s</i> may be either <tt>outline</tt> (the default), or <tt>solid</tt> (solid color).<tt> </tt>
The <tt>color</tt> setting controls both the outline and fill colors.<tt> </tt>
<dt><dd><p>
For vector-based data points <i>s</i> may be one of: <tt>outline</tt> (the default), <tt>solid</tt> (solid color),
<tt>fill+outline</tt> (solid color with an outline of a different color), or <tt>spokes</tt> (like the spokes of a wheel).<tt> </tt>
The <tt>fill+outline</tt> style requires that <tt>fillcolor</tt> and <tt>linecolor</tt> also be set;
otherwise data point color can be controlled using the <tt>color</tt> setting.<tt> </tt>
<dt><dd><p>
Note: <tt>fill</tt> and <tt>filled</tt> are equivalent to <tt>solid</tt> and can still be used as a style setting.<tt> </tt>
<br><br>
</dl>
<p>
<b>radius</b>=<i>r</i>
<dl>
<dt> <dd>
where <i>r</i> is the radius of the symbol in
<a href="attributetypes.html#positionunits">
inches or cm.<tt> </tt>
</a>
Direct-pixel data points can be rendered in sizes from radius=0.01 to about radius=0.1.<tt> </tt>
Vector-based data points can be rendered in any size.<tt> </tt>
<br><br>
</dl>
<p>
<b>color</b>=<i>color</i>
<dl>
<dt> <dd>
The
<a href="color.html">
color
</a>
to use for the symbol.
This may be used for any style of data point except for <tt>fill+outlined</tt> (where
separate <tt>fillcolor</tt> and <tt>linecolor</tt> settings are required).<tt> </tt>
<br><br>
</dl>
<p>
<b>fillcolor</b>=
<a href="color.html">
color
</a>
<dl>
<dt> <dd>
The fill color for <tt>fill+outlined</tt> data points.<tt> </tt>
<br><br>
</dl>
<p>
<b>linecolor</b>=
<a href="color.html">
color
</a>
<dl>
<dt> <dd>
The outline color for <tt>fill+outlined</tt> data points.<tt> </tt>
<br><br>
</dl>
<p>
<b>linewidth</b>=<i>linewidth</i>
<dl>
<dt> <dd>
the linewidth to use for the lines in vector-based data points. See
<a href="linedetails.html">
linedetails
</a>
<br><br>
</dl>
<p>
<b>imgfile</b>=<i>name</i>
<dl>
<dt> <dd>
If specified, a PNG/GIF/JPEG image will be loaded and displayed as the data point symbol.<tt> </tt>
<i>name</i> is the file name of an image.<tt> </tt>
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.<tt> </tt>
<br><br>
</dl>
<p>
<b>imgwidth</b>=<i>n</i>
<br>
<b>imgheight</b>=<i>n</i>
<dl>
<dt> <dd>
The width and height of the imgfile image in image pixels, or the width and height you want the image to be displayed.<tt> </tt>
<br><br>
</dl>
<p>
<b>imgscale</b>=<i>sx</i>[,<i>sy</i>]
<dl>
<dt> <dd>
scale factor to apply to the <tt>imgfile</tt> symbol.
<b>Discontinued in version 2.40...</b> use imgwidth and imgheight instead.<tt> </tt>
<br><br><br>
</dl>
<h2>Illustration of new direct pixel data points</h2>
<p>
<a href="../gallery/pixpts.htm"><img src="../gallery/pixpts.gif" border=0><br>pixpts</a>
<p>
This illustrates the available shapes, sizes, and styles of the new direct pixel data points.<tt> </tt>
<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 <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> </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>
<p><hr>
Markup created by <em>unroff</em> 1.0, <tt> </tt> <tt> </tt>March 11, 2009.
</body>
</html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
ed05dc5f357c49fdded780f52b150dce
>
files
>
122
