XY-Chart
XY Charts 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.
LineSets
LineSets = (name1, color1), (name2, color2),...;
Defines a list of line set tuples with the following
attributes in each tuple:
"Name" |
Name assigned to this data set |
SymColor |
Color to be used by default for all symbols and
lines associated with this line set. |
By default, the Name and SymColor assigned
to each data set will be used in the Legend.
At most 50 line sets 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.)
LineAxis
LineAxis = (XAxis1, YAxis1), (XAxis2, YAxis2), ...;
The XAxis and YAxis attributes define the specific
axis to be used when mapping the X and Y values respectively for each
data set defined. The XAxis attribute may be set to BOTTOM or TOP, while
the YAxis may be set to LEFT or RIGHT.
LineSet[150]
LineSet[150] = (x1,y1), (x2,y2), ...;
Defines a list of (x,y) values for each line set
defined by the LineSets parameter. If "null" is substituted
for either or both of the x/y pair value's, the point will not be drawn.
LineColorTable[1-50]
LineColorTableN = color1, color2, ...;
Defines a set of colors for dataset N that overrides all other color
specifications for that set. The parameters used for specifying the color of data points in a chart
are (in ascending order of precedence) ColorTable, LineSets, LineSymbol, LineFillPattern
and LineColorTable. LineColorTableN is used most frequently to color some specific point.
For example:
LineColorTable2 = ,,blue;
will change the third point in the second series to blue, while all other points in the chart
continue to be colored by one of the other color related parameters.
LineSymbol
LineSymbol = (type1, size1, style1, borderColor1,
borderWidth1, image1,symbolColor,shadowWidth),...
This parameter specifies the symbols to be displayed
for one or more line sets. That is, the first tuple defines the symbol
for the first line set, and so on. The following attribute values are
supported:
Type |
Type of symbol to be displayed,
including:
NONE, CIRCLE, SQUARE, DIAMOND, CROSS,TARGET
TRIANGLEDOWN, TRIANGLEUP, IMAGE
If NONE is specified, then no symbol is displayed.
If IMAGE is specified, then the image attribute will be used to
load a GIF image for the symbol.
|
Size |
Specifies the size of the symbol
in pixels. This attribute is ignored for IMAGE symbols. |
Style |
Specifies how the symbol
should be drawn, including FILLED, OUTLINED, or BOTH. If FILLED
is specified, the symbol is filled with the line set color. If OUTLINED
is specified, only the outline is drawn, using the line set color.
If BOTH is specified, then the symbol is filled with the line set
color and the outline is drawn using the borderColor. |
BorderColor |
The color used when drawing the outline
of a symbol with style BOTH. |
BorderWidth |
The width of the outline for a symbol
with style OUTLINED or BOTH. |
Image |
The URL of a GIF image file to be
used as the symbol when the type attribute is set to IMAGE. Transparent
images are supported (GIF89 format). |
SymbolColor |
The color when used for drawing a symbol.
|
ShadowWidth |
The size of the shadow drawn behind the symbol. Any number
other than 0 causes NetCharts to choose a shadow size based on the size of the symbol.
Specifying a value of 0 suppresses the shadow. |
This parameter is processed AFTER the deprecated
DataSets parameter (which included symbol attributes) and any attributes
specified in that parameter will be overridden by those specified in
this parameter.
LineStyle
LineStyle = (type1, width1, color1, fillColor1),...
This parameter specifies the line style to be displayed
for one or more line sets. That is, the first tuple defines the symbol
for the first line set, and so on. The following attribute values are
supported:
Type |
Specifies the style of the
line to be drawn, as follows:
NONE, SOLID, DOTTED, DASHED, DOTDASH
If NONE is specified, then no line is drawn
between the symbols in the given line set.
|
Width |
The width of the line in pixels.
Default width is 1. |
Color |
The color of the line. Default color
is the color of the line set itself. |
FillColor |
If this attribute is not "null",
then the area under the lineset will be filled with the given color.
|
LineType |
NORMAL - Normal line
FIT - Draws a spline curve approximation
BOTH - Draws both a normal line and a spline curve approximation
|
Line3DDepth
Line3DDepth = depth;
If depth is greater than 1, then all line sets
will be displayed as 3D lines, in separate rows, much like the ROWS
GraphType in NFBarchartApp. The max amount of space allocated to each
line in the Z dimension will be "depth" pixels.
The default value is 0.
LineWidth
LineWidth = percent;
This percentage value (0-100) or (0.0-1.0)
determines the amount of space actually used to display 3D lines when
Line3DDepth is greater than 1. If 100 percent is specified, then each
line will completely fill the amount of space specified by Line3DDepth
in the Z dimension. If 50 percent is specified, then each line will
occupy only 50 percent of that space, which will result in a visible
separation between each line set.
The default value is 100.
LineLabels
LineLabels1 = ("OUTLINE", "fr22383.html", "frame1");
LineLabels[1-50] defines sets of sets of active label
destinations for the lines in a line graph, and maps to DataSets, which
must also be specified. Using this element also requires use of the
ActiveClicks element. You might use this in creating active labels for
a chart with multiple lines and thus datasets.
LineValueLabel
LineValueLabel = ("mode", color, "font name", font size, angle, interiorAlignment);
Defines
the label value to be displayed near each point in a lineset.
Valid mode values are
"ON" and "OFF", the default value is "ON".
example: ("ON",black,"Helvetica",18,0);
This parameter was introduced in NetCharts
4.0.
LineValueLabelBox
LineValueLabelBox = (color,bordertype,borderwidth);
example:(grey,RAISED,3);
Defines
the label box to be displayed near each point in a lineset.
Values are as follows:
Color |
The color of the region.
If an image attribute is also defined, this color is drawn first,
followed by the image, allowing this color to show through any
transparent parts of the image. |
BorderType |
The following border
styles are supported:
NONE - No border
BOX - Simple Box outline
SHADOW - Shadow border
RAISED - Raised border
RECESS - Recessed border
When the BOX and SHADOW styles are specified,
the border color will be black. When the RAISED and RECESS styles
are specified, the border color will be chosen based on the region
color. |
BorderWidth |
This attribute defines
the width of the border in pixels.
|
This
parameter was introduced in NetCharts 4.0.
LineValueLabelStyle
LineValueLabelStyle = labelposition1,labelposition2 ..., labelpositionN;
Defines where the LineValueLabel
text will be justified for each point in a dataset.
example: LineValueLableStyle = CENTER, TOP;
Available justification options for LineValueLabelStyle
are:
CENTER |
Center of the lineset datapoint |
BOTTOM |
Bottom of the lineset datapoint |
TOP |
Top of the lineset datapoint |
LEFT |
Left of the lineset datapoint |
RIGHT |
Right of the lineset datapoint |
TOP RIGHT |
Top Right of the lineset datapoint |
BOTTOM RIGHT |
Bottom Right of the lineset of the lineset datapoint |
TOP LEFT |
Top Left of the lineset datapoint |
BOTTOM LEFT |
Bottom Left of the lineset of the lineset datapoint |
NONE |
No line labels display |
This parameter was introduced in NetCharts
4.0.
AddDataPoint
AddDataPoint = (LineSetNumber, 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.
|