KavaChart General Properties

<param name="propertyName" value="propertyValue">

chartBean.setProperty("propertyName", "propertyValue");

<chart:streamed dataProviderId="dpid" style="persistentProperties">
	<chart:param name="transientProperty" value="propertyValue">
</chart:streamed>

General Chart Properties

• anything - Some properties can accept anything.  These properties are usually for turning something on or off, so for clarity's sake you might want to use something like
  

<PARAM name=legendOn value="true">

• String - This is a word or phrase, like "My Title"

• color - this property expects a color name, or a hexadecimal color definition (in RGB). KavaChart recognizes the color names black, white, gray, darkGray, lightGray, red, pink, orange, yellow, green, magenta, cyan, and blue. A valid hex definition for white is "ffffff" or "0xffffff". You can also use the color "transparent" if you don't want a particular element to be visible.

• font - a valid font definition includes the  font family name, size, and style, separated by commas (or your delimiter). KavaChart's default is TimesRoman 12pt, which is available for all JREs. A font property looks like this: 

<PARAM name=xAxisLabelFont value="Arial,18,2">

This instructs KavaChart to use 18 point Arial italic fonts for this chart's X axis labels. Style definitions: 0 is plain, 1 bold, and 2 italic.

• integer - this property requires an integer (any number without a decimal point)

• double - this property requires an number, generally a number between 0 and 1. Charts use these to describe percentages, e.g. .5 = 50%

• list - a few properties require a list of arguments. These include things like axis labels, data values, and  axis options.  A list of items is separated by commas (or your defined delimiter).
  

Axis Properties

If you're modifying an X Axis (usually on the top or bottom of a chart), use xAxisPropertyName instead of yAxisPropertyName. X Axes are on the left and right for Horizontal Bar Type charts. Speedo and Polar charts have a single Axis, which is a Y Axis.

If you're modifying an Auxiliary Y Axis (charts that have left and right axes, for example), use auxAxisPropertyName instead of yAxisPropertyName.

Axis Property	Value Type	Effect
yAxisTitle	string	Axis title
yAxisTitleFont	font	Axis title font
yAxisTitleColor	color	Axis title color
yAxisLabelFont	font	use this font for axis labels
yAxisLabelColor	color	axis labels in this color (default black)
xAxisLabels	list	A comma separated list of user-defined labels for this Axis. This is only effective for certain types of chart (BarChart derivatives, LabelLineChart, Area charts) that use a LabelAxis.
yAxisLabelAngle	integer	label rotation in degrees (default 0). Note: rotations of 0 and 90 degrees will be the most readable
yAxisLabelPrecision	integer	Number of digits past the decimal point to display
yAxisLineColor	color	axis line color (default black)
yAxisTickColor	color	axis tick mark color (default black)
yAxisGridColor	color	axis grid line color (default black)
yAxisColor	color	sets axis grids, ticks, lines and labels to the same color
yAxisTickLength	integer	number of pixels long for axis tick marks
yAxisMinTickLength	integer	number of pixels long for axis minor tick marks
yAxisStart	double	starting value on axis. By default, axes automatically determine a starting and ending value. By setting this value, you can give the axis a default minimum value. If the Axis is set to noAutoScale, this value will be used directly. Otherwise, this value may be adjusted slightly to yield better looking labels. For example, if you set yAxisStart to 0.01, the chart may decide to round the value down to 0.0 to create even axis increments.
yAxisEnd	double	ending value on axis. By default, axes automatically determine a starting and ending value. By setting this value, you can give the axis a default maximum value. If the Axis is set to noAutoScale, this value will be used directly. Otherwise, this value may be adjusted slightly to yield better looking labels. For example, if you set yAxisStart to 9.99, the chart may decide to round the value up to 10.0 to create even axis increments.
yAxisLabelCount	integer	how many labels on an axis set to noAutoScale
yAxisTickCount	integer	how many tick marks on an axis set to noAutoScale
yAxisMinTickCount	integer	how many minor tick marks on an axis set to noAutoScale
yAxisGridCount	integer	how many grid lines on an axis set to noAutoScale
yAxisGridStyle	integer	the line style of the grid lines for this axis
yAxisGridWidth	integer	the width in pixels of the grid lines for this axis
yAxisThresholdLine0Value	double	a value for a specialized grid line on this axis (create as many as you need)
yAxisThresholdLine0Color	color	a color for this threshold line
yAxisThresholdLine0LineStyle	integer	a linestyle for this threshold line
yAxisThresholdLine0LabelString	String	a label for this threshold line
yAxisThresholdLine0LabelColor	color	a color for this threshold line's label
yAxisThresholdLine0LabelFont	Font	a font for this threshold line's label

Axis Option Lists

<param name=xAxisOptions value="gridOn, tickOff, lineOff">

Dataset Properties

URL Dataset Parameters

Data URLs can be files, but more often, they point to CGIs that generate data dynamically. This mechanism lets you keep your overall chart definition unchanged while modifying the data to meet your requirements.

Applets can also use the networkInterval parameter to re-read data from the URL, updating the chart as necessary.

URL Dataset Properties (available datasets 0 through 39)	Type	Effect
dataset0xURL	URL	URL for a file of comma separated X values for dataset 0
dataset0yURL	URL	URL for a file of comma separated list of Y values for dataset 0
dataset0URLLabels	list	comma separated labels for URLs
URLDataBlock	URL	URL for a file of comma separated Y values. Each line in this file is assumed to be a unique dataset.
URLXYDataRows	URL	URL for a file of comma separated XY pairs arranged into rows. Each row represents a single dataset, with values arranged as x1, y1, x2, y2, x3, y3...
URLXYDataColumns	URL	URL for a file of comma separated XY pairs arranged into columns. This file must contain a single value as the first line of the file, specifying the number of observations (rows) in the file. The first two columns are dataset 1, the second two columns are dataset 2, etc.
networkInterval	integer	Number of seconds to wait before re-reading URL datasets (applets only)
customDatasetHandler	string	information passed to a user-defined dataset handling routine "void getMyDatasets(String str)" Note: in the case of DateAxis, this is the URL for a data file that contains columnar Date information. This method has been largely superceded by KavaChart's DataProvider interface, which lets you implement a portable class to plug in, using the "setDataProvider" method.

Date Chart Properties

The following list contains general charting options for charts that use time oriented axes:

Property	Type	Effect
startData	String	Ignore any data earlier than this time/date. Note: this string is interpreted according to the "inputDateFormat" property, which uses values described in the Date Format section below.
endData	String	Ignore any data later than this time/date. Note: this string is interpreted according to the "inputDateFormat" property, which uses values described in the Date Format section below.
inputDateFormat	String	Use this pattern to read any incoming data. For more information on how to construct this string, see the Date Format section below.
incrementalDataURL	URL	Applets only.  A URL to poll for additional data points. Date oriented charts read initial data from the URL or file specified in "customDatasetHandler". Subsequent observations can be added to applets by polling the URL specified in this parameter. This URL will be checked each networkInterval.

Date Axis Properties

Date Format Patterns

The actual string values for each format are determined by locale and the time being formatted.

Dwell Label Properties