Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

pgplotps - Constructor

	Package	display
	Module	plotter
	Tool	pgplotmanager

Create a pgplotmanager attached a file

Synopsis
pgplotps(psfile, overwrite, color, landscape, playlist, record, widgetset)

Description

This constructor creates a pgplotmanager tool attached to an output PostScript file that can be sent to a printer. Interactive prompting will be disabled, so the pgplot function ask() will have no effect.

Arguments

psfile		the name of output file to write plot to
		Allowed:	string representing a file name
		Default:	'pgplot.ps'
overwrite		whether to allow a previously existing file with the same name to be overwritten
		Allowed:	boolean; T - if psfile already exists, it will be overwritten; F - if psfile already exists, this constructor will return a fail value
		Default:	F
color		if true, output is color postscript; otherwise, colors are converted to black-and-white or greyscale
		Allowed:	boolean
		Default:	T
landscape		if true, plot is written in landscape mode (i.e. with the bottom axis of the plot oriented along the long axis of the paper); otherwise, portrait mode is used.
		Allowed:	boolean
		Default:	T
playlist		a displaylist tool to use to store plot commands. This allows pre-record commands to be attached to this pgplotmanager.
		Default:	F - a new display list will be created internally
record		sets whether recording is initially turned on
		Default:	F
widgetset		the widgetserver tool to use when creating an internal displaylist. This is used only when a displaylist is not provided via the playlist parameter.
		Allowed:	widgetserver tool
		Default:	dws - the default widgetserver tool

Returns
pgplotmanager tool or fail

Example

pgpm := pgplotps('plot.ps');

# do some plotting
pgpm.env(0, 2 * pi, -1, 1, 0, 0);

pgpm.done();    # plot file is closed