<html> <head> <!-- This file has been generated by unroff 1.0, 03/11/09 12:56:19. --> <!-- 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: pie prefab</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>pie prefab</h2></td> <td align=right> <small> <a href="../doc/welcome.html"><img src="../doc/ploticus.gif" border=0></a><br> Version 2.41 Mar2009 </small><br><a href="../doc/prefabs.html">Prefabs</a> <td></tr></table> </td></tr> <td> <br> <br> <title>Manual page for pie_prefab(PL)</title> </head> <body> <center><a href="prefab_pie_ex.html"> <img src="../gallery/prefab_img/pie1thm.gif" border=0> <img src="../gallery/prefab_img/pie4thm.gif" border=0> <br><b>View the pie prefab examples</a></b><br><br></center> <p> <tt>pie</tt> is a <a href="prefabs.html"> prefab </a> for producing pie graphs. <br><br><br> <h2>Parameters</h2> <table cellpadding=2 bgcolor=A0A0A0 width=600> <tr bgcolor=FFFFEC align=center><td><b>Prefab<br>parameter<br>name</td><td>Data type</td> <td>Default</td><td>Description</td> <td>Examples<br><small>(ignore line wrapping)</td></tr> <tr bgcolor=FFFFFF> <td><b><a href="prefab_stdparms.html">Standard parameters</a></td> <td> </td> <td> </td> <td colspan=2>Some of the <a href="prefab_stdparms.html">standard prefab parameters</a> may be used. You <font color=D00000>must specify</font> <b>data</b> (the name of the input data file). The only other standard parameters available with this prefab are those related to getting the plot data and legends (except for <b>name</b>). Note that the <b>legend</b> parameter is used differently with this prefab, than with others (see below). </td> </tr> <tr bgcolor=FFFFFF> <td><b>values</td> <td><a href="atypes.html#dfield">data field</a></td> <td><font color=D00000>must be specified</font></td> <td><nobr>Identifies the data field that will hold</nobr> numeric values for the pie slices. Pie slices will be displayed as proportions of the sum of all values, unless the <b>total</b> parameter is used.</td> <td><tt>values=2<br><br>values=pmb</td> </tr> <tr bgcolor=FFFFFF> <td><b>labelfmtstring</td> <td>string</td> <td> </td> <td>A format string that controls pie slice labels, and allows content to come from one or more data fields. Text may also contain the characters <tt>\n</tt> to symbolize line breaks, and the special symbol <b>@PCT</b> which will evaluate to the percentage of the current slice. Version 2.30+.. supersedes the <tt>labels</tt> parameter described below. </td> <td><tt>labelfmtstring=@1</tt><br><br> <tt>"labelfmtstring= @3\n(@PCT)"</tt><br> (label will be the 3rd data field, and below, the percentage in parentheses) </td> </tr> <tr bgcolor=FFFFFF> <td><b>labels</td> <td><a href="atypes.html#dfield">data field</a></td> <td> </td> <td><nobr>Identifies the data field that will hold</nobr> labels for the pie slices.</td> <td><tt>labels=1<br><br>labels=desc</td> </tr> <tr bgcolor=FFFFFF> <td><b>colorfld</td> <td><a href="atypes.html#dfield">data field</a></td> <td> </td> <td><nobr>Identifies the data field that will hold</nobr> <a href="color.html">colors</a> for the pie slices.</td> <td><tt>labels=1<br>labels=desc</td> </tr> <tr bgcolor=FFFFFF> <td><b>legend</td> <td><tt>yes</tt><br>or<br><a href="atypes.html#xy">x y</a></td> <td> </td> <td>If specified, slices will be labelled using a legend, instead of the default behavior of showing labels near the slices. Slices must have different colors for this to make sense. Legend labels come from the <b>labels</b> data field. (This description overrides the description on the standard parameters page.)</td> <td><tt>legend=yes<br><br>"legend= 0.5 1.2"</td> </tr> <tr bgcolor=FFFFFF> <td><b>lbldet</td> <td><a href="textdetails.html">textdetails</a></td> <td> </td> <td>Specify text appearance details for the pie slice labels.</td> <td><tt>"lbldet= size=8"</td> </tr> <tr bgcolor=FFFFEC> <td colspan=5> <h3>Additional parameters</h3> The following parameters are available and are exactly the same as documented in the <a href="pie.html">proc pie manual page</a> ... see that page for descriptions and usage. All are optional. <br> <br> <b>colors</b> specify colors literally <br> <br> <b>firstslice</b> control degree location of first slice <br> <br> <b>explode</b> explode the slices <br> <br> <b>center</b> specify pie center <br> <br> <b>radius</b> specify pie radius <br> <br> <b>total</b> indicate that sum of slices doesn't add up to full pie <br> <br> <b>labelback</b> backing box for slice labels <br> <br> <b>wraplen</b> wordwrap the label to max n chars per line <br> <br> <b>labelfarout</b> how far out or in labels should be rendered <br> <br> <b>clickmapurl</b> <br> <br> <b>clickmaplabel</b> </td></tr> </table> <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>