Bar
Chart
|
GROUP | datasets are grouped together (default) |
ROWS | datasets are displayed in separate rows |
STACK | datasets are stacked |
GROUPSTACK | datasets are grouped and stacked |
GraphLayout = type;
Defines the bargraph orientation. The following types are supported:
HORIZONTAL | bars are oriented left to right. |
VERTICAL | bars are oriented bottom to top. (default) |
Note that the BarLabels resource will be displayed on the left axis for HORIZONTAL bargraphs and the bottom axis for VERTICAL bargraphs.
DataSets = (Name1, Color1, Type1), (Name2, Color2, Type2) ...;
Defines a list of datasets with the given name color and type. The names will be used as items in the Legend, and the color will be used for each bar in the dataset.
The following bar types are supported:
Note that some types may produce unusual results if the graph type is STACK or ROWS. If one of the "Pie" types is selected, the alternate pie color will be extracted from the first element of the ColorTable.
At most 50 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.) Furthermore, if only a single data set is defined and no color value is assigned (or null is assigned) then EVERY bar in that data set will be given a different default color, depending on its position.
DataAxis = (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 Y Axis may be set to LEFT or RIGHT.
DataSet[150] = Number1, Number2, ...;
Defines a list of numeric values for each dataset defined by the DataSets parameter. Each dataset may contain a different number of values. If the value "null" is substituted for a Number, no bar will be drawn in that bar position.
DataSet[150]P[150] = Number1, Number2, ...;
Defines a list of numeric values for each dataset in a grouped, stacked barchart (GraphType=GROUPSTACK). In a grouped stacked barchart each tic location can contain multiple data sets, and each data set can contain multiple data values.
Consider this example:
This chart contains two data sets, each set has 3 values to display at each tic on the chart.
DataSet1P1 defines two values - the first value in the first set at each tic mark. DataSet2P3 defines two values - the third value of the second set at each tic.
BarBorder = (lineType, lineWidth, lineColor);
This parameter specifies the line
style to be used for the border of all bars. The following attribute
values are supported:
lineType
SOLID (default), DOTTED, DASHED, DOTDASH
lineWidth
The width of the line in pixels.
Default width is 1.
lineColor
The color of the line. Default color
is black.
BarColorTableN = 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 bars in a chart are (in ascending order of precedence) ColorTable, DataSets, BarSymbol, BarFillPattern and BarColorTable. BarColorTableN is used most frequently to color some specific bar. For example:
BarColorTable2 = ,,blue;will change the third bar in the second series to blue, while all other bars in the chart continue to be colored by one of the other color related parameters.
BarColorTable[1-50P[1-50] = color1, color2, ...;
This parameter is used only for grouped stacked barcharts (GraphType=GROUPSTACK). It defines a set of colors for datasetN that overrides all other color specifications for that set. The parameters used for specifying the color of bars in a chart are (in ascending order of precedence) ColorTable, DataSets, BarSymbol, BarFillPattern and BarColorTable[1-50]M[1-50]. BarColorTable is used most frequently to color some specific bar. For example:
BarColorTable2P1 = blue,blue;will change the color the first bar of the second data series blue at the first tic location and at the second tic location.
BarCorners = (topleft,topright,bottomright,bottomleft);
BarCorners specifies the corner style to be used for the 2D bars in a chart. The attributes correspond to specific corners of the bar beginning at the top left and advancing in clockwise sequence to the bottom left. The default corner style is SQUARE. Elements which can be selected for each corner are: SQUARE, SNIP and ROUND. SNIP trims the square corner from the bar obliquely. ROUND substitutes a smoothly rounded edge for the square corner. The amount to be snipped or rounded can be adjusted by adding an underscore modifier to the elements SNIP and ROUND followed by a value. A whole number value will set the number of pixels to be removed. A fractional value will set the percentage of the overall bar to be removed. To set the percentage, enter a fractional value between 0 and 1 and place it after the underscore (e.g. "SNIP_0.09" will cause 9% of the corner to be removed; "ROUND_0.50" will cause 50% of the corner to be rounded). When using a fractional value, enclose the tuple element in double-quotes to "escape" the decimal point.
example: BarCorners = (SNIP,SQUARE,SQUARE,SQUARE);
ROUND | Draws a rounded corner. |
SNIP | Cuts the corner off of obliquely. |
SQUARE | Draws a square corner (default). |
SNIP_val | Cuts the corner off obliquely based upon the number of pixels or percentage shown in val. |
ROUND_val | Draws a rounded corner based upon the number of pixels or percentage shown in val. |
BarDropShadow = (color,offsetx,offsety,size);
BarDropShadow places a shadow on the background field of the bar chart. The color, orientation, and size of the shadow can be defined. The tuple element color sets the color of the shadow. That color value is interpolated to complete transparency as it reaches the end of the shadow's blur area. Offsetx and offsety define the center point of the shadow; offsetx sets the x-axis offset from the chart's center-point; offsety sets the y-axis offset. When an offset attribute is set to a whole number value, the position of the drop shadow is offset from the chart's center point by the number of pixels set by that whole number. When an offset is set to a fractional value (between 0 and 1), the value is interpreted as a percentage of the width of the object casting the shadow (the set of bars). The center of the drop shadow is repositioned based upon the values or percentages set for offsetx and offsety. Offset attribute values may be positive or negative. Size sets the size of the blur area, the region beyond the actual drop shadow shape where the shadow is extended and blurred into transparency. The size of this blurred region is controlled by the size attribute. The blurred region becomes larger and more diffuse as the value of size is increased. When size is set to a whole number value, the size of the blurred area is defined in pixels. When size is set to a fractional value (between 0 and 1), the value is interpreted as a percentage of the width of the object casting the shadow. When using a fractional value, enclose the value in double-quotes to "escape" the decimal point.
BarDropShadow = (black, "-.05", "-0.05", 55);
BarHighlights = (type,start,stop,top,right, bottom,left,width,height,topLeft,topRight,bottomRight,bottomLeft), ...;
The BarHighlights parameter provides a visual pattern fill in a bar or combo chart. It adds or overlays a fill pattern over one or more existing fill patterns to produce multiple effects. The width or height of the pattern can be modified. The gap between the sides of the bar and the fill pattern being applied can be modified. Gradient patterns can be set using the type attribute. Only gradient patterns may be used. A type value of NONE suppresses the highlights. The element start sets the beginning color of the gradient; the element stop sets the end color of the gradient. Color values are interpolated between the two. The elements top, right, bottom, and left specify the size of the gaps between the edge of the highlight and the associated edge of the bar. When the values for top, right, bottom, and left are specified as whole numbers, they set the distance between the edge of the highlight and the edge of the bar in pixels. When set to a fractional number between 0 and 1, they set the gap to a percentage of the width of the bar. Percentage values are written using a decimal point (e.g. "0.05" and "0.50" represent 5% and 50%, respectively). When using a fractional value, enclose the tuple element in double-quotes to "escape" the decimal point. The element width controls the width of the highlight; the element height controls the height. When values for width and height are specified using whole numbers, they set the distance in pixels. If width or height is set to -1, BarHighlights fills all of the space available after taking into account any gaps specified in previous attributes. If width or height is set to a fractional number between 0 and 1, BarHighlights sets the width or height of the highlight using the percentage of available width or height of the bar.
Type | NONE | no pattern, do default fill, if any |
Gradients | ||
GRADIENTVERTICAL | bottom to top style gradient | |
GRADIENTHORIZONTAL | left to right style gradient | |
GRADIENTFDIAG | top right to bottom left style gradient | |
GRADIENTBDIAG | top left to bottom right style gradient | |
GRADIENTRADIAL | radial style gradient | |
GRADIENTCENTERHORIZONTAL | center out horizontal gradient | |
GRADIENTCENTERVERTICAL | center out vertical gradient | |
start | This color is used in the following ways: - Starting color for gradients |
|
stop |
This color is used in the following ways: |
|
BarHighlights = (GRADIENTRADIAL,yellow,white,15,15,15,15,-1,-1)
BarActiveLabels = ("Label1", "URL1", "Target1"),...;
BarLabels = "String1", "String2", ...;
Defines a list of labels to be displayed below each group of bars. This parameter overrides the BottomLabels parameter (for VERTICAL bars) or the LeftLabels parameter (for HORIZONTAL bars).
BarActiveLabels = ("Label1", "URL1", "Target1"),...;
The BarActiveLabels parameter specifies a list of custom active labels to be associated with each bar label. That is, these labels will be displayed whenever the mouse "dwells" over a given bar label. This can be used to provide the user with additional information about that particular bar grouping or to "drill-down" to another document. See Active Labels for a detailed explanation of active label capabilities.
The BarActiveLabels parameter overrides the BottomActiveLabels parameter (for VERTICAL bars) or the LeftActiveLabels parameter (for HORIZONTAL bars).
BarAnimationStyle = GROW | FADE | NONE;
Specifies how the bars initially appear in a chart. This parameter is only valid in SVG or SVGWeb output formats.
example: BarAnimationStyle = GROW;
GROW |
The bars grow from the origin of the axis to their actual values. |
FADE | The bars fade in. |
NONE | The bars are immediately visible. |
Bar3DDepth = Number;
Defines the "depth" of the bar in pixels. A depth of 0 draws a 2D bar.
BarSpotlights = (start,stop,center,centeroffsetx,centeroffsety,focusoffsetx,focusoffsety,radius),...;
BarSpotLights adds or overlays a color fill over one or more existing fill patterns to produce multiple layered color effects. The spotlight "illuminates" the bars of the chart. The center of the spotlight and its focus can be adjusted independently by adjusting offsets from the bar chart center point. The elements centeroffsetx and centeroffsety set the x and y-coordinates of the center of the spotlight as an offset of the chart center point. When set to whole numbers, centeroffsetx and centeroffsety specify the number of pixels to offset from the chart center point. When set to fractional values (between 0 and 1), they are interpreted as percentages of the width of the bars. Percentage values are written using a decimal point (e.g. "0.05" and "0.50" represent 5% and 50%, respectively). When using a fractional value, enclose the tuple element in double-quotes to "escape" the decimal point. The element focusoffsetx is the offset from the chart center which defines the x-coordinate of the focus point of the spotlight. The element focusoffsety is the offset from the chart center which defines the y-coordinate of the focus point of the spotlight. When set to whole numbers, focusoffsetx and focusoffsety specify the offset from the center in pixels. When set to fractional values (between 0 and 1), they are interpreted as percentages of the width of the bars. The element radius sets the size of the spotlight, from its center to its edge. When set to a whole number, it sets the size of the radius in pixels; when set to a fractional value, it sets the radial diameter of the spotlight based upon that percentage of the minimum height and width of the bars on the chart.
example: BarSpotlights = (purple_40, blue_155, LEFT, 20,10,120,-120,250);
start | Start specifies the first of the two colors which will be interpolated to produce a gradiant spotlight. |
stop | Stop specifies the second of two colors which will be interpolated to produce a gradiant spotlight. |
center | Center specifies the position around of the center of the chart where the spotlight center will be placed.
The following values are supported:
|
centeroffsetx | Centeroffsetx specifies the x-coordinate offset for the spotlight center. |
centeroffsety | Centeroffsety specifies the y-coordinate offset for the spotlight center. |
focusoffsetx | Focusoffsetx specifies the x-coordinate offset for the center of the spotlight's focus. |
focusoffsety | Focusoffsety specifies the y-coordinate offset for the center of the spotlight's focus. |
radius | Radius specifies the length of the radius of the spotlight from the center of the spotlight |
BarSymbol = (Type1,Color1), (Type2,Color2) ...;
Defines the style and color of the bars in a barest. Values specified in this parameter override values set in the DataSets parameter.
The following bar types are supported:
Note that some types may produce unusual results if the graph type is STACK or ROWS. If one of the "Pie" types is selected, the alternate pie color will be extracted from the first element of the ColorTable.
BarValueLabel = ("mode", color, "font name", font size, angle, interiorAlignment);
Defines the label style to be displayed on each group of bars.
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.
BarValueLabelBox = (color,bordertype,borderwidth);
Defines
the label box to be displayed with each group of bars.
The legal values for border type are as follows:
example:(grey,RAISED,3);
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 borderWhen 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.
BarValueLabelStyle = labelposition1,labelposition2 ..., labelpositionN;
Defines where the BarValueLabel text will display for each dataset.
example: BarValueLabelStyle = TOP, MIDDLE, BOTTOM;
Available options for BarValueLabelStyle are:
EXTERNAL | Displays just outside of each bar |
TOP | Displays at the Top of each bar |
MIDDLE | Displays in the Middle of each bar |
BOTTOM | Displays at the Bottom of each bar |
NONE | No bar labels display |
This parameter was introduced in NetCharts 4.0.
BarWidth = Width1,Width2,...WidthN;
Defines the relative width of the bars in a barset as a percentage of available space. Legal values are 1-100. A smaller number results in more space between bars. WidthN defines the Width for DataSetN.
GroupStackLabels = "label1","label2",...;
This parameter is used only for grouped stacked barcharts (GraphType=GROUPSTACK). It defines labels for each stack of data points in a group. If this value is unspecified and ShowGroupStackLabels=ON; the set names defined in the DataSets parameter will be used as the stack labels.
GroupStackSegmentLabels = "label1","label2",...;
This parameter is used only for grouped stacked barcharts (GraphType=GROUPSTACK). It defines labels for each value in a stack of data points at a single tic location. These labels will be displayed in the legend of the chart. GroupStackSegmentLabels may be overridden by the LegendItems parameter.
ShowGroupStackLabels = ON|OFF;
This parameter is used only for grouped stacked barcharts (GraphType=GROUPSTACK). It defines whether stack labels will be drawn at each tic. The default value is OFF
StackLabel = type;
Defines how the default active labels should be generated for each bar in a stacked barchart. The following types are supported:
TOTAL | use the accumulated total for the label (default) |
ITEM | use the individual item value for the label |
StackDisplayOrder = BOTTOMUP|TOPDOWN;
Defines the ordering of legend items in a chart with multiple bar series. The default is BOTTOMUP, which specifies that the legend items will be displayed in the order in which the data sets are specified. For example DataSet1, will appear in the legend first. TOPDOWN is useful when multiple series of bars are stacked and the legend is displayed vertically. In this mode, the stack of legend items will be "stacked" in the same order as the bars in the chart.
StackedBarConnectors = OFF | LINE | FILLED;
StackedBarConnectors defines the bars in a particular series can be connected together with lines. This improves the users ability to track the values of a single series of values across a multiseries stacked barchart. This is valid on for multiseries barcharts or combocharts when GraphType is STACK. The lines are drawn using the drawing attributes specified in the BarBorder parameter. If BarBorder not defined, one pixel solid black lines are drawn.
OFF specifies that no connectors are drawn.
LINE specifies that lines are drawn between the top and bottom of bars in the same series.
FILL specifies that lines are drawn between the top and bottom of bars in the same series and the area between those lines is filled with the bar set color.
ViewPoint = (CARTESIAN,X,Y,Z); ViewPoint = (SPHERICAL,radius,phi,theta);
The view point from which a 3d barchart is rendered. The viewpoint can only be in front, on top, and to the right of the center of the chart.
If the CoordinateSystem is CARTESIAN, then the numeric values that follow are the X, Y and Z coordinates of the viewpoint for the chart. X,Y and Z are relative to size of the chart and must be positive. Setting any of the coordinates to a negative number is the same as setting that coordinate to 0. To look at the front of the chart, set the view point to (0, 0, a). To look at the chart from a 45 degree angle, set the view point to (a, 0, a). The greater a is, the further the camera is from the chart.
If the CoordinateSystem is SPHERICAL, then the numeric values that follow are the radius, angle of elevation (phi) and the angle of rotation (theta).
Radius is the distance the viewpoint is from the center of chart when coordinate system is SPHERICAL. Radius should be specified as a positive integer. The magnitude of the radius is relative to the width and height of the chart.
Phi is the angle of elevation of the viewpoint when coordinate system is SPHERICAL. Phi should be specified as an angle between 0 and 90. 0 is the angle looking directly at the front of the chart. 90 is the angle looking directly down at the top of the chart.
Theta is the angle of rotation of the viewpoint when coordinate system is SPHERICAL. Theta should be specified as an angle between 0 and 90. 0 is the angle looking directly at the front of the chart. 90 is the angle looking directly at the end of the chart.
ZAxisLabels = (ON|OFF, Color, FontName, FontSize, Angle, interiorAlignment);
The drawing style for Z axis labels in a 3D Barchart.
|