PieChart macro

Used to represent a "Pie"-type chart. Based on the Java XChart PieChart class.

Style parameter

Hash object for which the keys are style property names and the values the value associated with each property. This object groups together a set of base properties which are common to all types of chart as well as a set of properties which are specific to "Pie" charts.

Property type

Each property is defined in an XChart class (Styler base class or specific PieStyler class) by its "setter" method. When one of these properties is used in this macro, its Freemarker type is that which corresponds to the associated Java type.

Java Font Type

Certain Java properties are complex Font types (https://docs.oracle.com/javase/8/docs/api/java/awt/Font.html). In this case, the corresponding FreeMarker type is an alphanumeric string in the following format:

"fontName-style-pointsize" where:

• fontName represents the font name,
• style represents the font style: "PLAIN", "BOLD", "BOLDITALIC" or "ITALIC",
• pointsize represents the font size in points.

Examples:"Arial-BOLD-18", "SansSerif-PLAIN-24"

Java Color Type

Certain Java properties are complex Font types ( https://docs.oracle.com/javase/8/docs/api/java/awt/Color.html). In this case, the corresponding FreeMarker type is an alphanumeric string in the following format:

• "0xRRGGBB" or "#rrggbb" (Red Green Blue components of the color in hexadecimal mode),
• The literal name of a color: "red", "orange", "yellow", "olive", "purple", "fuchsia", "white", "lime", "green", "navy", "blue", "aqua", "teal", "black", "silver", "gray", "magenta", "pink", "cyan", "light_gray", "lightgray", "brown", "gray", "dark_gray", "darkgray",
• "rgb(r,g,b)" " (Red Green Blue components of the color in decimal mode),

Series parameter

Sequence of Hash objects representing the data series of the "Pie" chart. Also, style properties can be defined for each series. Each Hash object represents a series: these properties enable data values as well as style property values to be stored.

Data properties of a series

A "Pie" chart series is represented by its name and a single value (Cf. addSeries method https://knowm.org/javadocs/xchart/org/knowm/xchart/PieChart.html).

Style properties of a series

These properties are used to specify a series by overloading a style property defined in the Hash object of the macro's Style parameter. Each property is defined in an XChart class (Series base class or specific PieSeries class) by its "setter" method.

When one of these properties is used in this macro, its Freemarker type is that which corresponds to the associated Java type.