<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: draw 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>draw 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 draw_prefab(PL)</title> </head> <body> <p> <tt>draw</tt> is a <a href="prefabs.html"> prefab </a> that reads and executes sets of commands which specify low-level drawing operations.<tt> </tt> <p> The commands may be one of <b>two distinct types</b>: <ul> <li> a ploticus drawdump file - a file that has been created previously by running <tt>pl -drawdump</tt> or <tt>pl -drawdumpa</tt> .<tt> </tt> Often used with prefabs as a <a href="prefabs.html#drawdump"> convenient way to overlay or combine graphs.<tt> </tt> </a> <br><br> <li> ploticus draw commands - a command language described below for creating lines, polygons, and text, in either absolute space or scaled space. May be useful as a flexible way to add annotation, or to add graphics that the other plotting procedures cannot produce, or to import graphics generated programatically.<tt> </tt> </ul> <p> If you use the <tt>dumpfile</tt> attribute, drawdump content is expected. Otherwise, ploticus draw commands are expected.<tt> </tt> <br><br><br> <h2>Parameters</h2> <dl> <dt> <dd> If using <tt>dumpfile</tt>, none of the standard prefab parameters are applicable.<tt> </tt> If you're processing ploticus draw commands, and are using commands that operate in scaled space, the following <a href="prefab_stdparms.html"> standard prefab parameters </a> apply: <b>rectangle</b>, <b>xrange</b>, and <b>yrange</b>.<tt> </tt> <br><br> <dt> <dd> <b>dumpfile</b> filename <br> a drawdump file as created previously using <tt>pl -drawdump</tt> or <tt>pl -drawdumpa</tt> <br> Example: <tt>dumpfile=dump1</tt> <br><br><br> <dt> <dd> <b>cmdfile</b> filename <br> the name of a file containing <a href="drawcommands.html#commandset"> ploticus draw commands </a> , one per line.<tt> </tt> You can also use <tt>stdin</tt> for draw commands to be read from standard input.<tt> </tt> <br><br><br> </dl> <h2>Example using ploticus draw commands</h2> <p> <img src="../gallery/prefab_img/draw1.gif"> <p> <pre> pl -prefab draw cmdfile=drawcom.dcm xrange="0 40" yrange="0 40" \ rectangle="1 1 3 3" The drawcom.dcm file begins like this: movs 3.5 23 lins 3.5 22 lins 3 21.6 ..etc. </pre> <br><br><br> <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>