PHIGURE permet de générer un objet graphique représentant de façon claire la répartition d'une donnée par rapport à un ensemble de données. Chacune d'entre elles possède une valeur numérique qui est traduite en % de la somme des valeurs de l'ensemble des données. Ce pourcentage est utilisé pour calculer l'angle du secteur représentant la donnée. On obtient ainsi un ensemble de secteurs ou de parts formant un camembert.
Le camembert est donc formé de plusieurs secteurs sur lesquels peuvent être inscrits de différentes façons, les textes associés aux données, leur valeur et leur pourcentage. Le camembert est ainsi configurable par un ensemble de fonctions d'attributs relatifs à la présentation du camembert. Si ces fonctions ne sont pas appélées, les attributs qu'elles positionnent ont de toute façon une valeur par défaut qui sera utilisée par les fonctions de construction du camembert TPIECH, ou TPIEC3
Attribut position des annotations :
Les annotations externes (texte, valeur, pourcentage) des parts de camembert peuvent être tracées radialement aux parts, horizontalement, alignées horizontalement ou verticalement ou le long d'un carré.
Les annotations internes des parts de camembert peuvent être tracées radialement aux parts, ou horizontalement.
Attribut flags de visibilité des annotations :
Les textes, valeurs, et pourcentages peuvent être visibles ou invisibles en annotations internes et/ou en annotations externes. Si plusieurs sont visibles, il est possible de préciser la méthode d'alignement dans la boite d'annotation.
Attribut hauteur des annotations :
Les hauteurs des caractères des textes, valeurs, et pourcentages peuvent être définies indifféremment pour les annotations internes et/ou externes.
Attribut chaîne concaténée aux valeurs d'annotations :
Une chaîne de caractères peut être concaténée aprés chaque valeur d'annotation interne et/ou externe. Cette chaîne peut représenter par exemple l'unité des valeurs.
Attribut flèche d'annotation externes :
Une flèche composée de deux branches peut relier les annotations externes aux parts de camemberts.
Attribut distances d'annotation :
Ces distances indiquent l'éloignement des annotations internes et/ou externes au centre du camembert. Pour les annotations externes, ces distances donnent les longueurs des 2 branches des flèches.
Attribut de regroupement de valeurs faibles :
Un nombre important de données de valeurs trés faibles peuvent perturber la clarté d'un camembert. Pour éviter cet inconvénient, toutes les données de valeurs inférieures à un seuil au choix peuvent être regoupées dans une même part de camembert. Par défaut toutes les données de valeurs inférieures à 5% sont regroupées dans une part intitulée "Others".
Attribut déplacement de part :
Certaines parts du camembert peuvent être décalées du centre du camembert, pour les mettre en évidence par rapport aux autres parts non décalées. Le décalage se fait le long de l'axe de la bissectrice du secteur de la part.
Attribut de représentation des parts:
Les parts peuvent être coloriées, hachurées ou remplies par un motif. Une table spécifiant la représentation associée à chaque part peut donc être choisie. L'application de ces représentations lors de la construction du camembert est cyclique : si le nombre de représentations définies est inférieur au nombre de parts du camembert, les représentations choisies se répètent. Par défaut la table des représentations est formée des 8 premières couleurs du poste de travail (noir, blanc, rouge, vert, bleu, cyan, magenta, jaune) qui seront appliquées pour remplir les secteurs du camembert.
Pour gérer ces attributs PHIGURE fournit un ensemble de fonctions TSPIxx qui les positionnent pour une structure donnée, et un ensemble de fonctions TQPIxx qui les récupèrent dans une structure donnée. Ces dernières sont notamment utiles pour développer une application permettant un changement interactif des valeurs des attributs du camembert.
Comme pour les fonctions d'axe, les fonctions de positionnement d'attribut doivent être appelées avant l'appel de TPIECH ou TPIEC3.
De plus PHIGURE dispose de la fonction TQPIPN permettant, lors d'une application interactive, de récupérer le numéro d'une part du camembert désignée par l'utilisateur à l'aide de la souris.L'utilisateur peut ainsi modifier les caractèristiques (textes, valeurs ...) du camembert