Chart
Draws a chart. Its appearance and data are set with UI Attributes. More than one set of values can be specified.
Parameters
- id: the object's ID, used by UISets. Required
- position: the object's position. Use the pixels or rows and columns coordinates format
- size: the chart's area's width and height
- attributes: list of UI attribute ids and values defining the chart's aspect and data. Setting this parameter is the same as setting each UI attribute with a UISet
Syntax
(chart!<id> <address>; <position>; <width>; <height>; <attributes>)
E.g.
(chart!chart1 x3y187; 312; 180; (type=line; values=0,10,24,12,7,35,42,1,23,4))
UI Attributes
Chart attributes
Name | Value | Description | |||
---|---|---|---|---|---|
type | bars | Draw bars | |||
gauge | Draw a gauge, for charts with a single value. Use with the "value" attribute | ||||
points | Draws points | ||||
line | Draws a line connecting the values | ||||
spline | Draws a spline connecting the values | ||||
orientation | vertical | Default value. Draws a vertical chart | |||
horizontal | Draws an horizontal chart | ||||
value | single value | Value to be drawn. To be used when "type" is gauge | |||
value[n] | Same as "value", but refers to a specific set of values | ||||
values | comma-separated list of values | Values to be drawn. E.g. 2,3,1.2,4 | |||
comma-separated list of arrays | Sets of values to be drawn. E.g. [2,3,1.2,4],[4,1,0,0.2] | ||||
values[n] | Same as "values", but refers to a specific set of values | ||||
valuerange | [min],[max] | Range of values displayed. E.g. -2,10 | |||
axislabels | auto | Default. Labels on the x axis (if vertical) or y axis (if horizontal) will go from 1 to the total number of values. | |||
none | No label is shown on the x axis (if vertical) or y axis (if horizontal) | ||||
comma-separated list of values | Custom labels on the x axis (if vertical) or y axis (if horizontal) | ||||
valuelabeltype | inside | Value labels are shown inside (if "type" is bars, points or gauge) or over (if "type" is line or spline) | |||
outside | Value labels are shown above or below | ||||
popup | Value labels are shown on mouseover, or on touch (if on a touch-enabled device) | ||||
valuelabels | comma-separated list of values | Custom values to show in value labels | |||
valuelabels[n] | Same as "valuelabels", but refers to a specific set of values | ||||
spacing | 0-100 | Percentage of spacing between bars or points | spacing[n] | Same as "spacing", but refers to a specific set of values | |
offset[n] | percentage | Percentage of value offset. Used to shift a specific set on the x axis if vertical, or on the y axis if horizontal. Used to show background sets. E.g. "offset[0]=-20; offset[1]=20" | |||
drawaxis | true | Default. The axes are visible (also notches and labels) | |||
false | The axes are not visible (also notches and labels) | ||||
axisoffset | percentage | The axis offset (y if vertical, x if horizontal) expressed as percentage or as the value series index. E.g. "50%" or "3" | |||
origin | |||||
notches | |||||
pointsize | |||||
bgcolor | |||||
valuecolor | |||||
valuecolor[n] | |||||
valuecolors | |||||
valuecolors[n] | |||||
barshadow | |||||
barborder | |||||
axiscolor | |||||
notchcolor | |||||
labelcolor | |||||
valuelabelcolor | |||||
thresholds | |||||
thresholds[n] | |||||
thresholdcolor | |||||
thresholdcolors | |||||
stroke | |||||
stroke[n] |