Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

pgplotter - Constructor

	Package	display
	Module	plotter
	Tool	pgplotter

Create a pgplotter tool in standalone GUI

Synopsis
pgplotter(plotfile, size, foreground, background, mincolors, maxcolors)

Description
This command creates a pgplotter tool with a GUI, and attaches it to a plot file. If the plot file is filled, the plot commands are drawn to the screen. If there are any plugins (at present there is one plugin for displaying PGPLOT demonstrations), they are attached before the tool is returned to the user.

If it is not possible to create the tool (for example, no DISPLAY environment variable is set), a fail is returned.

If the requested number of colors mincolors cannot be allocated with a shared colormap, a private colormap will be installed. This will cause colormap flashing on some hardware.

Arguments

plotfile		Name of the plot file to attach to
		Allowed:	string
		Default:	aips++plot.plot
size		Size in pixels for the drawing area
		Allowed:	integer[2]
		Default:	[600,450]
foreground		Foreground colour
		Allowed:	string (valid colour name
		Default:	white
background		Background colour
		Allowed:	string (valid colour name)
		Default:	black
mincolors		Minimum number of colors we require
		Allowed:	integer
		Default:	2
maxcolors		Maximum number of colors we will take
		Allowed:	integer
		Default:	100

Returns
pgplotter tool or fail