Settings Reference
This section contains a list of all settings available for amLine. It also provides their format, default value, and an explanation.
General
This subsection lists general settings that apply to the entire chart.
|
Setting
|
Value format
|
Default value
|
Description
|
|
data_type
|
xml/csv
|
xml
|
The format of the data. This tells the software how to interpret the data it finds.
|
|
type
|
Line, stacked, 100% stacked
|
line
|
The graph type.
|
|
csv_separator
|
Plaintext
|
;
|
The character that will separate columns in a CSV file.
|
|
skip_rows
|
Number
|
0
|
If you are using a CSV file, this setting allows you to skip the first several rows of the file (for example, if it contains metadata).
|
|
font
|
Plaintext
|
Arial
|
|
|
text_size
|
Number
|
11
|
The size of the text that will be displayed in the chart.
|
|
text_color
|
Hex code
|
#000000
|
|
|
decimals_separator
|
Plaintext
|
,
|
The character that will separate the whole digits from the decimal digits in a number.
|
|
thousands_separator
|
Plaintext
|
Empty space
|
The character that will separate each three whole digits in a number (counting right-to-left from the decimal).
|
| digits_after_decimal |
Number |
0 |
If a value has less digits after the decimal separator than this number, zeroes will be added to the end.
For example, if this is set to 2 and you have a value of 15.6, then the viewer will see it as 15.60. This is useful for charts showing prices, etc.
|
|
reload_data_interval
|
Number, in seconds
|
0
|
How often the chart will reload the data. This is useful if your data is updated very often, and you want to show the change in data without reloading the page.
|
|
redraw
|
True/false
|
false
|
If your chart’s width and height is set in percent, and this is set to true, the chart will be resized proportionally when the browser window is resized.
|
|
add_time_stamp
|
True/false
|
False
|
If this is set to true, a timestamp will be added to the chart every time data is loaded. This is useful if you are using dynamic data and the reload_data_interval setting. It is also useful if your data file changes frequently and you want the data to be reloaded every time the viewer reloads the page – otherwise the data might be cached in their browser.
|
|
precision
|
Number
|
2
|
How many decimal places will be shown for values which are calculated by the software. This does not affect the contents of the data file.
|
|
connect
|
True/false
|
False
|
If this is set to true, the graph will continue even through a point above the X-axis for which there is no value. The default is false, and the graph will stop at the previous value, starting again at the next available value.
|
|
hide_bullets_count
|
Number
|
None
|
If there are more graph points than specified here, the bullets will not be shown. This does not affect custom bullets.
|
|
link_target
|
HTML target tag value
|
None – link opens in the same window
|
The target parameter of the bullet URL, if any. The value is the same as the <target=““> tag in HTML. Use “_blank” to open the URL in a new browser window.
|
|
start_on_axis
|
True/false
|
True
|
If this is set to true, the graph will begin from the Y-axis. If this is set to false, the graph will begin in the plot area, half way between the Y-axis and the first X-axis point.
|
|
preloader_on_load
|
True/false
|
False
|
If this is set to true, preloaded data will be shown while data is being reloaded.
|
Background
This subsection lists the settings that determine the chart's background.
|
Setting
|
Value format
|
Default value
|
Description
|
|
color
|
Hex color code
|
#FFFFFF
|
The color of the chart background
|
|
alpha
|
Number, in percent
|
0
|
Background opacity. This applies to the background color.
Set this to 0 if you are using a custom SWF (Flash object) or JPG image as a background. Set it to a higher number if you are using a background color. If this is set to 0, the background color defined in the HTML code snippet is used.
|
|
border_color
|
Hex color code
|
#FFFFFF
|
The color of the chart’s outer border.
|
|
border_alpha
|
Number, in percent
|
0
|
The opacity of the chart’s outer border.
|
|
file
|
Filename
|
None – disabled
|
The name of the SWF or JPG file that will be used as the background image. The file must be placed in the path folder (as set in the HTML; ampie in the original example).
|
Plot_area
This subsection determines the look of the area between the axes – the area where the graphs will be drawn.
|
Setting
|
Value format
|
Default value
|
Description
|
|
color
|
Hex color code
|
#FFFFFF
|
The background color of the plot area.
|
|
alpha
|
Number, in percent
|
0
|
The opacity of the plot area’s background. Change this from 0 to make the plot area background different from the chart background.
|
|
border_color
|
Hex color code
|
#000000
|
The color of the plot area’s borders.
|
|
border_alpha
|
Number, in percent
|
0
|
The opacity of the plot area’s borders.
|
Margins
This subsection determines the size of the plot area margins.
|
Setting
|
Value format
|
Default value
|
Description
|
|
left
|
Number, in pixels
|
60
|
The size of the left margin.
|
|
top
|
Number, in pixels
|
60
|
The size of the top margin.
|
|
right
|
Number, in pixels
|
60
|
The size of the right margin.
|
|
bottom
|
Number, in pixels
|
80
|
The size of the bottom margin.
|
Scroller
This subsection lists settings that control the chart’s scroll bar.
|
Setting
|
Value format
|
Default value
|
Description
|
|
enabled
|
True/false
|
True
|
If this is set to True, the scroll bar will be displayed when the chart is zoomed in.
|
|
y
|
Number, in pixels
|
None (will be displayed above the plot area)
|
The vertical position of the scroll bar, in pixels, counting downwards from the top edge of the chart.
|
|
color
|
Hex color code
|
#DADADA
|
The color of the scroll bar indicator.
|
|
alpha
|
Number, in percent
|
100
|
The opacity of the scroll bar indicator.
|
|
bg_color
|
Hex color code
|
#F0F0F0
|
The color of the scroll bar background.
|
|
bg_alpha
|
Number, in percent
|
100
|
The opacity of the scroll bar background.
|
|
height
|
Number, in pixels
|
10
|
The height of the scroll bar.
|
Grid
This subsection lists settings that control the chart grid. Please note that a chart can have two Y-axes, one on the left and one on the right.
X
This subsection lists settings that control the vertical lines of the grid (intersecting with the X-axis).
|
Setting
|
Value format
|
Default value
|
Description
|
|
enabled
|
True/false
|
True
|
If this is set to true, vertical grid lines will be displayed.
|
|
color
|
Hex color code
|
#000000
|
The color of the grid lines.
|
|
alpha
|
Number, in percent
|
15
|
The opacity of the grid lines.
|
|
dashed
|
True/false
|
False
|
If this is set to true, the grid lines will not be continuous. They will look like a line of dashes (– – – –).
|
|
dash_length
|
Number, in pixels
|
5
|
The length of each dash.
|
|
approx_count
|
Number
|
4
|
The approximate number of gridlines. They will be arranged along the plot area equally, intersecting with X-axis value points.
|
Y_left
This subsection lists settings that control the horizontal lines of the grid (intersecting with the left Y-axis). The grid is only displayed if there is at least one graph with values on the left Y-axis.
|
Setting
|
Value format
|
Default value
|
Description
|
|
enabled
|
True/false
|
True
|
If this is set to true, horizontal grid lines will be displayed.
|
|
color
|
Hex color code
|
#000000
|
The color of the grid lines.
|
|
alpha
|
Number, in percent
|
15
|
The opacity of the grid lines.
|
|
dashed
|
True/false
|
False
|
If this is set to true, the grid lines will not be continuous. They will look like a line of dashes (– – – –).
|
|
dash_length
|
Number, in pixels
|
5
|
The length of each dash.
|
|
approx_count
|
Number
|
10
|
The approximate number of gridlines. They will be arranged along the plot area equally, intersecting with Y-axis value points.
|
Y_right
This subsection lists settings that control the horizontal lines of the grid (intersecting with the right Y-axis). The grid is only displayed if there is at least one graph with values on the right Y-axis.
|
Setting
|
Value format
|
Default value
|
Description
|
|
enabled
|
True/false
|
True
|
If this is set to true, horizontal grid lines will be displayed.
|
|
color
|
Hex color code
|
#000000
|
The color of the grid lines.
|
|
alpha
|
Number, in percent
|
15
|
The opacity of the grid lines.
|
|
dashed
|
True/false
|
False
|
If this is set to true, the grid lines will not be continuous. They will look like a line of dashes (– – – –).
|
|
dash_length
|
Number, in pixels
|
5
|
The length of each dash.
|
|
approx_count
|
Number
|
10
|
The approximate number of gridlines. They will be arranged along the plot area equally, intersecting with Y-axis value points.
|
Values
This subsection lists settings that control the way values are displayed. Please note that a chart can have two Y-axes, one on the left and one on the right.
X
This subsection lists settings that control the X-axis values.
|
Setting
|
Value format
|
Default value
|
Description
|
|
enabled
|
True/false
|
True
|
If this is set to true, X-axis values will be shown.
|
|
rotate
|
Number, in degrees
|
0
|
The angle of rotation for the values. You can rotate them by 90 degrees with no additional requirements.
|
|
frequency
|
Number
|
1
|
The ratio of shown values to X-axis grid lines. 1 means a value will be shown at every grid line; 2 means a value will be shown at every second grid line, etc. The higher the number, the less values will be shown!
|
|
skip_first
|
True/false
|
True
|
If this is set to true, the first value will be skipped.
|
|
skip_last
|
True/false
|
False
|
If this is set to true, the last value will be skipped.
|
|
color
|
Hex color code
|
Same as general settings
|
The color of the text.
|
|
text_size
|
Number
|
Same as general settings
|
The size of the text.
|
| inside |
True/false |
False |
If this is set to true, the values of this axis will be displayed inside the plot area (above the axis). |
Y_left
This subsection lists settings that control the Y-axis values. The axis is only visible if there is at least one graph with values on the left Y-axis.
|
Setting
|
Value format
|
Default value
|
Description
|
|
enabled
|
True/false
|
True
|
If this is set to true, Y-axis values will be shown.
|
|
reverse
|
True/false
|
False
|
If this is set to true, the values will be reversed on the Y-axis – the largest value will be placed closest to the point where the Y and X axes intersect. The graph will be re-plotted accordingly.
|
|
rotate
|
Number, in degrees
|
0
|
The angle of rotation for the values. You can rotate them by 90 degrees with no additional requirements.
|
|
min
|
Number
|
None – calculated automatically based on values
|
The minimum value of the Y-axis. The axis will always start from this value, even if there is no graph point mapped that far.
|
|
max
|
Number
|
None – calculated automatically based on values
|
The maximum value of the Y-axis. The axis will always end at this value, even if there is no graph point mapped that far.
|
|
strict_min_max
|
True/false
|
False
|
If this is set to true, the axis will stay between Min and Max values even if there are graph points beyond those values. The parts of the graph that do not fit will be cropped.
If this is set to false, the Min and Max values will be extended to fit the graph.
|
|
frequency
|
Number
|
1
|
The ratio of shown values to Y-axis grid lines. 1 means a value will be shown at every grid line; 2 means a value will be shown at every second grid line, etc. The higher the number, the less values will be shown!
|
|
skip_first
|
True/false
|
True
|
If this is set to true, the first value will be skipped.
|
|
skip_last
|
True/false
|
False
|
If this is set to true, the last value will be skipped.
|
|
color
|
Hex color code
|
Same as general settings
|
The color of the text.
|
|
text_size
|
Number
|
Same as general settings
|
The size of the text.
|
|
unit
|
Plain text
|
None
|
A short text indicating the units of the values. This can be something like “USD” or “km/h”.
|
|
unit_position
|
Left/right
|
Right
|
Whether the units will be shown to the left of the value or to the right.
|
|
integers_only
|
True/false
|
False
|
If this is set to true, only whole values will be shown. Values with decimals will be hidden.
|
| inside |
True/false |
False |
If this is set to true, the values of this axis will be displayed inside the plot area (to the right of the axis). |
Y_right
This subsection lists settings that control the Y-axis values. The axis is only visible if there is at least one graph with values on the left Y-axis
|
Setting
|
Value format
|
Default value
|
Description
|
|
enabled
|
True/false
|
True
|
If this is set to true, Y-axis values will be shown.
|
|
reverse
|
True/false
|
False
|
If this is set to true, the values will be reversed on the Y-axis – the largest value will be placed closest to the point where the Y and X axes intersect. The graph will be re-plotted accordingly.
|
|
rotate
|
Number, in degrees
|
0
|
The angle of rotation for the values. You can rotate them by 90 degrees with no additional requirements.
If you want to rotate the values by 1 to 89 degrees, you must have the SWF file for that font, placed in the amline/fonts folder.
|
|
min
|
Number
|
None – calculated automatically based on values
|
The minimum value of the Y-axis. The axis will always start from this value, even if there is no graph point mapped that far.
|
|
max
|
Number
|
None – calculated automatically based on values
|
The maximum value of the Y-axis. The axis will always end at this value, even if there is no graph point mapped that far.
|
|
strict_min_max
|
True/false
|
False
|
If this is set to true, the axis will stay between Min and Max values even if there are graph points beyond those values. The parts of the graph that do not fit will be cropped.
If this is set to false, the Min and Max values will be extended to fit the graph.
|
|
frequency
|
Number
|
1
|
The ratio of shown values to Y-axis grid lines. 1 means a value will be shown at every grid line; 2 means a value will be shown at every second grid line, etc. The higher the number, the less values will be shown!
|
|
skip_first
|
True/false
|
False
|
If this is set to true, the first value will be skipped. This is useful if it comes too close to the X-axis.
|
|
skip_last
|
True/false
|
False
|
If this is set to true, the last value will be skipped. This is useful if it comes too close to the Y-axis.
|
|
color
|
Hex color code
|
Same as general settings
|
The color of the text.
|
|
text_size
|
Number
|
Same as general settings
|
The size of the text.
|
|
unit
|
Plain text
|
None
|
A short text indicating the units of the values. This can be something like “USD” or “km/h”.
|
|
unit_position
|
Left/right
|
Right
|
Whether the units will be shown to the left of the value or to the right.
|
|
integers_only
|
True/false
|
False
|
If this is set to true, only whole values will be shown. Values with decimals will be hidden.
|
| inside |
True/false |
False |
If this is set to true, the values of this axis will be displayed inside the plot area (to the left of the axis). |
Axes
This subsection lists settings that control the look of the actual axis lines.
X
This subsection lists settings that control the look of the X-axis.
|
Setting
|
Value format
|
Default value
|
Description
|
|
Color
|
Hex color code
|
#000000
|
The color of the axis line.
|
|
alpha
|
Number, in percent
|
100
|
The opacity of the axis line.
|
|
width
|
Number
|
2
|
The thickness of the axis line. 0 means hairline, but still visible (set alpha=0 for an invisible axis line).
|
|
tick_length
|
Number
|
7
|
The length of the tick extending from the axis at a grid or value point.
|
Y_left
This subsection lists settings that control the look of the left Y-axis. The axis is only visible if there is at least one graph with values on the left Y-axis.
|
Setting
|
Value format
|
Default value
|
Description
|
|
color
|
Hex color code
|
#000000
|
The color of the axis line.
|
|
alpha
|
Number, in percent
|
100
|
The opacity of the axis line.
|
|
width
|
Number
|
2
|
The thickness of the axis line. 0 means hairline, but still visible (set alpha=0 for an invisible axis line).
|
|
tick_length
|
Number
|
7
|
The length of the tick extending from the axis at a grid or value point.
|
Y_right
This subsection lists settings that control the look of the right Y-axis. The axis is only visible if there is at least one graph with values on the right Y-axis.
|
Setting
|
Value format
|
Default value
|
Description
|
|
color
|
Hex color code
|
#000000
|
The color of the axis line.
|
|
alpha
|
Number, in percent
|
100
|
The opacity of the axis line.
|
|
width
|
Number
|
2
|
The thickness of the axis line. 0 means hairline, but still visible (set alpha=0 for an invisible axis line).
|
|
tick_length
|
Number
|
7
|
The length of the tick extending from the axis at a grid or value point.
|
Indicator
This subsection lists the settings that control the indicator. The indicator follows the mouse pointer on the chart. It can consist of text balloons explaining points on the X-axis and the graph, and a vertical grid line.
|
Setting
|
Value format
|
Default value
|
Description
|
|
Enabled
|
True/false
|
True
|
If this is set to false, all indicator functionality will be disabled.
|
|
zoomable
|
True/false
|
True
|
If this is set to true, clicking and dragging across the chart will zoom in on that section of the chart.
|
|
color
|
Hex color code
|
#BBBB00
|
The background color of the vertical grid line and the X-axis balloon.
|
|
line_alpha
|
Number, in percent
|
100
|
The opacity of the vertical grid line.
|
|
selection_color
|
Hex color code
|
#BBBB00
|
The background color of the area selected by clicking and dragging.
|
|
selection_alpha
|
Number, in percent
|
25
|
The opacity of the background of the selected area.
|
|
x_balloon_enabled
|
True/false
|
True
|
If this is set to true, a balloon will mark the indicator’s current position on the X-axis.
|
|
x_balloon_text_color
|
Hex color code
|
Same as general settings
|
The color of the X-axis balloon text.
|
|
y_balloon_text_size
|
Number
|
Same as general settings
|
The size of the Y-axis balloon text.
|
|
y_balloon_on_off
|
True/false
|
True
|
If this is set to true, the viewer will be able to click on the graph, or on the graph title in the legend, and show or hide the balloon for that graph.
|
|
one_y_balloon
|
True/false
|
False
|
If this is set to true, only one graph balloon will be visible at any time. This will be the balloon, and its connecting line, which are currently closest to the mouse pointer.
|
Chart Legend Settings
This subsection lists the settings that control the chart's legend.
Legend
These are the general legend settings.
|
Setting
|
Value format
|
Default value
|
Description
|
|
enabled
|
True/false
|
True
|
If this is set to true, the legend is shown on the chart.
|
|
x
|
Number, in pixels
|
Plot area left margin
|
The horizontal position of the legend’s left edge. The coordinates are counted from the upper left corner.
|
|
y
|
Number, in pixels
|
Right below the pie.
|
The vertical position of the legend’s top edge. The coordinates are counted from the upper left corner. (Coordinates are still positive, though counted downwards.)
|
|
width
|
Number, in pixels
|
Plot area width.
|
The width of the legend. If the legend doesn't fit, try adjusting the margins. |
|
color
|
Hex color code
|
#FFFFFF
|
The color of the legend’s background.
|
|
max_columns
|
Number
|
Fit to width
|
The maximum number of columns in the legend. (All data will be represented, but in several rows if necessary.)
|
|
alpha
|
Number, in percent
|
0
|
The opacity of the legend’s background.
|
|
border_color
|
Hex color code
|
#000000
|
The color of the legend’s borders.
|
|
border_alpha
|
Number, in percent
|
0
|
The opacity of the legend’s borders.
|
|
text_color
|
Hex color code
|
As per general settings
|
The color of the legend’s text.
|
|
text_color_hover
|
Hex color code
|
#BBBB00
|
The color of the legend’s text when the mouse pointer hovers over it.
|
|
text_size
|
Number
|
As per general settings
|
The size of the legend’s text
|
|
spacing
|
Number, in pixels
|
10
|
The space between the rows and columns of the legend.
|
|
margins
|
Number, in pixels
|
0
|
The space between the borders and the contents of the legend. This is useful if the borders are visible, or the legend’s background color is different from the chart’s background color.
|
|
graph_on_off
|
True/false
|
True
|
If this is set to true, the key has a checkbox function – clicking on it will hide or show the corresponding graph.
|
Key
These are the settings for the legend's key.
|
Setting
|
Value format
|
Default value
|
Description
|
|
size
|
Number
|
16
|
The size of the key. The key is displayed in the legend next to the graph title, and is filled with the graph color.
|
|
border_color
|
Hex color code
|
None – no border
|
The color of the key border.
|
|
key_mark_color
|
Hex color code
|
#FFFFFF
|
The color of the check mark in the key. (Only applies if graph_on_off is true.)
|
Values
These are the settings for displaying slice values in the legend.
|
Setting
|
Value format
|
Default value
|
Description
|
|
enabled
|
True/false
|
False
|
If this is set to true, the values will be shown in the legend.
|
|
width
|
Number, in pixels
|
None – fit to contents
|
The width of the text in the legend. This is useful if you want all entries to be right-aligned.
|
|
align
|
Right/left
|
Right
|
The alignment of the text in the legend.
|
|
text
|
Plaintext
|
Value (in tag form)
|
The value of the entry. Tags in curly brackets { } will be replaced with the information taken from the data file.
The following tags are available:
- title
- value
- series
- description
- percents
Please note: if you want to use HTML tags, you must use the format <![CDATA[text]]>
|
Zoom_out_button
This subsection lists the settings that control the zoom out button. This button appears when the viewer has zoomed in on a part of the chart; clicking it takes the viewer back to the full chart view.
|
Setting
|
Value format
|
Default value
|
Description
|
|
x
|
Number, in pixels
|
Right-aligned
|
The horizontal position of the zoom out button.
|
|
y
|
Number, in pixels
|
Top-aligned
|
The vertical position of the zoom out button. The coordinates are counted from the upper left corner. (Coordinates are still positive, though counted downwards.)
|
|
color
|
Hex color code
|
#BBBB00
|
The color of the zoom out button background.
|
|
alpha
|
Number, in percent
|
0
|
The opacity of the zoom out button background.
|
|
text_color
|
Hex color code
|
As per general settings
|
The color of the zoom out button text.
|
|
text_color_hover
|
Hex color code
|
#BBBB00
|
The color of the button’s text when the mouse pointer hovers over it.
|
|
text_size
|
Number
|
Same as general settings
|
The size of the button’s text.
|
|
text
|
Plaintext
|
Show all
|
The text on the button.
|
Help
This subsection lists the settings that control the Help button, and the balloon that appears when the viewer rolls over it.
Button
|
Setting
|
Value format
|
Default value
|
Description
|
|
x
|
Number, in pixels
|
Right-aligned
|
The horizontal position of the help button.
|
|
y
|
Number, in pixels
|
Top-aligned
|
The vertical position of the help button. The coordinates are counted from the upper left corner. (Coordinates are still positive, though counted downwards.)
|
|
color
|
Hex color code
|
#000000
|
The color of the help button background.
|
|
alpha
|
Number, in percent
|
100
|
The opacity of the help button background.
|
|
text_color
|
Hex color code
|
#FFFFFF
|
The color of the help button text.
|
|
text_color_hover
|
Hex color code
|
#BBBB00
|
The color of the button’s text when the mouse pointer hovers over it.
|
|
text_size
|
Number
|
Same as general settings
|
The size of the button’s text.
|
|
text
|
Plaintext
|
?
|
The text on the button.
|
Balloon
|
Setting
|
Value format
|
Default value
|
Description
|
|
color
|
Hex color code
|
#000000
|
The color of the help balloon background.
|
|
alpha
|
Number, in percent
|
100
|
The opacity of the help balloon background.
|
|
width
|
Number, in pixels
|
300
|
The width of the text in the balloon.
|
|
text_color
|
Hex color code
|
#FFFFFF
|
The color of the help balloon text.
|
|
text_size
|
Number
|
Same as general settings
|
The size of the button’s text.
|
|
text
|
Plaintext
|
None
|
The text that will appear when the viewer’s mouse pointer hovers over the button.
Please note: if you want to use HTML tags, you must use the format <![CDATA[text]]> |
Export_as_image
This subsection lists the settings that control the function of saving the chart as an image file.
|
Setting
|
Value format
|
Default value
|
Description
|
|
file
|
Filename
|
None – disabled
|
If you provide a filename, the viewer will be able to save the chart as an image. The option will be available in the right-click menu. The file type is JPG by default – see the article on exporting as image for more information.
|
|
target
|
HTML target tag value
|
None – file opens in the same window
|
The target parameter for opening the image file in the browser. The value is the same as the <target=““> tag in HTML. Use “_blank” to open the URL in a new browser window.
|
|
x
|
Number, in pixels
|
0
|
The horizontal position of the “Collecting data” text. This text will appear while the chart is being exported. The coordinates are counted from the upper left corner.
|
|
y
|
Number, in pixels
|
Bottom-aligned
|
The vertical position of the “Collecting data” text. This text will appear while the chart is being exported. The coordinates are counted from the upper left corner. (Coordinates are still positive, though counted downwards.)
|
|
color
|
Hex color code
|
#BBBB00
|
The color of the “Collecting data” text background.
|
|
alpha
|
Number, in percent
|
0
|
The opacity of the “Collecting data” text background.
|
|
text_color
|
Hex color code
|
As per general settings
|
The color of the “Collecting data” text.
|
|
text_size
|
Number
|
As per general settings
|
The size of the “Collecting data” text.
|
Error_messages
This subsection lists the settings that control error messages in the chart.
|
Setting
|
Value format
|
Default value
|
Description
|
|
enabled
|
True/false
|
True
|
If this is set to true, the settings below will apply to any error message shown by the chart. The only exception is the error message that is shown when the settings file has not been found.
|
|
x
|
Number, in pixels
|
Centered
|
The horizontal position of the error message. The coordinates are counted from the upper left corner.
|
|
y
|
Number, in pixels
|
Centered
|
The vertical position of the error message. The coordinates are counted from the upper left corner. (Coordinates are still positive, though counted downwards.)
|
|
color
|
Hex color code
|
#BBBB00
|
The color of the error message background.
|
|
alpha
|
Number, in percent
|
100
|
The opacity of the error message background.
|
|
text_color
|
Hex color code
|
#FFFFFF
|
The color of the error message text.
|
|
text_size
|
Number
|
As per general settings
|
The size of the error message text.
|
Strings
This subsection contains settings that determine the texts of various messages displayed by the chart.
|
Setting
|
Value format
|
Default value
|
Description
|
|
no_data
|
Plaintext
|
No data for selected period
|
The text that will be displayed if the data for the selected period is missing from the data file.
|
|
export_as_image
|
Plaintext
|
Export as image
|
The text of the image export option in the right-click menu.
|
|
error_in_data_file
|
Plaintext
|
Error in data file
|
The text that will be displayed if the data file is corrupt, or there is no data in the file. (If the data file is not found, or is completely empty, the error message will be “Error loading file”.)
|
|
collecting_data
|
Plaintext
|
Collecting data
|
The text that will be displayed while the chart is being exported to an image file.
|
|
wrong_zoom_value
|
Plaintext
|
Incorrect values
|
This text will be displayed if you have zoomed in through Javascript controls, and the zoom values provided are wrong or missing.
|
Labels
This subsection lists the settings of labels - free bits of text not attached to any slide. You can add multiple labels, each nested inside a <label></label> tag.
|
Setting
|
Value format
|
Default value
|
Description
|
|
x
|
Number, in pixels
|
0
|
The horizontal position of the label. Coordinates are counted from the upper left corner.
|
|
y
|
Number, in pixels
|
0
|
The vertical position of the label. The coordinates are counted from the upper left corner. (Coordinates are still positive, though counted downwards.)
|
|
rotate
|
True/false
|
False
|
If this is set to true, the label is rotated by 90 degrees.
|
|
width
|
Number, in pixels
|
Fit to contents
|
The maximum width of the label. (If the contents exceed the width, the label will have multiple lines.)
|
|
align
|
Left/center/right
|
Left
|
The alignment of the text in the label.
|
|
text_color
|
Hex color code
|
As per general settings
|
The color of the text in the label.
|
|
text_size
|
Number
|
As per general settings
|
The size of the text in the label.
|
|
text
|
Plaintext
|
None
|
The text of the label.
Please note: if you want to use HTML tags, you must use the format <![CDATA[text]]> |
Graphs
If you do not need to use this subsection, or any individual tag, you can delete it.
Graph
This subsection controls each individual graph. You will need a separate graph subsection for each graph you want to control. The gid parameter of the tag must match the same parameter in the data file (if you are using XML data):
<graph gid=”1”>
|
Setting
|
Value format
|
Default value
|
Description
|
|
axis
|
Left/right
|
Left
|
Where the Y-axis will be shown on the chart. It can be either on the right or on the left side.
|
|
title
|
Plaintext
|
None
|
The title of the graph. This is important for the legend.
|
|
color
|
Hex color code
|
One of the following:
#FF0000,
#0000FF,
#00FF00,
#FF9900,
#CC00CC,
#00CCCC, #33FF00,
#990000, #000066
|
The graph color. If there is no value for the parameter, then the software will choose the next unused color from the default array.
|
|
color_hover
|
Hex color code
|
#BBBB00
|
The color of the graph when the mouse pointer hovers over it.
|
|
line_alpha
|
Number, in percent
|
100
|
The opacity of the graph line.
|
|
line_width
|
Number
|
0
|
The width of the graph line. 0 means hairline, but still visible (set alpha=0 for an invisible graph line).
|
|
fill_alpha
|
Number, in percent
|
0
|
The opacity of the area fill. If you want to have an area chart, not just a graph, then set this parameter to higher than 0. The area below the graph line will be filled with a color. (The filled area extends down to the next graph line, or to the X-axis, whichever is closest.)
|
|
fill_color
|
Hex color code
|
Same as graph line color
|
The color of the filled area.
|
|
balloon_color
|
Hex color code
|
Same as graph line color
|
The color of the graph point balloon.
|
|
balloon_alpha
|
Number, in percent
|
100
|
The opacity of the graph point balloon.
|
|
balloon_text_color
|
Hex color code
|
#FFFFFF
|
The color of the text in the graph point balloon.
|
|
bullet
|
Text
|
None (no bullets)
|
The shape of the bullet that marks each graph point. The following values are available:
- square
- round
- square_outlined
- round_outlined
- filename.swf
The latter is the name of Shockwave Flash file – you can use a custom Flash object as a bullet. The Flash file must be placed in the folder specified as amline_path in the HTML code snippet.
Outlined bullets use the plot area color for the outline.
|
|
bullet_size
|
Number
|
6
|
The size of the bullet. This only affects predefined bullet shapes, not custom Flash bullets.
|
|
bullet_color
|
Hex color code
|
Same as graph line color
|
The color of the bullet. This only affects predefined bullet shapes, not custom Flash bullets.
|
|
bullet_alpha
|
Number, in percent
|
Same as graph line alpha
|
The opacity of the bullet. This only affects predefined bullet shapes, not custom Flash bullets.
|
|
hidden
|
True/false
|
False
|
If this is set to true, the graph will not be visible unless the viewer has checked the corresponding box in the legend.
|
|
selected
|
True/false
|
True
|
If this is set to true, the graph point balloon for this graph will be visible as the mouse pointer rolls across the plot area.
|
|
balloon_text
|
Plaintext
|
<b></b>
<br>
|
The text in the graph point balloon. Tags in curly brackets { } will be replaced with the information taken from the data file.
The following tags are available:
- title
- value
- series
- description
- percents
Pl | |