main | documentation | examples | common questions | changes | licensing


EASYCHARTS DOCUMENTATION   :   PLOTTERCHART

1. Loading Data
  1.1 plot values
  1.2 multiple data series
  1.3 loading data from a url

2. Setting the range
  2.1 setting explicit range
  2.2 range position and color
  2.3 range value labels
  2.4 range axis label
  2.5 range adjuster

3. Labels and Fonts
  3.1 chart title
  3.2 series labels
  3.3 legend labels
  3.4 value labels
  3.5 plot labels
  3.6 x-axis labels

4. Chart Colors
  4.1 series colors
  4.2 background color
  4.3 chart background color
  4.4 foreground color
  4.5 chart foreground color

5. Chart Style
  5.1 horizontal grid lines
  5.2 line width
  5.3 plot style and size

6. Miscellaneous
  6.1 target value lines
  6.2 urls and drilldown
  6.3 graph insets

CHART PARAMETERS
antialias
autoLabelSpacingOn
automaticRefreshTime
background
chartBackground
chart
chartForeground
chartTitle
connectedLinesOn
data
dataInterval
doubleBufferingOff
floatingLabelFont
font
floatingOnLegendOff
foreground
graphInsets
gridAdjustmentOn
gridImage
gridLinesColor
gridLineColors
gridLines
jpegQuality
labelDelimiter
label
labelAngle
labelColor
labelFont
labelPosition
labelURL
labelURLTarget
legendBoxSizeAsFont
legendColors
legendColumns
legendImage
legendLabels
legendOn
legendPosition
lineWidth
locale
maxXValueLineCount
maxYValueLineCount
plotImage
plots
plots_N
plotLabelAngle
plotLabelFont
plotLabels_N
plotLabelsOn
plotLabelStyle
plotSize
plotSize_N
plotSortingOn
plotStyle
rangeAdjusterOn_
rangeAxisLabel_
rangeAxisLabelAngle_
rangeOn
rangeColor
seriesCount
seriesColors
seriesLabelColors
seriesLabelFont
seriesLabels
seriesLabelsOn
seriesLabelStyle
seriesOn
targetLabelsPosition
targetValueLine
thousandsDelimiter
titleFont
url
urltarget
valueLabelStyle
XAxisOn
XAxisColor
XLowerRange
XRangeDecimalCount
XRangeInterval
XRangeLabelAngle
XRangeLabelFont
XRangeLabels
XUpperRange
XValueDecimalCount
XValueLabelsOn
XValueLabelPrefix
XValueLabelPostfix
XValueLinesOn
XValueLinesColor
YUpperRange
YLowerRange
YAxisOn
YAxisColor
YRangeDecimalCount
YRangeInterval
YValueDecimalCount
YValueLabelPrefix
YValueLabelPostfix
YValueLabelsOn
YValueLinesOn
YValueLinesColor
zoomOn

PARAMETERS TO SET CHART VALUES
plots
Sets the plot values for the first data series. The possible format is one of the following:

x0|y0|size0|label0, x1|y1|size1|label1, ...
x0|y0|size0, x1|y1|size1, ...
x0|y0, x1|y1, ...

If the seriesCount is not set the number of series in the chart will be set to 1.
<param name="plots" value="0|10.5|5|label0, 10|30.5|1|label1, 20|20|10|label2, 30|5.1234|4|label3">
<param name="plots" value="0|10.5|5, 10|30.5|1, 20|20|10, 30|5.1234|4">
<param name="plots" value="0|10.5, 10|30.5, 20|20, 30|5.1234">
setPlots(0, new double[][] {{0,10.5},{10,30.5},{20,20},{30,5.1234}}, new double[] {5,1,10,4});
setPlots(0, new double[][] {{0,10.5},{10,30.5},{20,20},{30,5.1234}});
plots=0|10.5|5|label0,10|30|1|label1,20|5|10|label2,30|20|4|label3
plots=0|10.5|5,10|30|1,20|5|10,30|5.1234|4
plots=0|10.5,10|30,20|5,30|5.1234
plots_N
Sets the plot values for the specified data series. The possible format is one of the following:

x0|y0|size0|label0, x1|y1|size1|label1, ...
x0|y0|size0, x1|y1|size1, ...
x0|y0, x1|y1, ...

You must set the series count first.
<param name="plots_0" value="0|200,10|100,20|300,30|250,40|400">
<param name="plots_0" value="0|200|5,10|100|10,20|300|6,30|250|8,40|400|3">
<param name="plots_1" value="5|300|5|label0,15|150|10|label1,25|200|6|label2,35|150|8|label3,45|300|3|label4">
setPlots(0, new double[][] {{0,200},{10,100},{20,300},{30,250},{40,400}});
setPlots(1, new double[][] {{5,300},{15,150},{25,200},{35,150},{45,300}}, new double[] {5,10,6,8,3});
plots_0=0|200,10|100,20|300,30|250,40|400
plots_1=5|200|5,15|100|10,25|300|6,35|250|8,45|300|3
plots_2=5|300|5|label0,15|150|10|label1,25|200|6|label2,35|150|8|label3,45|300|3|label4
seriesCount
Sets the number of data series in the chart. If the number of data series is larger than 1 you can set the values per data series with the plots_N parameter. <param name="seriesCount" value=3>
setSeriesCount(3);
seriesCount=3
seriesOn
Turns the plot series on/off. By default all the plot series are turned on. <param name="seriesOn" value="true,false,true">
setSeriesOn(0, true);
setSeriesOn(1, false);
setSeriesOn(2, true);
seriesOn=true,false,true
plotSortingOn
Turns the plots sorting on/off. When the parameter is on the plots from plots_N parameter are sorted by their X-value when loaded. The difference between sorted and unsorted plots can be clearly seen when connected lines are turned on. <param name="plotSortingOn" value="false,true">
setPlotSortingOn(0, false);
setPlotSortingOn(1, true);
plotSortingOn=false,true

