Last Updated: 12/20/96
Class NFXYChartApp

Class NFXYChartApp

public class NFXYChartApp extends Applet

This class supports the generation of XY Charts that contain one or more data sets. Each data set can be rendered as a series of symbols, connected by lines and with the area beneath filled. The display of symbols, lines and area fill is optional for each data set.

The following standard parameters are supported by this chart:

 	Background

 	Header
 	HeaderBox
 	Footer
 	FooterBox
 	LeftTitle
 	LeftTitleBox
 	RightTitle
 	RightTitleBox

 	DwellLabel
 	DwellBox
 	ActiveClicks
 	ActiveLabels[1-20]

 	Legend
 	LegendBox
 	LegendItems

 	TopAxis
 	LeftAxis
 	RightAxis
 	BottomAxis

 	ColorTable

The following parameters are specifically supported by this chart:

DataSets = (dataset1 tuple), (dataset2 tuple),...;

 	Defines a list of dataset tuples with the following attributes
 	in each tuple:

 	"Name"    - Name assigned to this data set
 	SymColor  - Symbol Color
 	SymType   - Symbol Type (CIRCLE, SQUARE, DIAMOND, CROSS,
 				 TRIANGLEDOWN, TRIANGLEUP)
 	SymSize   - Symbol Size (in pixels)
 	SymStyle  - Symbol Style (FILLED, OUTLINED)
 	LineType  - Line Type (SOLID, DOTTED, DASHED, DOTDASH)
 	LineWidth - Line Width (in pixels)
 	LineColor - Line Color
 	FillColor - Fill Color

 	By default, the Name and SymColor assigned to each data 
 	set will be used in the Legend.

 	If any of the symbol attributes are undefined, default 
 	values will be used.  If the SymType is set to NONE,
 	then no symbol will be displayed.

 	If the LineType attribute is defined, the data symbols 
 	in the given data set will be connected by line 
 	segments using the given line attributes.

 	If the FillColor attribute is defined, the area under 
 	the curve will be filled with the given color.
 	used for each symbol in the dataset.

 	At most 20 datasets may be displayed.

 	If a color is not specified in the vector, then the 
 	previously specified color will be used. If the color is
 	specified as "null", then a default color will be chosen
 	from the color table. (See the ColorTable parameter.)

 	If a line color or fill color is assigned "null", then
 	the line or area fill will not be drawn.

DataSet[1-20] = (x1,y1), (x2,y2), ...;

 	Defines a list of (x,y) values for each dataset defined 
 	by the DataSets parameter.  If "null" is substituted for
 	either or both of the x/y pair value's, the point will not 
 	be drawn.

Grid = (LineColor, BGColor, BorderColor);

 	Defines the grid to be displayed behind the data sets. 
 	If this parameter is not defined, no grid is displayed. 
 	If the BGColor is not defined, only grid lines are
 	displayed.

AddDataPoint = (DataSetNumber, X, Y, label, url, target), ...

 	This is ONLY to be used if plotting dynamically, and 
 	must be the only command sent followed by the Update 
 	command.  This parameter allows the XY chart to be 
 	updated rapidly without refreshing the screen or 
 	reconfiguring the layout.  The "label", "url", and 
 	"target" fields are optional, and if specified, are used
 	to define an ActiveLabel for the given data point.  If 
 	"null" is substituted for either or both of the x/y pair 
 	value's, the point will not be drawn.

The following HTML segment defines an XY chart containing three sets of data points, with the second connected by dotted lines.

 	<applet code=NFXYChartApp.class width=600 height=400>

 	<param name=NFParamScript value = '

 	Background  = (lightGray, NONE);

 	Header	    = ("XY Chart Demo", cyan);
 	HeaderBox   = (darkGray, RECESS, 5);

 	BottomTics  = ("ON", white, "TimesRoman", 16);
 	BottomScale = (0, 40);

 	LeftTics    = ("ON", white, "TimesRoman", 16);
 	LeftScale   = (50, 100);

 	Legend	    = ("", black, "TimesRoman", 12);
 	LegendBox   = (white, SHADOW, 5);

 	DataSets = ("Set #1", blue,  CROSS,  15, FILLED),
 		   ("Set #2", green, SQUARE,  8, FILLED, DOTTED),
 		   ("Set #3", red,   CIRCLE, 10, OUTLINED, NONE);

 	DataSet1 = (18.1,67.7), (16,64), (18.9,68.8), (17,78.5);
 	DataSet2 = (24.5,86.2), (35.9,68.7), (35.1,64.2);
 	DataSet3 = (17,68), (14,87), (15,75), (14,81), (18,76);

 	'>
 	</applet>