Macro PieChart

Permet de représenter un graphique de type "Pie". Se base sur la classe Java XChart PieChart.

Paramètre style

Objet Hash dont les clés sont les noms des propriétés de style et les valeurs la valeur associée à chaque propriété. Cet objet regroupe un ensemble de propriétés de base communes à tous les types de graphiques ainsi qu'un ensemble de propriétés spécifiques aux graphiques "Pie".

Type des propriétés

Chaque propriété est définie dans une classe XChart (classe de base Styler ou classe spécifique PieStyler) par sa méthode "setter". Lorsqu'une de ces propriétés est utilisée dans cette macro, son type Freemarker est celui correspondant au type Java associé.

Type Java Font

Certaines propriétés Java sont du type complexe Font (https://docs.oracle.com/javase/8/docs/api/java/awt/Font.html). Dans ce cas, le type Freemarker correspondant est une chaîne alphanumérique au format suivant :

"fontName-style-pointsize" où :

• fontName représente le nom de la police,
• style représente le style de la police parmi "PLAIN", "BOLD", "BOLDITALIC" ou "ITALIC",
• pointsize représente la taille de la police en points.

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

Type Java Color

Certaines propriétés Java sont du type complexe Font (https://docs.oracle.com/javase/8/docs/api/java/awt/Color.html). Dans ce cas, le type Freemarker correspondant est une chaîne alphanumérique au format suivant :

• "0xRRGGBB" ou "#rrggbb" (composantes Rouge Vert Bleu de la couleur en mode hexadécimal),
• Le nom littéral d'une couleur parmi "red", "orange", "yellow", "olive", "purple", "fuschia", "white", "lime", "green", "navy", "blue", "aqua", "teal", "black", "silver", "gray", "magenta", "pink", "cyan", "light_grey", "lightgrey", "brown", "grey", "dark_grey", "darkgrey",
• "rgb(r,g,b)" " (composantes Rouge Vert Bleu de la couleur en mode décimal).

↑ Haut de page

Paramètre series

Séquence d'objets Hash représentant les séries de données du graphique "Pie". De plus, pour chaque série, il est possible de définir des propriétés de style. Chaque objet Hash représente une série : ces propriétés permettent de stoker les valeurs des données ainsi que les valeurs des propriétés de style.

Propriétés des données d'une série

Une série d'un graphique "Pie" est représentée par son nom et par une seule valeur (Cf. méthode addSeries https://knowm.org/javadocs/xchart/org/knowm/xchart/PieChart.html).

↑ Haut de page

Propriétés de style d'une série

Ces propriétés permettent de particulariser une série en surchargeant une propriété de style définie dans l'objet Hash du paramètre Style de la macro. Chaque propriété est définie dans une classe XChart (classe de base Series ou classe spécifique PieSeries) par sa méthode "setter".

Lorsqu'une de ces propriétés est utilisée dans cette macro, son type Freemarker est celui correspondant au type Java associé.