PARAMETERS TO SET THE RANGE AXIS
XUpperRange
Sets the upper value of the x range axis. If this is not set, the upper x range will be automatically set to the largest plot value. In java applications the x upper range is set to 100 by default. <param name="XUpperRange" value=200>
<param name="XUpperRange_2" value=800>
<param name="XUpperRange_3" value=5000>
setXUpperRange(0, 200);
setXUpperRange(1, 800);
setXUpperRange(2, 5000);
XUpperRange=200
XUpperRange_2=800
XUpperRange_3=5000
YUpperRange
Sets the upper value of the y range axis. If this is not set, the upper y range will be automatically set to the largest plot value. In java applications the y upper range is set to 100 by default. <param name="YUpperRange" value=200>
<param name="YUpperRange_2" value=800>
<param name="YUpperRange_3" value=5000>
setYUpperRange(0, 200);
setYUpperRange(1, 800);
setYUpperRange(2, 5000);
YUpperRange=200
YUpperRange_2=800
YUpperRange_3=5000
XLowerRange
Sets the lower value of the x range axis. If this is not set, the lower range will be automatically set to the smallest sample (or 0 if no samples are negative). In java applications the lower range is set to 0 by default. <param name="XLowerRange" value=-200>
<param name="XLowerRange_2" value=-800>
<param name="XLowerRange_3" value=-5000>
setXLowerRange(0, -200);
setXLowerRange(1, -800);
setXLowerRange(2, -5000);
XLowerRange=-200
XLowerRange=-800
XLowerRange_2=-5000
YLowerRange
Sets the lower value of the y range axis. If this is not set, the lower range will be automatically set to the smallest sample (or 0 if no samples are negative). In java applications the lower range is set to 0 by default. <param name="YLowerRange" value=-200>
<param name="YLowerRange_2" value=-800>
<param name="YLowerRange_3" value=-5000>
setYLowerRange(0, -200);
setYLowerRange(1, -800);
setYLowerRange(2, -5000);
YLowerRange=-200
YLowerRange=-800
YLowerRange_2=-5000
XRangeInterval
Sets interval between the ticks on the X range. This interval is used even if the range is adjusted. <param name="XRangeInterval" value=10>
<param name="XRangeInterval_2" value=2.5>
<param name="XRrangeInterval_3" value=1>
setXRangeInterval(0, 10);
setXRangeInterval(1, 2.5);
setXRangeInterval(2, 1);
XRangeInterval=10
XRangeInterval_2=2.5
XRangeInterval_3=1
YRangeInterval
Sets interval between the ticks on the Y range. This interval is used even if the range is adjusted. <param name="YRangeInterval" value=10>
<param name="YRangeInterval_2" value=2.5>
<param name="YRrangeInterval_3" value=1>
setYRangeInterval(0, 10);
setYRangeInterval(1, 2.5);
setYRangeInterval(2, 1);
YRangeInterval=10
YRangeInterval_2=2.5
YRangeInterval_3=1
rangeOn
Turns on the specified ranges. the parameter value consists of 0 to 4 parameters: top, left, bottom or right. The parameters can be specified in any order.
<param name="rangeOn" value="left,bottom">
setRangeOn(PlotterChart.RIGHT, true);
setRangeOn(PlotterChart.LEFT, false);
setRangeOn(PlotterChart.TOP, false);
setRangeOn(PlotterChart.BOTTOM, true);
rangeOn=right,left,top,bottom
rangeColor
Sets the color of the bottom range value labels and tick marks. The parameter value consists of 4 parameters whith the following sequence: top, left, bottom, right. An empty value (x) uses the default color.
<param name="rangeColor value="x,red,blue">
setRangeColor(PlotterChart.LEFT, Color.green);
setRangeColor(PlotterChart.BOTTOM, Color.blue);
rangeColor=x,red,blue
rangeAdjusterOn_
Turns on the specified range adjuster. The range adjuster allows the user to adjust the upper and lower ranges at runtime. The position of the adjuster must be specified after the rangeAdjusterOn_ and can be right or bottom. <param name="rangeAdjusterOn_right" value=true>
<param name="rangeAdjusterOn_bottom" value=true>
setRangeAdjusterOn(PlotterChart.RIGHT, true); setRangeAdjusterOn(PlotterChart.BOTTOM, true);
rangeAxisLabel_
Adds a label to a specified range axis. The position of the label must be specified after the rangeAxisLabel_ and can be right, left, top or bottom. The label is horizontal by default, but the angle can be controlled using the rangeAxisLabelAngle parameter. <param name="rangeAxisLabel_right" value="right range">
<param name="rangeAxisLabel_left" value="left range">
<param name="rangeAxisLabel_top" value="top range">
<param name="rangeAxisLabel_bottom" value="bottom range">
setLabel("rangeAxisLabel_right", "right range");
setLabel("rangeAxisLabel_left", "left range");
setLabel("rangeAxisLabel_top", "top range");
setLabel("rangeAxisLabel_bottom", "bottom range");
rangeAxisLabel_right=right range
rangeAxisLabel_left=left range
rangeAxisLabel_top=top range
rangeAxisLabel_bottom=bottom range
rangeAxisLabelAngle_
Sets the clockwise angle of the range axis labels. The position of the label must be specified after the rangeAxisLabelAngle_ and can be right, left, top or bottom. <param name="rangeAxisLabelAngle_right" value="270">
<param name="rangeAxisLabelAngle_left" value="90">
<param name="rangeAxisLabelAngle_top" value="0">
<param name="rangeAxisLabelAngle_bottom" value="180">
setLabelAngle("rangeAxisLabelAngle_right", 270);
setLabelAngle("rangeAxisLabelAngle_left", 90);
setLabelAngle("rangeAxisLabelAngle_top", 0);
setLabelAngle("rangeAxisLabelAngle_bottom", 180);
rangeAxisLabelAngle_right=270
rangeAxisLabelAngle_left=90
rangeAxisLabelAngle_top=0
rangeAxisLabelAngle_bottom=180
rangeAxisLabelFont
Sets the font used for the rangeAxisLabels. <param name="rangeAxisLabelFont" value="Dialog, plain, 12"
setFont("rangeAxisLabelFont", new Font("Dialog", Font.PLAIN, 12));
rangeAxisLabelFont=Dialog, plain, 12
XRangeLabels
Sets the custom labels for the X-Axis range. Colors and grid lines can also be set for the labels. Here is the format:

XRangeLabels=x0|label0,x1|label1,... or
XRangeLabels=x0|label0|color0,x1|label1|color1,...or
XRangeLabels=x0|label0|color0|lineOn0,x1|label1|color1|lineOn1,...

<param name="XRangeLabels" value="10|label1,30|label2,50|label3">
<param name="XRangeLabels" value="10|label1|red,30|label2|green,50|label3|blue">
<param name="XRangeLabels" value="10|label1|red|true,30|label2|green|false,50|label3|blue|true">
setXRangeLabels(new double[] {0,30,50}, new String[] {"label1","label2","label3"});
setXRangeLabelColors(new double[] {0,30,50}, new Color[] {Color.red,Color.green,Color.blue});
setXRangeLabelLinesOn(new double[] {0,30,50}, new boolean[] {true,false,true});
XRangeLabels=10|label1,30|label2,50|label3
XRangeLabels=10|label1|red,30|label2|green,50|label3|blue
XRangeLabels=10|label1|red|true,30|label2|green|false,50|label3|blue|true
XRangeLabelAngle
Sets the clockwise angle of the X-axis labels. <param name="XRangeLabelAngle" value="270">
setLabelAngle("XRangeLabelAngle", 270);
XRangeLabelAngle=270
XRangeLabelFont
Sets the font used for the X-axis labels. <param name="XRangeLabelFont" value="Courier, bold, 11">
setFont("XRangeLabelFont", new Font("Courier", Font.BOLD, 11));
XRangeLabelFont=Courier,bold,11
XRangeDecimalCount
Sets the number of fixed decimals to use for the x range labels. If value is set to auto (-1 for applications) the number of decimals is calculated automatically based on the upper and lower range values.
<param name="XRangeDecimalCount" value=3>
<param name="XRangeDecimalCount" value=auto>
setXRangeDecimalCount(3);
setXRangeDecimalCount(-1);
XRangeDecimalCount=3
XRangeDecimalCount=auto
YRangeDecimalCount
Sets the number of fixed decimals to use for the y range labels.
If value is set to auto (-1 for applications) the number of decimals is calculated automatically based on the upper and lower range values.
<param name="YRangeDecimalCount" value=3>
<param name="YRangeDecimalCount" value=auto>
setYRangeDecimalCount(3);
setYRangeDecimalCount(-1);
YRangeDecimalCount=3
YRangeDecimalCount=auto
rangeLabelFont
Sets the font for the range labels. <param name="rangeLabelFont" value="Dialog, plain, 12">
setFont("rangeLabelFont", new Font("Dialog", Font.PLAIN, 12));
rangeLabelFont=Dialog, plain, 12
XAxisOn
Turns on or off the X axis. <param name="XAxisOn" value="true">
setXAxisOn(true);
XAxisOn=Dialog, plain, 12
YAxisOn
Turns on or off the Y axis. <param name="YAxisOn" value="true">
setYAxisOn(true);
YAxisOn=true
XAxisColor
Sets color of the X axis. <param name="XAxisColor" value="blue">
setXAxisColor(Color.blue);
XAxisColor=blue
YAxisColor
Sets color of the Y axis. <param name="YAxisColor" value="red">
setYAxisColor(Color.red);
YAxisColor=red

