ChartGL
This page describes the configuration and use of the ChartGL component, which enables you to visualize very large datasets.
ChartGL uses WebGL to access the graphics hardware on the local computer accelerating the rendering process by a factor of many thousand. In WebGL2 a combination of vertex shaders (position) and fragment shaders (color) are used to render data points providing the capability to display millions of data points in milliseconds.
Multiple large data sources can be plotted on the same chart with high speed and performance using layers. The following screenshot shows an example of historic FX data plotted using four layers.
Note
Overcoming browser WebGL limits
Each ChartGL uses its own WebGL context. Browsers limit the number of active WebGL contexts, so when this limit is reached, charts can fail to load. To combat this issue we recommend adding ChartGL components to the Layout Panel component and setting Enable WebGL Context for the layout panel. When this is enabled, every ChartGL, that is added directly to the Layout Panel, shares a single WebGL context, meaning the user can have an unlimited number of charts.
This page provides information on the following:
Set up a ChartGL component
To set up a ChartGL component, click and drag the component into the workspace and configure the following:
-
Click to populate Data Source or select a Data Source from the Layers properties to open the Data dialog. Click New and proceed with configuring the Data Source.
ChartGL best fits your data to the chart using a wild card selector in Y-Axis Data. Otherwise, select your data to plot for X-Axis Data and Y-Axis Data in the Layers properties. Alternatively, format your axes in the relevant properties for each; x-axis and y-axis
-
Next define the properties as defined in the following sections.
ChartGL properties
The following sections provides details on how to configure the properties of the ChartGL component.
Basics
Open the Basics properties on the right and configure the properties described in the following table.
Property |
Description |
---|---|
Name |
Enter a name for the component. |
Hover |
Enter a View State Parameter which stores the x-axis value contingent on where the hover bar is on the chart. For example time or date. |
Selected |
Enter a View State Parameter to store the x-axis value at the selected position. For example time or date. |
Selected First Point |
Use this option to allow for the first time in the first layer to be selected when the chart loads.
|
Range Selection |
When this is enabled the user can click and drag on a chart as normal, but instead of zooming, it stores the x-axis range values. The values can be accessed by assigning view states to the Selection Min & Selection Max properties on the x-axes. It turns the chart into a selector that stores the values in the x-axis Selection Min and Selection Max view state properties.
When this is checked, it overrides the Zoom checkbox. If both are left unchecked, the chart does not zoom or use the range selection. |
Zoom |
Check to enable/disable zoom. This feature makes it possible to zoom on a region within both x and y axis, or individually on each x or y axis. Double-Clicking the chart resets the chart to its initial state.
Mouse scroll can be used for x-axis zoom, with mouse scroll + shift key for y-axis zoom. |
Animation Duration |
Define the zoom animation and length of time in milliseconds to complete. |
Animation Easing |
This drop-down list of options are used to control how the zoom animation transitions. For example bounce creates a spring like effect. There are a number of options for you to try. |
The Pan feature lets you pan along one axis at a time. To pan, click and drag from anywhere on the axis. Double-clicking the chart resets the chart to its initial state.
|
|
Track Load Time |
Enable this to set the Load Time (ms) value. |
Load Time (ms) |
Use this to set a View State Parameter used to track the load time of the chart, in milliseconds, on each update of the data. This is useful for tracking the performance of the chart to see how long it takes to load. When Track Load Time is checked, and Load Time (ms) has a view state set, it writes the time in ms into the view state. This view state value can then be displayed in a text component, as shown in the Chart Load Time on the following chart.
|
This can be used to improve accessibility and visual distinction by adding patterns to bars.
The following illustrates how adding patterns to bars make it easier for someone with deuteranomaly to distinguish the individual bars in the chart.
|
Layers
Layers provide the ability to display multiple different data sources on the same chart. In the following example four layers have been defined; Candlestick
, Bar
, Line
, and Bubble
.
To add a Layer, click Layers and Layer 1 to open the properties for the first layer.
Select a layer type from the dropdown. The properties displayed vary depending on the option selected. Click on the relevant tab, in the note section below, to view the properties for each type of layer.
Bubble
Line
Bar
Waterfall
Bounds
Candlestick
Heatmap
Baseline
Bubble layers display data as individual points.
Define the following
Line layers connect each data point resulting in a continuous line.
Define the following properties:
Bar layers display data as bars.
Define the following properties:
Waterfall layers display data as increase and decrease bars.
Define the following properties:
Bounds layers draw a bounding area between two points.
Define the following properties:
Candlestick layers display data as candlesticks.
Define the following properties:
Heatmap layers draw a heatmap chart.
Define the following properties:
Baseline layers draw a line at a single point.
Define the following properties:
General layer properties
The following properties are relevant to all layer types, unless otherwise stated.
Property |
Description |
---|---|
Data Source |
Specify the Data sources to be used for the layer. This is not relevant to Baseline layers as they use Baseline Value/Baseline Axis to specify where the Baseline is drawn. |
Name |
Enter a name for the chart legend label. |
X-Axis |
Select the x-axis from the defined Axes. |
Y-Axis |
Select the y-axis from the defined Axes. |
X-Axis Data |
Select data columns to plot X-Axis data from the data source. |
Y Axis Data |
Select data columns to plot Y Axis data from the data source. Y Axis includes a wildcard selection (*) for multiple columns. Wildcard selection uses columns of the most common, single kdb type. For example, if a data set has one Regular expressions can also be used to define the y-axis. When a wildcard or regular expression is used, the Color Palette defines point color for each added column.The following kdb data types are supported; byte, char, date, datetime, float, int, long, minute, month, real, second, short, string, symbol, time, timespan, and timestamp. |
Multi X-Axis |
Add multiple x-axis groups by selecting one or more columns to populate the multiple x-axes, without affecting the datapoints shown. Each column is a separate x-axis, grouping values together. You can format the axis settings on the layer's linked x-axis under Multi Axis Format. An example of multi x-axis groups is shown in the below image. This displays two charts, the top one showing 2 levels of multi axis grouping, and the bottom showing 3 levels. For the bottom chart, the x-axis is populated with the column
The below query is used in the above example:
|
Open/High/Low/Close |
These properties only relate to Candlestick layers. Select the data columns that correspond to the open, high, low, and close price points. |
X1 Coordinate |
This is only relevant for Heatmap layers. Select the data column that corresponds to the X1 coordinate. |
X2 Coordinate |
This is only relevant for Heatmap layers. Select the data column that corresponds to the X2 coordinate. |
Y1 Coordinate |
This is only relevant for Heatmap layers. Select the data column that corresponds to the Y1 coordinate. |
Y2 Coordinate |
This is only relevant for Heatmap layers. Select the data column that corresponds to the Y2 coordinate. |
Score |
This is only relevant for Heatmap layers. Select the data columns that correspond to each. Colors are defined by the Score column, which uses the Color Palette. |
Color |
Select color for single plot (non-wildcard/regex) data sets. |
Opacity |
Define the opacity of the points from a value between 0 (transparent) and 100 (opaque). |
Bar Percentage |
This is only relevant for Bar layers and defines the bar width as a percentage of its range when Bar Percentage is selected from Bar Width Type. |
Bar Fixed Width |
This is only relevant for Bar layers. It defines the bar width as a fixed value when Fixed Width is selected from Bar Width Type. |
Bar Width Type |
This is only relevant for Bar layers. Use the dropdown to select either Bar Percentage and Fixed Width. |
Bar Orientation |
This is only relevant for Bar layers. Use the dropdown to select either Vertical and Horizontal. |
Bar Increase Color |
This is only relevant for Bar layers and is used when the layer type is Waterfall to define the visual style of the Waterfall bar increase colors based on the previous bar value. |
Bar Decrease Color |
This is only relevant for Bar layers and is used when the layer type is Waterfall to define the visual style of the Waterfall bar decrease colors based on the previous bar value. |
x1 |
This is used, when the layer type is Bounds, to define the x1 coordinates of the bounding region. |
x2 |
This is used, when the layer type is Bounds, to define the x2 coordinates of the bounding region. |
Baseline Axis |
This is used when, the layer type is Baseline, to define the axis at which to draw the baseline, based on the Baseline Value. |
Baseline Value |
This is used, when the layer type is Baseline, to define the value at which to draw the baseline. The axis on which this is draw in set in Baseline Axis. This is used in place of a Data Source.
|
Use this dropdown to assign the layer legend to a Legend Group |
|
Legend Color by Column |
Select a data column to apply color. When a column is selected, the Color Palette defines point color for each unique value in the column. This is not applicable to Baseline layers. |
Show Current Tick Label |
Enable this to display the last tick in the series on the y-axis. |
Cache Streaming Data |
Enable this when using streaming data to improve performance by caching data. |
Legend Enabled |
Use this to toggle the display of the data legend. |
Enabled |
Use this to toggle the display of the data layer on the chart and can be tied to a view state parameter. |
Bubbles
The following additional properties are configurable when the layer type is Bubble
or Line
.
Property |
Description |
---|---|
Radius Data |
This dropdown gives options to set the variable point size for the bubbles. Select either Fixed Size or one of the columns from the associated data source. |
Radius Scaling |
Define the bubble size. |
Scale on Zoom |
Increase the bubble size on zoom. |
Icon |
Use the icon selector to choose an icon to be displayed in the position of the data points on the chart.
Icons also support a base64 image in a view state parameter.
|
Color |
Set the color of bubbles when using a Line layer |
Opacity |
Set opacity of bubbles when using a Line layer |
Candlestick
The following additional properties are configurable when the layer type is Candlestick
.
Property |
Description |
---|---|
Bear Color |
Set the color for down day candles. |
Bull Color |
Set the color for up day candles. |
Neutral Color |
Set the color for flat days. |
Bar Percentage |
Define the candlestick body width as a percentage of its range when Bar Percentage is selected under Bar Width Type. |
Bar Fixed Width |
Define the candlestick body width as a fixed value when Fixed Width is selected under Bar Width Type. |
Bar Width Type |
Use the dropdown to select either Bar Percentage and Fixed Width. |
Bar Orientation |
Use the dropdown to select either Vertical or Horizontal. |
Line
The following additional properties are configurable when the layer type is Line
.
Property |
Description |
---|---|
Line Width |
Set the thickness of the line. |
Line Style |
Choose between None, Dashed, Dotted. |
Dash Gap |
When Line Style is Dotted or Dashed, set the size of the gaps. |
Dash Width |
When Line Style is Dashed, set the width of the dashes. |
Fill |
Select a fill option: No Fill - No color fill Layer n - For color fill between the charted line and the selected layer. This option is only shown if there is more than one layer. Origin - For color fill between the chart line and X-axis |
Fill Color |
The color to be used for line fill for single plot (non-wildcard/regex) data sets. |
Fill Opacity |
The opacity used for line fill. |
Fade to Transparent |
Where a line fill color is employed, a transparency gradient is applied to the layer. |
Span Gaps |
Where there is missing data, check this to connect isolated points. |
Palette Theme |
Define the Palette Theme for the Fill Palette |
Fill Palette
This sets the line fill colors for wildcard/regex y-axis or Legend Color by Column. See Palette for further details.
Interpolation
Interpolation lets you estimate a value between two known values explicitly stated in a line graph. You can specify the following interpolation properties.
Property |
Description |
---|---|
Interpolation |
Choose between the following types of interpolation:
|
Stepped Line |
Use this to switch between stepped line chart types; |
Curvature |
Set the level of curve to use for |
Color Palette
The Color Palette sets plot point colors for wildcard/regex y-axis or Legend Color by Column. See Palettes for further details.
Actions
See Actions for full details.
Highlight rules
See Highlight Rules for full details.
Labels
Data labels can be added to any layers. They are placed next to datapoints/bars as desired.
The label properties are described in the following table.
Property |
Description |
---|---|
Enabled |
Turn on or off data labels. This can be tied to a view state. |
Label Color |
Set the color of the Label text. |
Label Freq |
Labels are applied to every nth data point where n is value set here. |
Align |
Choose the position label; top, bottom, left, right, or center of the data point. |
Offset |
The offset represents the distance (in pixels) to pull the label away from the data point. This can be specified as a single number (for example 4) or an x,y coordinate (for example 4,10). |
Rotation |
Set the clockwise rotation angle (in degrees) of the label with the rotation center point being the label center. The default value is 0 (no rotation) |
Max Label Quantity |
The max number of labels to draw. The default value is 10. |
Label Template |
Define the data to display. This must return a string; HTML is not supported. Select the data to display with the Template Editor in either Basic or Advanced mode. Existing data and view states can be displayed. Handlebar helpers can be used for formats.
|
Font |
Set the font settings: Bold - check to make the label bold Size - adjust the font size in pixels. |
X-Axes
ChartGL supports multiple X-axes. This is useful if you want, for example, to compare different scales, overlay data series, represent different time zones or different geographic coordinates. There is no limit on the number of x-axes that can be added.
The following screenshot shows a ChartGL with 3 x-axes defined; 2 on the bottom of the chart and one on top.
For each x-axis you can define the following properties:
X-Axis General Properties
The general x-axis properties are described in the following table.
Property |
Description |
---|---|
X-Axis Type |
Choose between, |
Position |
Select whether you want to position the axis to the |
Height |
Set the height of the tick area of the x-axis in pixels. |
Tick Spacing |
When the X-Axis Type is set to The next field displayed depends on the option selected. |
Number of Ticks |
Set the number of ticks to display in the axis. The default is 10. |
Fixed Tick Interval (ms) |
Set the interval between ticks in milliseconds. For example an interval of 1800000 results in 30 min tick intervals on the x-axis.
|
Color |
Select the color of the axis. |
Filter Unique |
Displayed when the Axis Type is set to Category. When using non-linear data (string/symbol), some values may be the same. Filter unique is used for grouping same values together. For example, a data source might have 'b' and 'b' in it twice. If filter unique is enabled it groups points for 'b' as having the same x-axis value. If disabled it shows values at different points. In the following example the ChartGL named Layer1 has Filter Unique ticked and so only shows unique values. The second chart hasn't been set to Filter Unique and so the same value is displayed more than once.
|
Sort |
Displayed when the Axis Type is set to Category. When checked, the axis data is sorted. Strings are sorted alphabetically. This is unchecked by default. |
Stacked |
When using a Bar Chart, check this to have the bars stacked. |
X-Axis Range
The x-axis range properties are described in the following table.
Property |
Description |
---|---|
Use Min/Max |
Enable the use of Min and Max to build the x-axis. If these are unchecked the Min and Max values, set below, are ignored. |
Min |
Define the minimum value for the x-axis. |
Max |
Define the maximum values for the x-axis. Charted data outside of the set Min and Max range is not displayed. If all data falls outside the set range, the chart is blank. |
Selection Min |
Pull min x-axis values on a zoom select into the assigned view state parameters. |
Selection Max |
Pull max x-axis values on a zoom select into the assigned view state parameters. |
X-Axis Gridlines
The x-axis gridline properties are described in the following table.
Property |
Description |
---|---|
Offset GridLines |
Enable to align x-axis grid lines to the mid-point between tick values. |
GridLines Color |
Define the color of x-axis grid lines. |
GridLines Opacity |
Define the opacity (0 (transparent) to 100 (opaque)) of x-axis grid lines. |
X-Axis Format
The x-axis format properties are described in the following table.
Property |
Description |
---|---|
Display |
Toggles the display of x-axis. |
Rotation |
Set the clockwise rotation angle (in degrees) of the label. The default value is 0 (no rotation) |
Begin at Zero |
When enabled, the axis data starts at zero. |
Hide Trailing Zeroes |
Hides the display of trailing zeroes in x-axis tick values. |
Numeric Format |
Sets the x-axis format as either |
Date/Time Format |
Select the x-axis date/time format from the options in the drop-down list, including; |
Decimal Places |
Sets the precision point for x-axis numeric labels. |
Font Size |
Sets the tick font size in pixels. |
Prefix |
Adds text to the start of tick label; for example currency or percentage symbol. |
Suffix |
Adds text to the end tick label; for example currency or percentage symbol. |
Distribution |
Distribution, Break, and Trigger Break fields are all related and are only displayed when the X-Axis Type is set to Time. They are used when a chart, with time related data, has a break in the data, for example over a weekend when no new data comes in. This setting is used to shorten the length of the display of this empty data so there isn't a big gap shown. The options are Linear or Smart. If linear is chosen it remains as is. If Smart is selected the following two properties are used. |
Break |
When Distribution is set to |
TriggerBreak |
When Distribution is set to |
Show Major Units |
Used when the X-Axis Type is set to |
If the layer has Multi X-Axis set, customize the Rotation, Font Size, Prefix and Suffix for each axis. |
X-Axis Title
The x-axis title properties are described in the following table.
Property |
Description |
---|---|
Display |
Enables the display of the x-axis label. |
Label String |
Defines x-axes label text. |
Font Size |
Sets the label font size in pixels. |
Y-Axes
ChartGL supports multiple Y-axes. This is useful when you are dealing with data that varies significantly in value ranges. Multi-axes charts allow you to plot multiple data sets with different units. You can either create separate y-axes for each scale or include multiple series on the same scale. There is no limit on the number of y-axes that can be added.
The following screenshot shows a ChartGL with 2 y-axes defined; one on the left and one on the right.
For each y-axis you can define the following properties:
Y-Axis General Properties
Set the general y-axis properties described in the following table.
Property |
Description |
---|---|
Y-Axis Type |
Choose between |
Position |
Set the position of the axis to the |
Height |
Sets the width of the tick area of the y-axis in pixels. |
Tick Spacing |
When the Y-Axis Type is set to The next field displayed depends on the option selected. |
Number of Ticks |
Set the number of ticks to display in the axis. The default is 10. |
Fixed Tick Interval (ms) |
Set the interval between ticks in milliseconds. For example an interval of 1800000 results in 30 min tick intervals on the y-axis.
|
Color |
Select the color of the axis. |
Filter Unique |
Displayed when the Axis Type is set to Category. When using non-linear data (string/symbol), some values may be the same. Filter unique is used for grouping same values together. For example a data source might have 'b' and 'b' in it twice. If filter unique is enabled it groups points for 'b' as having the same y-axis value. If disabled it shows values at different points.
In the following example the ChartGL named Layer1 has
|
Sort |
Displayed when the Axis Type is set to Category. When enabled, sorts the data. If using strings, sort alphabetically. |
Stacked |
When using a Bar chart, check this to have the bars stacked. |
Y-Axis Range
Configure the following y-axis range properties.
Property |
Description |
---|---|
Use Min/Max |
Enables the use of Min and Max to build y-axis. |
Min |
Defines the minimum value for the y-axis. |
Max |
Defines the maximum values for the y-axis. Charted data outside of the set Min and Max range is not displayed. If all data falls outside the set range, the chart is blank. |
Selection Min |
Pulls min y-axis values on a zoom select into assigned view state parameters. |
Selection Max |
Pulls max y-axis values on a zoom select into assigned view state parameters. |
Y-Axis Gridlines
Configure the following y-axis gridlines properties.
Property |
Description |
---|---|
Offset GridLines |
Enables the alignment of y-axis grid lines to the mid-point between tick values. |
GridLines Color |
Defines the color of y-axis grid lines. |
GridLines Opacity |
Defines the opacity for y-axis grid lines. The range is between 0 (transparent) and 100 (opaque). |
Y-Axis Format
Configure the following y-axis format properties.
Property |
Description |
---|---|
Display |
Toggles the display of y-axis. |
Rotation |
Set the clockwise rotation angle (in degrees) of the label. The default value is 0 (no rotation) |
Begin at Zero |
When enabled, the axis data starts at zero. |
Hide Trailing Zeroes |
Hides the display of trailing zeroes in y-axis tick values. |
Numeric Format |
Sets the y-axis format as either |
Decimal Places |
Sets the precision point for y-axis numeric labels. |
Font Size |
Sets the tick font size in pixels. |
Prefix |
Adds text to the start of tick label; for example currency or percentage symbol. |
Suffix |
Adds text to the end tick label; for example currency or percentage symbol. |
Distribution |
Distribution, Break, and Trigger Break are all related and are only displayed when the Y-Axis Type is set to
The options are: |
Break |
This defines the duration of time in milliseconds at which to break at. That is, the space in ms between the two data points you want to shorten: pointB - pointA. |
TriggerBreak |
This defines the new duration, in milliseconds from the start point; newPointB = pointA + Trigger Break (ms). |
Show Major Units |
Used when the Y-Axis Type is set to |
Y-Axis Title
The y-axis title properties are described in the following table.
Property |
Description |
---|---|
Display |
Check to enable the display of y-axis label. |
Label String |
Defines the y-axis label text. |
Font Size |
Sets the label font size in pixels. |
Overlay
The Overlay properties define elements that are drawn on top of the chart on hover. This includes tooltips, crosshairs, and coordinates. In the following example, the mouse is hovering on the chart and shows all 3 of these elements.
-
The tooltip contains the x and y data from the hovered point.
-
The crosshair shows a horizontal and vertical dashed line on the current data position.
-
The coordinates are on the x and y axes, showing the respective current hovered value at its position on the axis.
The Overlay properties, shown in the following screenshot are defined in the table below.
Property |
Description |
---|---|
Show Crosshairs |
When this is checked crosshairs are shown on the chart. |
Show Coordinates |
When this is checked coordinates are shown on chart. |
Snap Crosshair to Data |
When this is checked crosshairs and coordinates move to the nearest valid point on hover. |
Use custom tooltip |
When this is checked the Custom tooltip is enabled. |
Custom tooltip |
Defines a custom tooltip. See Custom tooltips for details. |
Show all layers |
When checked, shows all layers in the tooltip. Otherwise, only shows the hovered layer. |
Show all data points |
Displays all y-axis values for selected point on the x-axis. |
Group tooltip by layer |
When Show all data points is enabled this displays data points in a distinct column for each Layer instead of a continuous list. |
Legend
You can add legends to represent different data series or categories within the chart. These can be grouped into legend groups which are collections of legend entries that share common properties or characteristics.
The Legend properties are described in the following table.
Property |
Description |
---|---|
Position |
The chart legend position can be defined as |
Legend Groups
These properties are used to define legend groups.
Property |
Description |
---|---|
Name |
Defines a name for the Legend Group. This value is added to the list displayed under Legend Group in the general layer properties. |
Expanded |
Expands/collapses the Legend Group. |
Icon |
Defines the icon used for the Legend Group. |
Annotations
When enabled, Annotations allow users to define shapes or markings that provide additional information about specific data points or trends to help clarify or emphasize their significance. The annotation properties are defined in the following table.
Property |
Description |
---|---|
Show Annotate Controls |
Check this to display the Annotate controls on the component
|
Annotations |
This field stores any changes to the default annotation type and color, and information describing the annotations. When set to a view state parameter of type |
Annotations dialog
Click Edit to bring up the annotations dialog.
The Annotation Settings section is where the user can view and change the default annotation type and color.
Property |
Description |
---|---|
Annotation type |
Sets the type of annotation. |
Annotation color |
Sets the color of the annotation to be created. Click on the field to bring up the color picker. The Edit section contains a table of existing annotations each with a color button to change its color and a delete button to delete the specified annotation. The text note has an additional Edit button which brings up the text note dialog to update the text and styling of the text note. Changes made here appear on the chart in real-time. |
Delete All |
Deletes all annotations. |
OK |
Commits all changes in the dialog. |
Cancel |
Reverts all annotations to their previous state. |
Annotation Types
The following table lists the different annotation types, available in the annotations dialog and how the Annotate toggle button appears for each type.
Annotation type |
Button |
Description |
---|---|---|
Text note |
|
This is the default type. A text note is text that can be added directly to the chart. Upon creation of the text note, the text note dialog is launched so users can edit the text and styling of the text note. To edit, double-click on the text note to bring up the text note dialog. The text note resizes automatically based on the text and styling. The font size of the text note does not scale when the chart is zoomed in or out. To move the text note, hover over it until the mouse pointer changes to the multidirectional cursor, then click and drag it to the new position. |
Rectangle |
|
A rectangle is a 4-sided polygon having all right angles. To move the rectangle, hover over the rectangle until the mouse pointer changes to the multidirectional cursor, then click and drag the rectangle to the new position. To resize the rectangle, hover over any endpoint until the color of the square anchor changes to red |
Horizontal line |
|
A horizontal line is a line that extends the width of the chart. Horizontal lines can only be moved up or down. To move the horizontal line, hover over the line until the mouse pointer changes to a bidirectional cursor, then click and drag the line to its new position. |
Vertical line |
|
A vertical line is a line extends the height of the chart. Vertical lines can only be moved left or right. To move the vertical line, hover over the line until the mouse pointer changes to a bidirectional cursor, then click and drag the line to its new position. |
Trend line |
|
A trend line is a straight line connected by two points. To move the trend line, hover over the trend line until the mouse pointer changes to the multidirectional cursor, then click and drag the line to the new position. To resize the trend line, hover over either end of the line until the color of the square anchor changes to red |
Text Note dialog
When the Annotation Type is set to Text Note
the Text Note dialog is used to update the text and styling of the text note. Changes made to the annotation properties appears on the chart in real-time.
Property |
Description |
---|---|
Text |
The text to be displayed in the note. |
Text color |
A color picker used to set the color for the text. |
Font size |
The font size of the text. |
Bold |
When checked, the text is bold. |
Text margin |
Sets the space between the text note border and the text. |
Fill color |
Sets the fill color of the text note area. Click on the field to bring up the color picker. |
Fill opacity |
Sets the fill opacity of the text note area. Slide to the left for more transparency and to the right for more opacity. |
Border thickness |
Sets the thickness of the text note border. |
Border color |
Sets the border color of the text note. Click on the field to bring up the color picker. |
Border opacity |
Sets the border opacity of the text note. Slide to the left for more transparency and to the right for more opacity. |
Anchor position |
Sets the anchor position which identifies the corner of the text note that remains fixed on the chart. This property is particularly useful when you want the text note to always be positioned above or below an element when zooming in or out. Select |
Creating annotations
Clicking Annotate on a chart toggles the Annotation mode. When Annotation mode is on, the Overlay and Zoom features are disabled, and an icon appears to the left of the control to indicate the current annotation type and color.
To create an annotation, click and hold the left mouse button on a desired area in the chart, drag the mouse to an endpoint for the annotation, and release the button. The following example shows a text note being added as an annotation.
Undo and Redo
The Undo and Redo buttons allow the user to navigate through the chronology of user actions affecting all annotations.
Clicking Undo reverses a user action affecting annotations. This includes changes made on the chart directly, or by way of the annotation dialogs. Continuing to press the Undo button reverses these user actions up to the beginning of their dashboard session.
Clicking Redo restores annotations affected by a user clicking the Undo button. If the user performs an action affecting annotations after an Undo button press, the Redo button is disabled.
Style, Margins, Format
See Style for full details of common settings.
File export
See Export for full details of common settings.