Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

pgplotwidget - Constructor

	Package	display
	Module	plotter
	Tool	pgplotwidget

Create a pgplot widget in a supplied frame

Synopsis
pgplotwidget(parentframe, size, foreground, background, padx, pady, mincolors, maxcolors, havemessages, widgetset)

Description
This constructor creates a PGPLOT widget in a supplied frame. It either returns a tool, or a ``fail'' if construction isn't possible (for example, a ``fail'' is returned if no DISPLAY environment variable is set).

The supplied frame should have been created with side='top' to make sure that the message line is above the plot area.

If the minimum requested number of colors mincolors cannot be supplied, then a fail will be returned. In this case you may wish to ensure that parentframe has a private colormap installed (set newcmap=newcmap in the frame constructor) and try again.

If you want to, you can suppress the messages window by setting havemessages to F. You can still call the message(), function, however it has no effect.

Arguments

parentframe		frame to attach to
		Allowed:	frame
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
padx		x border padding in pixels
		Allowed:	float
		Default:	2
pady		y border padding in pixels
		Allowed:	float
		Default:	2
mincolors		Minimum number of colors we require
		Allowed:	integer
		Default:	2
maxcolors		Maximum number of colors we will take
		Allowed:	integer
		Default:	100
havemessages		Display messages on the screen?
		Allowed:	boolean
		Default:	T
widgetset		The widgetset to use
		Allowed:	A widgetserver tool
		Default:	dws

Returns
pgplotwidget tool or fail