.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: 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>
.>>

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

.LP
\fCdraw\fR is a 
.ig >>
<a href="prefabs.html">
.>>
\0prefab
.ig >>
</a>
.>>
that reads and executes sets of commands which specify low-level drawing operations.
.LP
The commands may be one of \fBtwo distinct types\fR:
.IP \(bu
a ploticus drawdump file
.ig >>
&nbsp; &nbsp;
.>>
- a file that has been created previously by running \fCpl -drawdump\fR or \fCpl -drawdumpa\fR .
Often used with prefabs as a
.ig >>
<a href="prefabs.html#drawdump">
.>>
\0convenient way to overlay or combine graphs.
.ig >>
</a>
.>>
.ig >>
<br><br>
.>>
.IP \(bu
ploticus draw commands
.ig >>
&nbsp; &nbsp;
.>>
- 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.
.LP
If you use the \fCdumpfile\fR attribute, drawdump content is expected.  Otherwise, ploticus draw commands
are expected.


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

.SH Parameters

.IP \0
If using \fCdumpfile\fR, none of the standard prefab parameters are applicable.
If you're processing ploticus draw commands, and are using commands that operate in
scaled space, the following
.ig >>
<a href="prefab_stdparms.html">
.>>
\0standard prefab parameters
.ig >>
</a>
.>>
apply: \fBrectangle\fR, \fBxrange\fR, and \fByrange\fR.

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

.IP \0
\fBdumpfile\fR 
.ig >>
&nbsp; &nbsp;
.>>
filename
.br
a drawdump file as created previously using \fCpl -drawdump\fR or \fCpl -drawdumpa\fR
.br
Example: \fCdumpfile=dump1\fR

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

.IP \0
\fBcmdfile\fR 
.ig >>
&nbsp; &nbsp;
.>>
filename
.br
the name of a file containing 
.ig >>
<a href="drawcommands.html#commandset">
.>>
\0ploticus draw commands
.ig >>
</a>
.>>
, one per line.
You can also use \fCstdin\fR for draw commands to be read from standard input.

.ig >>
<br><br><br>
.>>
.SH Example using ploticus draw commands
.LP
.ig >>
<img src="../gallery/prefab_img/draw1.gif">
.>>
.LP
.nf
  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.
.fi

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

.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>
.>>