PARAMETERS TO SET LABELS
chartTitle
Sets the title of the chart. The title will be displayed at the top of the chart. To set the title font use the titleFont parameter. Use \n for line breaks. <param name="chartTitle" value="This is my title">
<param name="chartTitle" value="Linebreak\nin title">
setTitle("This is my title");
setTitle("Linebreak\\nin title");
chartTitle=This is my title
titleFont
Sets the font used for the chart title. <param name="titleFont" value="Dialog, bold, 20"
setFont("titleFont", new Font("Dialog", Font.BOLD, 20));
titleFont=Dialog, bold, 20
seriesLabels
Sets the series labels for this chart. The series labels are displayed in the legend, one for each data series. <param name="seriesLabels" value="2000, 2001, 2002">
setSeriesLabels(new String[] {"2000","2001","2002"});
setSeriesLabel(0, "another label");
seriesLabels=2000,2001,2002
seriesLabelColors
Sets the colors of the series labels. <param name="seriesLabelColors" value="red, #7f0000, blue">
setSeriesLabelColor(0, Color.red);
setSeriesLabelColor(1, new Color(0x7f0000));
setSeriesLabelColor(2, Color.blue);
seriesLabelColors=red,%237f0000,blue
seriesLabelsOn
Turns on the series labels on the grid or floating. <param name="seriesLabelsOn" value="true">
setSeriesLabelsOn(true);
seriesLabelStyle
Controls how the series labels are displayed. The series labels can either be displayed over, under or in the center of the sample point on the chart grid or floating above a sample point when the mouse moves over it. <param name="seriesLabelStyle" value="over">
<param name="seriesLabelStyle" value="under">
<param name="seriesLabelStyle" value="center">
<param name="seriesLabelStyle" value="floating">
setSeriesLabelStyle(LineChart.OVER);
setSeriesLabelStyle(LineChart.UNDER);
setSeriesLabelStyle(LineChart.CENTER);
setSeriesLabelStyle(LineChart.FLOATING);
seriesLabelStyle=over
seriesLabelStyle=under
seriesLabelStyle=center
seriesLabelStyle=floating
seriesLabelFont
Sets the font used for the series labels. <param name="seriesLabelFont" value="Dialog, plain, 12">
setFont("seriesLabelFont", new Font("Dialog", Font.PLAIN, 12));
seriesLabelFont=Dialog,plain,12
legendOn
Turns on the legend that displays the series labels. The position of the legend can be set using the legendPosition parameter. <param name="legendOn" value=true>
setLegendOn(true);
legendOn=true
legendPosition
Sets the legend position. Possible positions are right, left, top, or bottom. The default position is to the right. <param name="legendPosition" value="right">
<param name="legendPosition" value="left">
<param name="legendPosition" value="top">
<param name="legendPosition" value="bottom">
setLegendPosition(LineChart.RIGHT);
setLegendPosition(LineChart.LEFT);
setLegendPosition(LineChart.TOP);
setLegendPosition(LineChart.BOTTOM);
legendPosition=left
legendLabels
Overrides the default labels in the legend which are taken from the seriesLabels parameter. <param name="legendLabels" value="2000, 2001, 2002">
setLegendLabels(new String[] {"2000","2001","2002"});
legendLabels=2000,2001,2002
legendColors
Sets the colors for the legend boxes. If this is not set, the colors are taken from the sampleColors parameter. <param name="legendColors" value="red, #7f0000">
setLegendColors(new Color[] {Color.red, new Color(0x7f0000));
setLegendColor(1, Color.blue);
legendColors=red,%237f0000
legendColumns
Sets the number of columns that should be used to display legend labels. <param name="legendColumns" value=4>
setLegendColumns(3);
legendColumns=5
legendImage
Sets an image to be used in front of the legend label instead of the default legend box. For the applet the image is specified as a relative URL. This only works if the applet is allowed to connect back to the web server. <param name="legendImage_0" value="blue_ball.gif">
<param name="legendImage_1" value="images/red_ball.gif">
Image image = ... load image blue_ball.gif from disk
addImage("legendImage_0", image);
setLegendImage(0, "legendImage_0");
legendBoxSizeAsFont
Sets the default legend box size the same as the legend font size.
<param name="legendBoxSizeAsFont" value="true">
setLegendBoxSizeAsFont(true);
legendBoxSizeAsFont=true
XValueLabelsOn
Turns on the x value labels for the points in a serie. Use XValueLabelsOn_N to control the value labels per data series. <param name="XValueLabelsOn" value=true>
<param name="XValueLabelsOn_2" value=false>
setXValueLabelsOn(true);
setXValueLabelsOn(1, false);
XValueLabelsOn=true
YValueLabelsOn
Turns on the y value labels for the points in a serie. Use YValueLabelsOn_N to control the value labels per data series. <param name="YValueLabelsOn" value=true>
<param name="YValueLabelsOn_2" value=false>
setYValueLabelsOn(true);
setYValueLabelsOn(1, false);
YValueLabelsOn=true
valueLabelStyle
Sets the display style of the value labels. The value labels can be painted directly over or under the point, centered with the sample point, or floating above the sample point when the mouse hovers over it. <param name="valueLabelStyle" value="over">
<param name="valueLabelStyle" value="under">
<param name="valueLabelStyle" value="center">
<param name="valueLabelStyle" value="floating">
setValueLabelStyle(Chart.OVER);
setValueLabelStyle(Chart.UNDER);
setValueLabelStyle(Chart.CENTER);
setValueLabelStyle(Chart.FLOATING);
valueLabelStyle=outside
valueLabelStyle=inside
XValueDecimalCount
Sets the number of fixed decimals to use for the x value labels. Use XValueDecimalCount_N to control the decimals per data series. If value is set to auto (-1 for applications) the number of decimals is calculated automatically based on the upper and lower range values.
<param name="XValueDecimalCount" value=3>
<param name="XValueDecimalCount_2" value=0>
setXValueDecimalCount(-1, 3); // -1 specifies all series
setXValueDecimalCount(0, 2);  // serie 0, 2 decimals
XValueDecimalCount=3
XValueDecimalCount_2=0
YValueDecimalCount
Sets the number of fixed decimals to use for the y value labels. Use YValueDecimalCount_N to control the decimals per data series. If value is set to auto (-1 for applications) the number of decimals is calculated automatically based on the upper and lower range values.
<param name="YValueDecimalCount" value=3>
<param name="YValueDecimalCount_2" value=0>
setYValueDecimalCount(-1, 3); // -1 specifies all series
setYValueDecimalCount(0, 2);  // serie 0, 2 decimals
YValueDecimalCount=3
YValueDecimalCount_2=0
floatingOnLegendOff
By default floating labels are displayed for all the samples in the selected series when the mouse moves over a series label in the legend. This parameter turns this behavior off. <param name="floatingOnLegendOff" value="true">
setFloatingOnLegendOn(false);
XValueLabelPrefix
Adds a prefix before all x value labels. You can also set the prefix for individual data series by adding the series index. <param name="XValueLabelPrefix" value="$">
<param name="XValueLabelPrefix_2" value="£">
setLabel("XValueLabelPrefix", "$");
XValueLabelPrefix=$
YValueLabelPrefix
Adds a prefix before all y value labels. You can also set the prefix for individual data series by adding the series index. <param name="YValueLabelPrefix" value="$">
<param name="YValueLabelPrefix_2" value="£">
setLabel("YValueLabelPrefix", "$");
YValueLabelPrefix=$
XValueLabelPostfix
Adds a postfix after all x value labels. You can also set the postfix for individual data series by adding the series index. <param name="XValueLabelPostfix" value="%">
<param name="XValueLabelPostfix_0" value="ms">
setLabel("XValueLabelPostfix", "%");
setLabel("XValueLabelPostfix_1", "ms");
XValueLabelPostfix=KB
YValueLabelPostfix
Adds a postfix after all y value labels. You can also set the postfix for individual data series by adding the series index. <param name="YValueLabelPostfix" value="%">
<param name="YValueLabelPostfix_0" value="ms">
setLabel("YValueLabelPostfix", "%");
setLabel("YValueLabelPostfix_1", "ms");
YValueLabelPostfix=KB
font
Sets the default font used in the chart. <param name="font" value="Dialog, plain, 12">
setFont(new Font("Dialog", Font.PLAIN, 12));
font=Dialog,plain,12
floatingLabelFont
Sets the font used for the floating value and sample labels. <param name="floatingLabelFont" value="Dialog, plain, 12">
setFont("floatingLabelFont", new Font("Dialog, Font.Plain, 12));
floatingLabelFont=Dialog,plain,12
plotLabels_N
Sets the plot labels for the specified plot serie (N). The plot labels will appear below the chart grid, floating above a plot point when the mouse moves over it, or both below and floating. The plotLabels parameter is same as plotLabels_0. Plot labels set by this parameter will override those ones set by the plots_N parameter. <param name="plotLabels" value="one,two,three">
<param name="plotLabels_1" value="four,five,six">
setPlotLabels(0, new String[] {"one","two","three"});
setPlotLabels(1, new String[] {"four","five","six"});
plotLabels=one,two,three
plotLabels_1=four,five,six
plotLabelsOn
Turns on the plot labels. <param name="plotLabelsOn" value="true">
plotLabelsOn(true);
plotLabelsOn=true
plotLabelAngle
Sets the clockwise angle of the plot labels. <param name="plotLabelAngle" value="270">
setLabelAngle("plotLabelAngle", 270);
plotLabelAngle=270
plotLabelStyle
Sets the display style of the plot labels. The labels can either be displayed below the chart grid, floating above a sample point when the mouse moves over it, or both below and floating. <param name="plotLabelStyle" value="below">
<param name="plotLabelStyle" value="floating">
<param name="plotLabelStyle" value="below_and_floating">
setPlotLabelStyle(PlotterChart.BELOW);
setPlotLabelStyle(PlotterChart.FLOATING);
setPlotLabelStyle(PlotterChart.BELOW_AND_FLOATING);
plotLabelStyle=below
plotLabelFont
Sets the font used for the plot labels. <param name="plotLabelFont" value="Dialog, plain, 12">
setFont("plotLabelFont", new Font("Dialog", Font.PLAIN, 12));
plotLabelFont=Dialog,plain,12
autoLabelSpacingOn
By default all the plot labels and x-range labels are painted even if there is not enough space for them all (they will overlap). If this parameter is set to true, only labels there are room for will be painted. Anyway if both plot labels and x-range labels are on they can overlap each other. Plot labels from different series can also overlap. <param name="autoLabelSpacingOn" value=true>
setAutoLabelSpacingOn(true);
autoLabelSpacingOn=true
labelDelimiter
By default the sampleLabels, seriesLabel, targetValueLine, and legendLabels parameters use comma (,) as a field delimiter. Use this parameter to control the label delimiter if you need a comma in the labels to be displayed in the applet or servlet. <param name="labelDelimiter" value=":">
labelDelimiter=:
thousandsDelimiter
Use this parameter to control the thousands delimiter in numerical labels. <param name="thousandsDelimiter" value=",">
setThousandsDelimiter(",");
thousandsDelimiter=,
locale
Sets the locale of the chart. The locale affects the display of value and range labels, with the correct grouping and decimal signs.
Language codes
Country codes
<param name=locale value="en, gb">
<param name=locale value="en, us">
setLocale(new Locale("EN", "GB");
setLocale(new Locale("EN", "US");
locale=en,gb
locale=en,us

PARAMETERS TO CONTROL COLORS
seriesColors
Sets the colors of the plot series in the chart. <param name="seriesColors" value="red, #c0ff7f, blue">
Color[] c = new Color[] {Color.red, new Color(0xc0ff7f)};
setSeriesColors(c);
seriesColors=red,%23c0ff7f,blue
background
This is the background color of the area around the chart grid. The background can be solid or gradient. In order to use gradient background, specify two colors separated by |. <param name="background" value="red">
<param name="background" value="gray|lightGray">
setBackground(Color.red);
setBackground2(Color.black);
background=red
background=gray|lightGray
foreground
This is the color of the title, legend labels, value labels, sample labels, and the range labels. <param name="foreground" value="blue">
setForeground(Color.blue);
foreground=blue
chartBackground
This is the color of the chart grid background. The grid background can be solid or gradient. In order to use gradient chart grid background specify the two colors separated by |. <param name="chartBackground" value="blue">
<param name="chartBackground" value="gray|lightGray">
setChartBackground(Color.blue);
setChartBackground2(Color.black);
chartBackground=blue
chartBackground=gray|lightGray
chartForeground
This is the color of the chart grid outline. <param name="chartForeground" value="red">
setChartForeground(Color.red);
chartForeground=red

PARAMETERS TO CONTROL CHART STYLE
zoomOn
If zoomOn is set to true, the user can use mouse box to zoom into the samples of the chart. <param name="zoomOn" value=true>
setZoomOn(true);
lineWidth
Sets the width of the lines connecting the plots. You set the width of each series by using a commaseparated list of values. If you have more than one series, you can set the width of all the series by using 1 value. Default width is 2. Use connectedPlotsOn parameter to connect the plots with lines. <param name="lineWidth" value="1">
<param name="lineWidth" value="1,5,2,3,1">
setLineWidth(1); // all series has width 1
setLineWidth(0,5); // first series has line width 5
lineWidth=1
lineWidth=1,5,2,3,1
XValueLinesOn
Turns on the vertical value lines in the chart background. <param name="XValueLinesOn" value=true>
setXValueLinesOn(true);
XValueLinesOn=true
YValueLinesOn
Turns on the horizontal value lines in the chart background. <param name="YValueLinesOn" value=true>
setTValueLinesOn(true);
TValueLinesOn=true
XValueLinesColor
Sets the color of the vertical value lines. <param name="XValueLinesColor" value="red">
<param name="XValueLinesColor" value="#c0c0c0">
setXValueLinesColor(Color.red);
setXValueLinesColor(new Color(0xc0c0c0));
XValueLinesColor=red
XValueLinesColor=%23c0c0c0
YValueLinesColor
Sets the color of the horizontal value lines. <param name="YValueLinesColor" value="red">
<param name="YValueLinesColor" value="#c0c0c0">
setYValueLinesColor(Color.red);
setYValueLinesColor(new Color(0xc0c0c0));
YValueLinesColor=red
YValueLinesColor=%23c0c0c0
maxXValueLineCount
Sets the maximum number of vertical value lines to be displayed in the chart. You can use this to control the step between the grid labels to certain extent. <param name="maxXValueLineCount" value=10>
setMaxXValueLineCount(10);
maxXValueLineCount=10
maxYValueLineCount
Sets the maximum number of horizontal value lines to be displayed in the chart. You can use this to control the step between the grid labels to certain extent. <param name="maxYValueLineCount" value=10>
setMaxYValueLineCount(10);
maxYValueLineCount=10
gridLines
Sets the vertical grid lines. Add one value per grid line. The value is relative to the sample axis range (default 0 to 100) and the width of the chart grid. To turn off the grid lines use setGridLines(null). <param name="gridLines" value="10,20,30,40,50,60,70,80,90">
setGridLines(new double[] {10,20,30,40,50,60,70,80,90});
gridLines=10,20,30,40,50,60,70,80,90
gridLinesColor
Sets the color of all except default grid lines. <param name="gridLinesColor" value="red">
<param name="gridLinesColor" value="#c0c0c0">
setGridLinesColor(Color.red);
setGridLinesColor(new Color(0xc0c0c0));
gridLinesColor=red
gridLinesColor=%23c0c0c0
gridLineColors
Sets the color of individual vertical grid lines. <param name="gridLineColors" value="red, green, blue">
setGridLineColors(new Color[] {Color.red,Color.green,Color.blue});
setGridLineColor(0, Color.red);
gridLineColors=red,green,blue
connectedLinesOn
By default the plots will not be connected. By using this parameter you can connect the plots by painting a line between them. You can control each data series individually. <param name="connectedLinesOn" value=true>
<param name="connectedLinesOn" value="false,true,false,true,true">
setConnectedLinesOn(1, true);
setConnectedLinesOn(3, true);
setConnectedLinesOn(4, true);
connectedLinesOn=true
connectedLinesOn=1,3,4
plotStyle
Use this parameter to set the plot style for each data series. The possible styles are circle, circle_opaque, circle_filled, square, square_opaque, square_filled, diamond, diamond_opaque, or diamond_filled. <param name="plotStyle" value="circle, square, diamond">
setPlotStyle(0, PlotterChart.PLOT_STYLE_CIRCLE, 10); // 10 is size
setPlotStyle(1, PlotterChart.PLOT_STYLE_CIRCLE_OPAQUE, 10);
setPlotStyle(2, PlotterChart.PLOT_STYLE_CIRCLE_FILLED, 10);
setPlotStyle(3, PlotterChart.PLOT_STYLE_SQUARE, 10);
setPlotStyle(4, PlotterChart.PLOT_STYLE_SQUARE_OPAQUE, 10);
setPlotStyle(5, PlotterChart.PLOT_STYLE_SQUARE_FILLED, 10);
setPlotStyle(6, PlotterChart.PLOT_STYLE_DIAMOND, 10);
setPlotStyle(7, PlotterChart.PLOT_STYLE_DIAMOND_OPAQUE, 10);
setPlotStyle(8, PlotterChart.PLOT_STYLE_DIAMOND_FILLED, 10);
plotStyle=circle, square, diamond
plotImage
Use this parameter to set a plot highlight image for all data points. Use plotImage_N to set highlight image for all points in a specific serie. <param name="plotImage" value="blue_ball.gif">
<param name="plotImage_2" value="images/red_ball.gif">
<param name="plotImage_1_5" value="images/magenta_ball_small.gif">

Image image = ... load image blue_ball.gif from disk
addImage("image_0", image);
setPlotImage(-1,-1,"image_0"); setPlotImage(2,-1,"image_0"); setPlotImage(1,5,"image_0");
plotSize
Use this parameter to set the size of the data points for all series. The default size is 2.
<param name="plotSize" value="6">
<param name="plotSize" value="6,8,10">
setPlotSize(-1, 6);
setPlotSize(-1, new int[] {6,8,10});
plotSize=6
plotSize=6,8,10
plotSize_N
Use this parameter to set the size of the data point for each data series where N is the serie index. The default size is 2.
<param name="plotSize_0" value="6">
<param name="plotSize_1" value="8">
<param name="plotSize_2" value="10">
setPlotSize(0, 6);
setPlotSize(1, 8);
setPlotSize(2, 10);
plotSize_0=6
plotSize_1=8
plotSize_2=10
graphInsets
Use this parameter to add space between the chart grid and the chart component edges. The parameter value consists of 4 parameters whith the following sequence; top, left, bottom, right. A value of -1 uses the default inset. <param name="graphInsets" value="-1, 50, -1, -1">
setGraphInsets(-1,50,-1-1);
graphInsets=-1,50,-1,-1
gridAdjustmentOn
You can adjust the chart grid at runtime by selecting a grid edge and dragging the mouse button. Double-click on the grid edge to set it to the default position. <param name="gridAdjustmentOn" value="true">
<param name="gridAdjustmentOn" value="left,right">
setGridAdjustment(Chart.TOP, true);
setGridAdjustment(Chart.LEFT, true);
setGridAdjustment(Chart.BOTTOM, true);
setGridAdjustment(Chart.RIGHT, true);
gridImage
You can set an image to be used as a background for the grid. <param name="gridImage" value="background.gif">
Image image = ... load image background.gif from disk
addImage("gridImage", image);
setGridImage("gridImage");
gridImage=http://server/background.gif

MISCELLANEOUS PARAMETERS
data
Instead of loading the data from the applet or servlet parameters, you can specify a url to load the data from. Any parameters specified in the applet or servlet tag will override parameters with the same name loaded from the url. <param name=data value=customers.asp>
data=http://somehost/customers.asp

The data in the url has to be returned in the following format
parameter1=value1
parameter2=value2
parameter3=value3

dataInterval
You can make the applet load the data from the currently specified URL at a specific interval. The interval is specified in seconds. If reset is specified in the data interval, the chart is reset before the parameters are read again. <param name=dataInterval value=10>
<param name=dataInterval value=10,reset>
chart
Use this parameter to set the type of the chart. The supported types are bar, line, pie and plotter. The default chart type is bar. <param name="chart" value="plotter">
chart=plotter
targetValueLine
You can set grid lines with a specified label and color at any value position in the chart. The first parameter is the label, the second is the value, the third is the color. There is an optional fourth parameter to control whether only the label or the value should be displayed as opposed to both as the default behavior is. <param name="targetValueLine_0" value="break even, 150, green">
<param name="targetValueLine_1" value="bankrupt, 20, red, label">
<param name="targetValueLine_2" value="goal, 250, #0c0aa0, value">
setTargetValueLine("break even", 150, Color.green,
  BarChart.TARGET_LINE_ID_AND_VALUE_LABEL);
setTargetValueLine("bankrupt", 20, Color.red,
  BarChart.TARGET_LINE_ID_LABEL);
setTargetValueLine("goal", 250, new Color(0x0c0aa0),
  BarChart.TARGET_LINE_VALUE_LABEL);
targetValueLine_0=break even, 150, green
targetLabelsPosition
Sets the position of the target value labels. Can be left or right. Default is left. <param name="targetLabelsPosition" value=left>
setTargetLabelsPosition(Chart.LEFT);
targetLabelsPosition=left
url_N_M (applet drilldown)
This feature can be used to create drill-down functionallity for the charts. You can associate any plot in the chart to a URL, and the document pointed to by that URL will be opened when the user double-clicks the legend entry or sample point in the legend. Single-click can be used instead by setting the singleClickURLOn parameter.

The N is the index of the data series (first is numbered 0). The M is the index of the plot within the series (first is numbered 0). If there is only one series in the chart, N will be the index of the plot. However url_0_M will override url_N if M=N. If you want to associate and url with a group of samples with the same index across the different series use url_x_N where N is the index of data series.

<param name="url_0" value="orange_sales_2001.html">
<param name="url_1" value="apple_sales_2001.html">
<param name="url_2" value="banana_sales_2001.html">
<param name="url_3" value="http://www.fruitorama.com">
<param name="url_4" value="javascript:winOpen('bar.html', 200,500);">

Include MAYSCRIPT in the applet tag to call javascript functions.
urltarget_N_M (applet drilldown)
This parameter controls where HTML pages will be opened. urltarget sets the default target frame or window. urltarget_N sets the target for the specified series. urltarget_N_M sets the target for the specified plot. _self: Open new page in same window or frame.
_parent: Open in the parent window.
_top: Open in the top-level window.
_blank:Open in a new blank window.
name:Open in the frame or window with the specified name.
<param name="urltarget" value="bottom_frame">
<param name="urltarget_0" value="left_frame">
label_N
This parameter can be used to set a label to any point of the chart. N - index of the label. First parameter is label text. Second and third parameters are X and Y coordinates of the label. If X and Y are higher then 0 and lower than 1, the label position is calculated relatively to the chart bounds. Otherwise, the absolute coordinates of the chart are used. There are optional 4th and 5th parameters which are index and serie of the sample, pointed by the label. <param name="label_0" value="orange sales,100,100">
<param name="label_1" value="apple sales,0.4,0.5">
<param name="label_2" value="banana sales,200,200,4,0">

setLabel("label_0", "orange sales", 100, 100);
setLabel("label_1", "apple sales", 0.4, 0.5);
setLabel("label_2", "banana sales", 200, 200, 4, 0);

label_0=orange sales,100,100
label_1=apple sales,0.4,0.5
label_2=banana sales,200,200,4,0
labelPosition_N
This parameter can be used to set a new position for the anywhere label. The initial position for a label can be set by using label_N parameter. N is the index of the label. <param name="labelPosition_0" value="0.8, 0.1">
<param name="labelPosition_1" value="120, 180">

setLabelPosition("label_0", 0.8, 0.2);
setLabelPosition("label_1", 120, 180);
labelAngle_N
This parameter can be used to set angle of the given anywhere label. <param name="labelAngle_0" value="270">
<param name="labelAngle_1" value="45">
setLabelAngle("label_0", 270);
setLabelAngle("label_1", 45);
labelAngle_0=270
labelAngle_1 =45
labelColor_N
This parameter can be used to set color of the given anywhere label. <param name="labelColor_0" value="red">
<param name="labelColor_1" value="#4f6c23">
setLabelColor("label_0", Color.red);
setLabelColor("label_1", new Color(0x4f6c23));
labelColor_0=red
labelColor_1 =%234f6c23
labelFont_N
This parameter can be used to set font of the given anywhere label. <param name="labelFont_0" value="Dialog,plain,10">
<param name="labelFont_1" value="Times,italic,12">
setFont("label_0", new Font("Dialog", Font.PLAIN, 10));
setFont("label_1", new Font("Times", Font.ITALIC, 12));
labelFont_0=Dialog,plain,10
labelFont_1 =Times,italic,12
labelURL_N
This parameter can be used to assign an URL to an anywhere label. The URL adress will be opened when user clicks the label. N is the index of the label. <param name="labelURL_0" value="orange_sales_2001.html">
<param name="labelURL_1" value="apple_sales_2001.html">
<param name="labelURL_2" value="banana_sales_2001.html">
labelURLTarget_N
This parameter controls where a HTML page will be opened when clicked the appropriate label. labelURLTarget sets the default target frame or window. labelURLTarget_N sets the target for the specified label. _self: Open new page in same window or frame.
_parent: Open in the parent window.
_top: Open in the top-level window.
_blank:Open in a new blank window.
name:Open in the frame or window with the specified name.
<param name="labelURLTarget" value="bottom_frame">
<param name="labelURLTarget_0" value="left_frame">
automaticRefreshTime
Some browsers has problems repainting the applets when scrolling the web page. Set this parameter to make the applet repaint itself on a regular basis. The value is specified in milliseconds so 1000 is one second. <param name="automaticRefreshTime" value=1000>
doubleBufferingOff
By default the charts use double buffering to avoid flickering. However, sometimes this causes problems repainting the charts when scrolling in a browser. If you have charts that the user will not interact with, you might want to turn the double buffering off. <param name="doubleBufferingOff" value=true>

SERVLET PARAMETERS
antialias
The servlet supports antialias rendering to smooth out edges. antialias=true
jpegQuality
The servlet supports controllig quality of the returned jpeg image. jpegQuality=100

CHART USER GUIDE


1. Loading Data

Data can be loaded using the applet parameters.

1.1 Plot values

Use the plots parameter to load data into the applet. The applet code below creates a plotter chart and loads the plots using the specified coordinates.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=plots value="5|30,20|50,35|40,55|55,70|40,80|50,95|70">
</applet>


1.2 Multiple data series

A chart can have multiple data series. Use the seriesCount parameter to control the number of data series, and the plots_N parameter to set the values per data series.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=seriesCount value=2>
<param name=plots_0 value="10|30,30|20,50|40,70|40,90|30">
<param name=plots_1 value="5|50,20|70,35|60,55|75,70|60,80|70,95|90">
</applet>


1.3 Loading data from a url

If you want to load the applet or servlet data and parameters from a url, you need specify the url in the data parameter in your applet or servlet tag as below

Applet:

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=data value="parameters.data">
</applet>

You can also configure the applet to load data from the currently specified data URL at a specific interval.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=data value="parameters.data">
<param name=dataInterval value="10">
</applet>

The above applet will reload the parameters.data file at 10 second intervals. If you specify a new data parameter in the parameters.data file, this file will be loaded instead on the next interval.

<param name=dataInterval value="10,reset">

This will make the applet reset all it's data before the new data is loaded.

Servlet:

<img src="http://localhost:8080/servlet/com.objectplanet.chart.ChartServlet?
chart=plotter&
width=200&
height=140&
data=http://somehost/parameters.data">

Only an applet or servlet can load the data from a URL. The parameters.data file looks like this:

seriesCount=3
plots_0=20|21,40|16,60|24,80|19
plots_1=5|39,25|52,45|57,65|51,85|37
plots_2=10|84,30|74,50|79,70|88,90|60
seriesColors=red,orange,magenta
plotStyle=diamond_opaque
plotSize=6

The data url can point to a script that produces the data as long as the format returned is as in the example above.

If you need to pass parameters to the script when using servlets, & for parameter separation and = for parameter value assignment can not be used. Instead you need to use ¤ as the parameter separator and * for the equals sign.

<img src="http://localhost:8080/servlet/com.objectplanet.chart.ChartServlet?
chart=plotter&
width=200&
height=140&
data=http://somehost/somescript.xyz?myparam*value¤anotherparam*anothervalue&
background=white">



2. Setting the Range


2.1 Setting explicit range

You can control the range explicitly by setting the XUpperRange, XLowerRange and YUpperRange, YLowerRange parameters.

<applet code=com.objectplanet.chart.ChartApplet width=200 height=140>
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=seriesCount value=2>
<param name=XUpperRange value=90>
<param name=XLowerRange value=-10>
<param name=YUpperRange value=90>
<param name=YLowerRange value=-15>
<param name=plots value="5|30,20|50,35|40,55|55,70|40,80|50">
</applet>

<applet code=com.objectplanet.chart.ChartApplet width=200 height=140>
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=seriesCount value=2>
<param name=XUpperRange value=10>
<param name=XLowerRange value=-90>
<param name=YUpperRange value=15>
<param name=YLowerRange value=-90>
<param name=plots value="-5|-30,-20|-50,-35|-40,-55|-55,-70|-40,-80|-50">
</applet>

<applet code=com.objectplanet.chart.ChartApplet width=200 height=140>
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=seriesCount value=2>
<param name=XUpperRange value=-50>
<param name=XLowerRange value=50>
<param name=YUpperRange value=-50>
<param name=YLowerRange value=50>
<param name=plots value="-40|-10,-25|10,-10|-20,10|25,25|-40,40|30">
</applet>


2.2 Range position and color

The ranges can be turned on/off at any side of the chart grid (top, left, bottom, right).

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=plots value="5|30,20|50,35|40,55|55,70|40,80|50,95|70">
<param name=rangeOn value="top,left,bottom,right">
</applet>

Setting rangeOn to an empty value turns all ranges off.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=plots value="5|30,20|50,35|40,55|55,70|40,80|50,95|70">
<param name=rangeOn value="false,false">
</applet>

Set the color of the range labels and ticks using the rangeColor parameter. The parameter value consists of 0 to 4 color values whith the following sequence: top, left, bottom, right. The color values can be the color name or the html hex code color number.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=plots value="5|30,20|50,35|40,55|55,70|40,80|50,95|70">
<param name=rangeOn value="top,left,bottom,right">
<param name=rangeColor value="green,red,blue,orange">
</applet>


2.3 Range value labels

You can set the font used for the range value labels, set the number of decimals to be displayed.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=plots value="0.5|3,2|5,3|4,5|5,7|4,8|5,9|7">
<param name=XUpperRange value=10>
<param name=YUpperRange value=10>
<param name=XRangeDecimalCount value=1>
<param name=YRangeDecimalCount value=2>
<param name=rangeColor value="x,red,blue">
<param name=connectedLinesOn value="true">
<param name=seriesColors value="red">
</applet>

Set the font used for the range value labels using the rangeLabelFont parameter.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=plots value="0.5|3,2|5,3|4,5|5,7|4,8|5,9|7">
<param name=XUpperRange value=10>
<param name=YUpperRange value=10>
<param name=YRangeDecimalCount value=1>
<param name=rangeColor value="x,red,blue">
<param name=connectedLinesOn value="true">
<param name=seriesColors value="red">
<param name=rangeLabelFont value="Courier,bold,14">
</applet>

The first argument to the rangeLabelFont_ is the font name, the second is plain, bold, italic, or bolditalic. The last argument is the point size of the font.


2.4 Range axis label

You can add a label to the range axis by using the rangeAxisLabel_ parameter. The position of the label must be specified after the rangeAxisLabel_ and can be right, left, top or bottom.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=plots value="0.5|3,2|5,3|4,5|5,7|4,8|5,9|7">
<param name=XUpperRange value=10>
<param name=YUpperRange value=10>
<param name=rangeColor value="x,red,blue">
<param name=connectedLinesOn value="true">
<param name=seriesColors value="red">
<param name=rangeAxisLabel_left value="left range">
<param name=rangeAxisLabel_bottom value="bottom range">
</applet>

Set the clockwise angle and the font of the label using the rangeAxisLabelAngle_ and rangeAxisLabelFont parameters.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="line">
<param name=chart value="plotter">
<param name=plots value="0.5|3,2|5,3|4,5|5,7|4,8|5,9|7">
<param name=XUpperRange value=10>
<param name=YUpperRange value=10>
<param name=rangeOn value="left,right">
<param name=connectedLinesOn value="true">
<param name=seriesColors value="red">
<param name=rangeAxisLabel_left value="left range">
<param name=rangeAxisLabelAngle_left value=270>
<param name=rangeAxisLabel_right value="right range">
<param name=rangeAxisLabelAngle_right value=90>
<param name=rangeAxisLabelFont value="Arial, bold, 12">
</applet>


2.5 Range adjuster

You can control the upper and lower ranges at runtime using the range adjuster.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=plots value="5|30,20|50,30|40,50|50,70|40,80|50,90|70">
<param name=XUpperRange value=100>
<param name=YUpperRange value=100>
<param name=rangeOn value="left,top">
<param name=connectedLinesOn value="true">
<param name=seriesColors value="red">
<param name=rangeAdjusterOn_right value=true>
<param name=rangeAdjusterOn_bottom value=true>
</applet>


3. Labels and Fonts

3.1 Chart title

The chartTitle parameter adds a label at the top center of the chart.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=plots value="5|30,20|50,35|40,55|55,70|40,80|50,95|70">
<param name=chartTitle value="chart title">
</applet>

You can have multiline labels by using a \n (goes for all chart labels).

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=plots value="5|30,20|50,35|40,55|55,70|40,80|50,95|70">
<param name=chartTitle value="chart\ntitle">
</applet>

The titleFont parameter sets the font used for the title.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=plots value="5|30,20|50,35|40,55|55,70|40,80|50,95|70">
<param name=chartTitle value="chart title">
<param name=titleFont value="Courier, bold, 20">
</applet>


3.2 Series labels

When using multiple data series you set a label for each data series using the seriesLabels parameter. The legend will display the series labels.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=seriesCount value=2>
<param name=seriesLabels value="Data A,Data B">
<param name=plots_0 value="10|30,30|20,50|40,70|40,90|30">
<param name=plots_1 value="5|50,20|70,35|60,55|75,70|60,80|70,95|90">
<param name=connectedLinesOn value=true>
<param name=legendOn value=true>
</applet>

Use the seriesLabelColors to set the colors of the series labels in the legend.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=seriesCount value=2>
<param name=seriesLabels value="Data A,Data B">
<param name=plots_0 value="10|30,30|20,50|40,70|40,90|30">
<param name=plots_1 value="5|50,20|70,35|60,55|75,70|60,80|70,95|90">
<param name=connectedLinesOn value=true>
<param name=legendOn value=true>
<param name=seriesLabelColors value="red,blue">
</applet>

Use the seriesLabelsOn to turn on series labels centered with plots.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=seriesCount value=2>
<param name=plots_0 value="20|20,40|40,60|40,80|30">
<param name=plots_1 value="10|60,30|75,50|60,70|70,90|90">
<param name=seriesLabels value="A,B">
<param name=seriesLabelsOn value=true>
<param name=plotSize value=20>
<param name=seriesLabelColors value="black,white">
</applet>

Use the seriesLabelStyle to show the series labels over, under the plot or floating.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=seriesCount value=2>
<param name=plots_0 value="20|20,40|40,60|40,80|30">
<param name=plots_1 value="10|60,30|75,50|60,70|70,90|90">
<param name=seriesLabels value="data a, data b">
<param name=seriesLabelsOn value=true>
<param name=plotSize value=6>
<param name=seriesLabelStyle value=floating>
</applet>


3.3 Legend labels

The legend is turned on using the legendOn parameter.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=seriesCount value=2>
<param name=plots_0 value="10|30,30|20,50|40,70|40,90|30">
<param name=plots_1 value="5|50,20|70,35|60,55|75,70|60,80|70,95|90">
<param name=legendOn value=true>
<param name=legendLabels value="serie 1, serie 2">
<param name=connectedLinesOn value=true>
</applet>

The legend position is controlled using the legendPosition parameter. The position can be right (default), left, top, or bottom.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=seriesCount value=2>
<param name=plots_0 value="10|30,30|20,50|40,70|40,90|30">
<param name=plots_1 value="5|50,20|70,35|60,55|75,70|60,80|70,95|90">
<param name=connectedLinesOn value=true>
<param name=legendOn value=true>
<param name=legendLabels value="serie 1, serie 2">
<param name=legendPosition value=bottom>
</applet>



Control the font used for the legend labels using the legendFont parameter.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=seriesCount value=2>
<param name=plots_0 value="10|30,30|20,50|40,70|40,90|30">
<param name=plots_1 value="5|50,20|70,35|60,55|75,70|60,80|70,95|90">
<param name=connectedLinesOn value=true>
<param name=legendLabels value="Data A, Data B">
<param name=legendLabelsOn value=true>
<param name=legendFont value="Arial, bold, 14">
</applet>

The color of the legend boxes are the same as the sample colors. Use the legendColors parameter to explicitly set the legend colors.

<applet code=com.objectplanet.chart.ChartApplet  width=200 height=140>
<param name=chart value="plotter">
<param name=seriesCount value=2>
<param name=plots_0 value="10|30,30|20,50|40,70|40,90|30">
<param name=plots_1 value="5|50,20|70,35|60,55|75,70|60,80|70,95|90">
<param name=seriesColors value="blue,red">
<param name=connectedLinesOn value=true>
<param name=legendOn value=true>
<param name=legendLabels value="Data A, Data B">
<param name=legendFont value="Arial, bold, 14">
<param name=legendColors value="red,blue">
</applet>

Any legend box may be replaced by an image.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=seriesCount value=2>
<param name=plots_0 value="10|30,30|20,50|40,70|40,90|30">
<param name=plots_1 value="5|50,20|70,35|60,55|75,70|60,80|70,95|90">
<param name=seriesColors value="blue,red">
<param name=connectedLinesOn value=true>
<param name=legendOn value=true>
<param name=legendLabels value="Data A, Data B">
<param name=legendImage_0 value="images/blue-ball-small.gif">
<param name=legendImage_1 value="images/magenta-ball-small.gif">
</applet>


3.4 Value labels

Turn on the value labels using the XValueLabelsOn and XValueLabelsOn parameter. Use the XValueLabelsOn_N and YValueLabelsOn_N parameter option to turn on or off the value labels for each data series.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=seriesCount value=2>
<param name=plots value="10|40,30|20,50|70,70|50,90|80">
<param name=plotStyle value=square_opaque>
<param name=plotSize value=14>
<param name=YValueLabelsOn value=true>
</applet>

Use the valueLabelStyle to display the labels over or under the sample point or to display floating value labels. The available values are center, over, under, floating.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=seriesCount value=2>
<param name=plots value="11|40,30|20,50|70,70|50,88|80">
<param name=plotStyle value=square_filled>
<param name=plotSize value=14>
<param name=XValueLabelsOn value=true>
<param name=YValueLabelsOn value=true>
<param name=valueLabelStyle value=floating>
</applet>

Use the XValueDecimalCount and YValueDecimalCount parameters to control the number of decimals used for the value labels. Use XValueDecimalCount_N and YValueDecimalCount_N to control the number of decimals per data series.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=seriesCount value=2>
<param name=plots value="11|42.3,30|21.3,50|65.2,70|50.4,88|79.9">
<param name=plotStyle value=square_filled>
<param name=plotSize value=14>
<param name=YValueLabelsOn value=true>
<param name=YValueDecimalCount value=1>
<param name=valueLabelStyle value=over>
</applet>

You can add a prefix and postfix to the value labels using the XValueLabelPrefix, XValueLabelPostfix and YValueLabelPrefix, YValueLabelPostfix parameters. To set a pre- and postfix per data series, add a _N (where N is the series number) to each parameter.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=seriesCount value=2>
<param name=plots value="11|42.3,30|21.3,50|65.2,70|50.4,88|79.9">
<param name=plotStyle value=diamond_filled>
<param name=plotSize value=14>
<param name=YValueLabelsOn value=true>
<param name=YValueLabelPrefix value="$">
<param name=valueLabelStyle value=over>
</applet>


3.5 Plot labels

You can set a label per any specific plot in the chart. The labels can either be displayed below the chart grid, floating above a plot when the mouse moves over it, or both below and floating.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=rangeOn value="left">
<param name=plots value="5|30|x|one,20|50|x|two,35|35|x|three,55|55|x|four,70|40|x|five,80|50|x|six,95|70|x|seven">
<param name=plotSize value="4">
<param name=plotLabelsOn value="true">
<param name=plotLabelAngle value="270">
<param name=plotLabelStyle value="below_and_floating">
<param name=XValueLinesOn value="false">
<param name=YValueLinesOn value="false">
</applet>


3.6 X-axis labels

You can set custom labels that will be displayed on the X range axis using XRangeLabels parameter.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=rangeOn value="left">
<param name=plots value="5|30,20|50,35|35,55|55,70|40,80|50,95|70">
<param name=plotSize value="4">
<param name=XRangeLabels value="0|01.05,20|01.06,40|01.07,60|01.08,80|01.09,100|01.10">
<param name=XRangeLabelAngle value="270">
<param name=YValueLinesOn value="false">
</applet>


4. Chart Colors

4.1 Sample colors

Use the seriesColors parameter to set the colors of the plot series and legend label boxes. You can either use the color names or the hex value (e.i. #c0a0f0) for the colors.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value=plotter>
<param name=seriesCount value=3>
<param name=plots_0 value=20|21,40|16,60|24,80|19>
<param name=plots_1 value=5|39,25|52,45|57,65|51,85|37>
<param name=plots_2 value=10|84,30|74,50|79,70|88,90|60>
<param name=seriesColors value=red,orange,magenta>
<param name=connectedLinesOn value=true>
<param name=lineWidth value=2>
<param name=legendOn value=true>
<param name=legendLabels value="Data A, Data B, Data C">
<param name=legendPosition value=bottom>
</applet>


4.2 Background color

Set the chart component background color using the background parameter. This does not include the chart grid background color.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value=plotter>
<param name=plots value="5|30,20|50,30|40,50|50,70|40,80|50,90|70">
<param name=connectedLinesOn value=true>
<param name=background value=orange>
</applet>


4.3 Chart background color

Set the color of the chart grid background using the chartBackground parameter.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value=plotter>
<param name=plots value="5|30,20|50,30|40,50|50,70|40,80|50,90|70">
<param name=connectedLinesOn value=true>
<param name=chartBackground value=orange>
</applet>


4.4 Foreground color

Set the chart component foreground color using the foreground parameter.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value=plotter>
<param name=plots value="5|30,20|50,30|40,50|50,70|40,80|50,90|70">
<param name=connectedLinesOn value=true>
<param name=foreground value=blue>
<param name=chartTitle value="foreground color set">
</applet>


4.5 Chart foreground color

Set the foreground color of the chart grid elements.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value=plotter>
<param name=plots value="5|30,20|50,30|40,50|50,70|40,80|50,90|70">
<param name=connectedLinesOn value=true>
<param name=chartForeground value=white>
<param name=foreground value=white>
<param name=chartBackground value=black>
<param name=background value=black>
</applet>


5. Chart Style

Through the applet parameters you can control how the chart is displayed.


5.1 Horizontal grid lines

You can turn on/off horizontal and vertical value lines using the XValueLinesOn and YValueLinesOn parameters.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value=plotter>
<param name=plots value="5|30,20|50,30|40,50|50,70|40,80|50,90|70">
<param name=connectedLinesOn value=true>
<param name=XValueLinesOn value=false>
<param name=YValueLinesOn value=false>
</applet>

You can set the color of the value lines using the XValueLinesColor and YValueLinesColor parameter.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value=plotter>
<param name=plots value="5|30,20|50,30|40,50|50,70|40,80|50,90|70">
<param name=connectedLinesOn value=true>
<param name=background value=lightGray>
<param name=chartBackground value=lightGray>
<param name=XValueLinesColor value=white>
<param name=YValueLinesColor value=white>
</applet>

The jumps in the value lines and range labels is controlled by the space available for the value lines and range labels. You can not control the jumps directly, but you can set the maximum number of lines you want using the XMaxValueLineCount and YMaxValueLineCount parameter.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value=plotter>
<param name=plots value="5|30,20|50,30|40,50|50,70|40,80|50,90|70">
<param name=connectedLinesOn value=true>
<param name=XMaxValueLineCount value=3>
<param name=YMaxValueLineCount value=3>
</applet>


5.2 Line width

Set the pixel width of the lines using the lineWidth parameter.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value=plotter>
<param name=plots value="5|30,20|50,30|40,50|50,70|40,80|50,90|70">
<param name=connectedLinesOn value=true>
<param name=lineWidth value=5>
</applet>

If the chart has multiple data series you can set the line width of each data series by comma seperation.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value=plotter>
<param name=seriesCount value=3>
<param name=plots_0 value=20|21,40|16,60|24,80|19>
<param name=plots_1 value=5|39,25|52,45|57,65|51,85|37>
<param name=plots_2 value=10|84,30|74,50|79,70|88,90|60>
<param name=connectedLinesOn value=true>
<param name=lineWidth value="2,5,10">
</applet>


5.3 Plot style and size

Use the plotSize parameter to set the size for each point in a serie.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value=plotter>
<param name=plots value="5|30,20|50,30|40,50|50,70|40,80|50,90|70">
<param name=connectedLinesOn value=true>
<param name=plotSize value=10>
</applet>

The plotSize_N can be used to set the size per data series.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value=plotter>
<param name=seriesCount value=3>
<param name=plots_0 value=20|21,40|16,60|24,80|19>
<param name=plots_1 value=5|39,25|52,45|57,65|51,85|37>
<param name=plots_2 value=10|84,30|74,50|79,70|88,90|60>
<param name=connectedLinesOn value=true>
<param name=plotSize_0 value=6>
<param name=plotSize_1 value=10>
<param name=plotSize_2 value=16>
</applet>

You can set circles, squares, and diamond shapes to the plot points on the data series. Use the plotStyle parameter to set the style of the plot series. The style can be circle, circle_filled (default), circle_opaque, square, square_filled, square_opaque, diamond, diamond_filled, or diamond_opaque.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value=plotter>
<param name=plots value="5|30,20|50,30|40,50|50,70|40,80|50,90|70">
<param name=connectedLinesOn value=true>
<param name=plotSize value=10>
<param name=plotStyle value=square_opaque>
</applet>

The plotStyle can also use comma seperation to set the style per data series.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value=plotter>
<param name=seriesCount value=3>
<param name=plots_0 value=20|21,40|16,60|24,80|19>
<param name=plots_1 value=5|39,25|52,45|57,65|51,85|37>
<param name=plots_2 value=10|84,30|74,50|79,70|88,90|60>
<param name=connectedLinesOn value=true>
<param name=plotSize_0 value=6>
<param name=plotSize_1 value=10>
<param name=plotSize_2 value=16>
<param name=plotStyle value=circle,square_opaque,diamond_filled>
</applet>

Use the plotImage parameter to set an image to highlight all plots. Use plotImage_N parameter to set an image to highlight all plots in the serie. Use plotImage_N_M to highlight the specific sample.

<applet code=com.objectplanet.chart.ChartApplet width=200 height=140>
<param name=chart value=plotter>
<param name=seriesCount value=3>
<param name=plots_0 value=20|21,40|16,60|24,80|19>
<param name=plots_1 value=5|39,25|52,45|57,65|51,85|37>
<param name=plots_2 value=10|84,30|74,50|79,70|88,90|60>
<param name=connectedLinesOn value=true>
<param name=plotImage_0 value="images/blue-ball-small.gif">
<param name=plotImage_1 value="images/magenta-ball.gif">
<param name=plotImage_2 value="images/cyan-ball-small.gif">
</applet>


6. Miscellaneous

6.1 Target value lines

You can add a horizontal line at a specified value position in the chart grid. The line can have any color and a label to the left of it. Use the targetValueLine_N parameter to add target value lines.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=plots value="5|30|4,20|50|6,35|40|3,55|55|4,70|40|7,80|50|3,95|70|9">
<param name=targetValueLine_0 value="Target A, 15, red">
<param name=targetValueLine_1 value="Target B, 40, blue">
<param name=targetValueLine_2 value="Target C, 25, gray, value">
</applet>

The first field in the target parameter is the label to be displayed. The second field is the value where it should be painted. The third parameter is the color (use the color name or a hex code) of the line and label. The fourth and optional parameter states if only the value should be displayed (value) or only the label (label). Both the label and the value are displayed by default.


6.2 URLs and drilldown

You can add a URL or javascript call to any data series or plot point in the chart and have the applet open a new web page when the user double-clicks the plot point or legend entry. You must include the MAYSCRIPT parameter in the applet tag if you want to call javascript functions.

Have the url point to a web page containing another chart to create drilldown charts.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140 MAYSCRIPT>
<param name=chart value="plotter">
<param name=plots value="5|30,20|50,35|35,55|55,70|40,80|50,95|70">
<param name=plotSize value="6">
<param name=plotStyle value="dimond_filled">
<param name=url_0 value="chart1.html">
<param name=url_1 value="chart2.html">
<param name=url_2 value="chart3.html">
<param name=url_3 value="chart4.html">
<param name=url_4 value="javascript:winOpen('line.html', 200,500);">
</applet>

The parameter url_0 adds a URL to the first sample point in the above example. Use the parameter url to add a default url to all the samples.

In a chart having multiple data series, the url_N parameter adds a url to series N. The parameter url_N_M adds a url to sample M in data series N.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value="plotter">
<param name=seriesCount value="2">
<param name=sampleValues_0 value="5|15,20|35,35|20,55|40,70|25,80|35,95|55">
<param name=sampleValues_1 value="5|45,20|65,35|50,55|70,70|55,80|65,95|85">
<param name=url_0_0 value="chart1.html">
<param name=url_1_0 value="chart2.html">
</applet>

The example above adds a url to the first plot point in the two data series of the chart.

You can also set the URLs programatically by calling setParameter("url_0", "myurl");

The parameter urltarget, urltarget_N, urltarget_N_M adds a target window where the new web page should be opened. The parameter labelURLTarget and labelURLTarget_N specifies the target widow for the anywhere labels with URLs. The default behavior is to open the new page in the same window.

The different parameter values are:

_self: Open new page in same window or frame.
_parent: Open in the parent window.
_top: Open in the top-level window.
_blank:Open in a new blank window.
name:Open in the frame or window with the specified name.

Use the singleClickURLOn parameter to use single click drilldowns.

6.3 Graph insets

The sizing of the chart grid is automatically calculated based on the size and position of other elements in the chart. You can explicitly set the chart grid by using the graphInsets parameter.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value=plotter>
<param name=plots value="5|30,20|50,30|40,50|50,70|40,80|50,90|70">
<param name=connectedLinesOn value=true>
<param name=graphInsets value="0,0,0,0">
</applet>

The sequence of the graphInsets parameter value is top, left, bottom, right. If you use -1 for any of the fields, the default inset for that side will be set.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value=plotter>
<param name=plots value="5|30,20|50,30|40,50|50,70|40,80|50,90|70">
<param name=connectedLinesOn value=true>
<param name=graphInsets value="30,30,30,30">
</applet>

The user can control the size and position of the chart grid at runtime by clicking on a chart grid edge and dragging it. Use the gridAdjustmentOn parameter to turn this behaviour on. The value can either be set to true, or a combination of top,left,bottom,right.

<applet code=com.objectplanet.chart.ChartApplet
 archive=chart.ext.jar width=200 height=140>
<param name=chart value=plotter>
<param name=plots value="5|30,20|50,30|40,50|50,70|40,80|50,90|70">
<param name=connectedLinesOn value=true>
<param name=gridAdjustmentOn value=true>
</applet>



Color names: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, white, yellow



Copyright (C) 1998-2010 ObjectPlanet, Inc.
phone (+47) 2233 3360 fax (+47) 2233 3361