Chart renderer is responsible for representing individual dataset items on chart's plot.
All chart renderer types provide support for the following common features:
| 1) | Colors, line styles and shapes for each series: |
| a) | Paint |
| b) | Fill paint |
| c) | Outline paint |
| d) | Stroke |
| e) | Outline stroke |
| f) | Shape |
| 2) | Series visibility |
| 3) | Series in legend visibility |
| 4) | Item labels |
| a) | Visibility |
| b) | Font |
| c) | Paint |
| d) | Positive item label positions |
| e) | Negative item label positions |
Per Series Property Mechanism
Many renderer properties need to have a value defined for each series in the dataset that is assigned to the renderer. In addition to the per-series properties, typically there is a default (or "base") property value, that will be used in the event that no property value is defined for a particular series.
Setting Series Colors
Renderers are responsible for drawing the data items within a plot, so they provide properties for controlling the colors that will be used. Colors are typically defined on a "per series" basis, and stored in a lookup table.
There is a default mechanism to automatically populate the lookup table with default colors. However, you can manually update the the list at any time.
Basic Properties
Renderer Type
Type of renderer to use for the chart.
Property name: rendererType
Property type: Integer
Default Series Properties
Default Series Visibility
The default visibility for all series.
Property name: baseSeriesVisible
Property type: Boolean
Default Series Visibility In Legend
The default legend visibility for all series.
Property name: baseSeriesVisibleInLegend
Property type: Boolean
Default Paint
The default Paint that is used if there is no custom setting for a series.
Property name: basePaint
Property type: Data Table
Default Stroke
The default Stroke that is used if there is no custom setting for a series.
Property name: baseStroke
Property type: Data Table
Default Shape
The default Shape that is used if there is no custom setting for a series.
Property name: baseShape
Property type: Data Table
Default Fill Paint
The default fill paint that is used if there is no custom setting for a series.
Property name: baseFillPaint
Property type: Data Table
Default outline Paint
The default outline paint that is used if there is no custom setting for a series.
Property name: baseOutlinePaint
Property type: Data Table
Default Item Labels Visibility
The default visibility for all item labels.
Property name: baseItemLabelsVisible
Property type: Boolean
Default Item Label Font
The default item label font that is used if there is no custom setting for a series.
Property name: baseItemLabelFont
Property type: Data Table
Default Item Label Paint
The default item label paint that is used if there is no custom setting for a series.
Property name: baseItemLabelPaint
Property type: Data Table
Default Item Label Position
This property includes two values:
| • | Positive Item Label Position: the default setting for the positive item label position attribute is used when no per series or override setting is specified; |
| • | Negative Item Label Position: the default setting for the negative item label position attribute is used when no per series or override setting is specified. |
Example of a category bar chart that has the item labels for positive data values are displayed inside the bars, while the item labels for the negative data value are displayed underneath the bar:
The above chart also has a category marker.
Property name: baseItemLabelPosition
Property type: Data Table
Item Label Anchor Offset
The item label anchor offset allows some control over the position of item labels, by controlling how far the anchor point is shifted from its natural position.
Property name: itemLabelAnchorOffset
Property type: Float
Default Legend Shape
The default shape to use in chart legend(s).
Property name: baseLegendShape
Property type: Data Table
Default Legend Text Font
The default font to use in chart legend(s).
Property name: baseLegendTextFont
Property type: Data Table
Default Legend Text Paint
The default paint to use in chart legend(s).
Property name: baseLegendTextPaint
Property type: Data Table
Default Outline Stroke
The default outline stroke, to be used when no other stroke is available for the series.
Property name: baseOutlineStroke
Property type: Data Table
Per Series Properties
Series Visibility
The table defining visibility for individual data series.
Property |
Name |
Type |
Description |
Index |
index |
Integer |
Series index. |
Series Visible |
seriesVisible |
Boolean |
Flag indicating whether or not the series is visible. |
Property name: seriesVisible
Property type: Data Table
Auto Populate Series Paints
Flag indicating that different pre-defined series colors should be used instead of Default Paint.
Property name: autoPopulateSeriesPaints
Property type: Boolean
Series Paints
The table defining paints for individual data series.
Property |
Name |
Type |
Description |
Index |
index |
Integer |
Series index. |
Series Paint |
seriesPaint |
Data Table |
Paint to use for the series. |
Property name: seriesPaints
Property type: Data Table
Auto Populate Series Strokes
Flag indicating that different pre-defined series strokes should be used instead of Default Stroke.
Property name: autoPopulateSeriesStrokes
Property type: Boolean
Series Strokes
The table defining strokes for individual data series.
Property |
Name |
Type |
Description |
Index |
index |
Integer |
Series index. |
Series Stroke |
seriesStroke |
Data Table |
Stroke to use for the series. |
Property name: seriesStrokes
Property type: Data Table
Auto Populate Series Shapes
Flag indicating that different pre-defined series shapes should be used instead of Default Shape.
Property name: autoPopulateSeriesShapes
Property type: Boolean
Series Shapes
The table defining shapes for individual data series.
Property |
Name |
Type |
Description |
Index |
index |
Integer |
Series index. |
Series Shape |
seriesShape |
Data Table |
Shape to use for the series. |
Property name: seriesShapes
Property type: Data Table
Auto Populate Series Fill Paints
Flag indicating that different pre-defined series fill paints should be used instead of Default Fill Paint.
Property name: autoPopulateSeriesFillPaints
Property type: Boolean
Series Fill Paints
The table defining fill paints for individual data series.
Property |
Name |
Type |
Description |
Index |
index |
Integer |
Series index. |
Series Fill Paint |
seriesFillPaint |
Data Table |
Fill paint to use for the series. |
Property name: seriesFillPaints
Property type: Data Table
Auto Populate Series Outline Paints
Flag indicating that different pre-defined series outline paints should be used instead of Default Outline Paint.
Property name: autoPopulateSeriesOutlinePaints
Property type: Boolean
Series Outline Paints
The table defining outline paints for individual data series.
Property |
Name |
Type |
Description |
Index |
index |
Integer |
Series index. |
Series Outline Paint |
seriesOutlinePaint |
Data Table |
Outline paint to use for the series. |
Property name: seriesOutlinePaints
Property type: Data Table
Auto Populate Series Outline Stroke
Flag indicating that different pre-defined series outline strokes should be used instead of Default Outline Stroke.
Property name: autoPopulateSeriesOutlineStrokes
Property type: Boolean
Series Outline Stroke
The table defining outline strokes for individual data series.
Property |
Name |
Type |
Description |
Index |
index |
Integer |
Series index. |
Series Outline Stroke |
seriesOutlineStroke |
Data Table |
Outline stroke to use for the series. |
Property name: seriesOutlineStrokes
Property type: Data Table
Series Visibility In Legend
The table defining legend visibility for individual data series.
Property |
Name |
Type |
Description |
Index |
index |
Integer |
Series index. |
Series Visible In Legend |
seriesVisibleInLegend |
Boolean |
Flag indicating whether or not the series is visible in legend. |
Property name: seriesVisibleInLegend
Property type: Data Table
Legend Properties
The table defining the representation of individual series in the legend.
Property |
Name |
Type |
Description |
Index |
index |
Integer |
Series index. |
Shape |
shape |
Data Table |
Shape used to represent series in the legend. |
Text Paint |
paint |
Data Table |
Paint used to represent series in the legend. |
Text Font |
font |
Data Table |
Font used to represent series in the legend. |
Property name: legendProperties
Property type: Data Table
Series Item Label Properties
The table defining the representation of item labels for individual series.
Property |
Name |
Type |
Description |
Index |
index |
Integer |
Series index. |
Visible |
visible |
Boolean |
Item labels visibility flag. |
Font |
font |
Data Table |
Font used to print items labels. |
Paint |
paint |
Data Table |
Paint used to print items labels. |
Positive Items Position |
positiveItemsPosition |
Data Table |
Item Label Position for positive items in this series. |
Negative Items Position |
negativeItemsPosition |
Data Table |
Item Label Position for negative items in this series. |
Property name: seriesItemLabelProperties
Property type: Data Table