draw prefab


Version 2.41 Mar2009

Prefabs


Manual page for draw_prefab(PL)

draw is a prefab that reads and executes sets of commands which specify low-level drawing operations.

The commands may be one of two distinct types:

  • a ploticus drawdump file     - a file that has been created previously by running pl -drawdump or pl -drawdumpa . Often used with prefabs as a convenient way to overlay or combine graphs.

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

If you use the dumpfile attribute, drawdump content is expected. Otherwise, ploticus draw commands are expected.


Parameters

If using dumpfile, 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 standard prefab parameters apply: rectangle, xrange, and yrange.

dumpfile     filename
a drawdump file as created previously using pl -drawdump or pl -drawdumpa
Example: dumpfile=dump1


cmdfile     filename
the name of a file containing ploticus draw commands , one per line. You can also use stdin for draw commands to be read from standard input.


Example using ploticus draw commands

  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.






data display engine  
Copyright Steve Grubb


Ploticus is hosted at http://ploticus.sourceforge.net   Get ploticus data display engine at SourceForge.net. Fast, secure and Free Open Source software downloads


Markup created by unroff 1.0,    March 11, 2009.