Pie Plot

This plot is used by Pie Chart and Ring Chart.

Angle (in degrees) at which the first pie section starts. Zero is at 3 o'clock, and as the angle increases it proceeds anticlockwise around the chart (so that 90 degrees, the current default, is at 12 o'clock).

Property name: startAngle

Property type: Float

Direction of the sections in the chart: Clockwise (the default) or Anticlockwise.

Property name: direction

Property type: String

Gap around the interior of the pie plot (the region where the labels are drawn) as a percentage of the plot width and height. The default value is 0.08 (8%).

Property name: interiorGap

Property type: Float

Flag that controls whether the pie chart is circular or elliptical in shape.

Property name: circular

Property type: Boolean

A dataset can contain null, zero or negative values which are awkward or impossible to display in a pie chart. Some special handling is built into the Pie Plot for these. If a zero or null value is found in the dataset, the Pie Plot, by default, will place a label at the position where the pie section would be displayed if it had a positive value and will also add an item to the chart's legend. If you prefer zero and null values to be ignored, use the following properties:

Flag that controls whether or not null values in the dataset are ignored.

Property name: ignoreNullValues

Property type: Boolean

Flag that controls whether or not zero values in the dataset are ignored.

Property name: ignoreZeroValues

Property type: Boolean

The plot will draw a "shadow" effect controlled by several properties:

Paint used to draw the "shadow" effect. If disabled, no shadow effect will be drawn.

Property name: shadowPaint

Property type: Data Table

X-offset for the shadow effect.

Property name: shadowXOffset

Property type: Float

Y-offset for the shadow effect.

Property name: shadowXOffset

Property type: Float

Section labels are generated according to the following properties:

Property name: labelGenerator

Property type: Data Table

Section tooltips are generated according to the following properties:

Property name: toolTipGenerator

Property type: Data Table

The Pie Plot supports the display of "exploded" sections, in which a pie section is offset from the center of the chart to highlight it.

Here is an example:

To make space for the sections that are offset from the center of the pie chart, the radius of the main pie is reduced, so a pie chart with exploded sections will appear smaller than a pie chart with no exploded sections.

Table that controls "exploding" of individual pie sections:

Property name: explodedPercents

Property type: Data Table

The paint used to fill each section in the pie chart is, by default, auto-populated (auto-assigned).

Default section paint, to be used if there is no custom setting for a series.

Property name: baseSectionPaint

Property type: Data Table

Flag that controls whether or not the different pre-defined section paints should be used.

Property name: autoPopulateSectionPaints

Property type: Boolean

The table defining paints for individual sections.

Property name: sectionPaints

Property type: Data Table

Section outlines are drawn, by default, as a thin grey line around each pie section. The Pie Plot provides options to:

• Switch off the outlines completely;
• Change the outlines for all sections by changing the default value;
• Control the outline for particular pie sections independently.

Flag that controls whether or not section outlines are drawn.

Property name: sectionOutlinesVisible

Property type: Boolean

Default section outline paint, to be used if there is no custom setting for a series.

Property name: baseSectionOutlinePaint

Property type: Data Table

Flag that controls whether or not the different pre-defined section outline paints should be used.

Property name: autoPopulateSectionOutlinePaints

Property type: Boolean

The table defining outline paints for individual sections.

Property name: sectionOutlinePaints

Property type: Data Table

Default section outline stroke, to be used if there is no custom setting for a series.

Property name: baseSectionOutlineStroke

Property type: Data Table

Flag that controls whether or not the different pre-defined section outline strokes should be used.

Property name: autoPopulateSectionOutlineStrokes

Property type: Boolean

The table defining outline strokes for individual sections.

Property name: sectionOutlineStrokes

Property type: Data Table

Font used to display the section labels.

Property name: labelFont

Property type: Data Table

Paint used to display the section labels.

Property name: labelPaint

Property type: Data Table

Paint used to fill the section label boxes. If disabled, the label boxes will be transparent (the plot background color will show through).

Property name: labelBackgroundPaint

Property type: Data Table

Paint used to draw the outline around the section labels. If disabled, the label boxes will not have an outline drawn.

Property name: labelOutlinePaint

Property type: Data Table

Stroke used to draw outlines around the section labels. If disabled, no outlines will be drawn.

Property name: labelOutlineStroke

Property type: Data Table

Paint used to draw the shadows beneath the section label boxes. If disabled, no shadow is drawn.

Property name: labelShadowPaint

Property type: Data Table

Label padding, i.e. the whitespace around the text and inside the outline. See Rectangle Insets.

Property name: labelPadding

Property type: Data Table

With regular (non-simple, see below) section labels, a linking line is drawn to connect the pie section with its corresponding section label. These links have several properties:

Flag that controls whether or not the section label linking lines are visible.

Property name: labelLinksVisible

Property type: Boolean

The style of label links: Standard, Quad or Cubic.

Property name: labelLinkStyle

Property type: String

Label linking line has a bend or "elbow" at a point slightly outside of the pie chart. The distance of the point from the edge of the pie chart is expressed as a percentage of the pie radius, and is referred to as the Label Link Margin. The default value is 0.025 (two-and-a-half percent).

Property name: labelLinkMargin

Property type: Float

Paint used for the lines connecting the pie sections to their corresponding labels.

Property name: labelLinkPaint

Property type: Data Table

Stroke used for the lines connecting the pie sections to their corresponding labels.

Property name: labelLinkStroke

Property type: Data Table

Gap between the edge of the pie and the label areas at the left and right side of the pie, as a percentage of the overall plot width. The default value is 0.025 (2.5%).

Property name: labelGap

Property type: Float

Maximum label width as a percentage of the plot width. The default value is 0.14 (fourteen percent).

Property name: maximumLabelWidth

Property type: Float

A "simple" labelling option ensures that the labels are drawn roughly in the center of each pie section. No attempt is made to avoid overlapping labels in

the case that several small pie sections are displayed alongside each other, so use this option only for cases where that is not a concern.

Flag that controls whether the pie plot shows section labels in the "simple" format.

Property name: simpleLabels

Property type: Boolean

Insets used to calculate the simple label anchor points relative to the pie plot's bounding rectangle.

Property name: simpleLabelOffset

Property type: Data Table

Minimum angle for drawing the arc segment for a pie section.

Property name: minimumArcAngleToDraw

Property type: Float

Shape displayed with each legend item.

Property name: legendItemShape

Property type: Data Table

Was this page helpful?

Tell us more

Send

Thank you!