Ce chapitre regroupe l'ensemble des fonctions PHIGURE permettant de générer des légendes représentant les couleurs associées aux isovaleurs couramment définies. Ces dernières sont evidemment celles définies par une des fonctions de PHIGURE tset_isoval_list, tset_homog_isoval_list ou tset_regul_isoval_list. De plus, la matérialisation de valeurs indéfinies est presentée sur ces légendes si la fonction tundefined_value est appelée auparavant avec un domaine restreint de valeurs définies.
PHIGURE propose 6 types de représentation de légende différents :
tisoval_legend_1 définit une légende par la taille des boites élémentaires et par un point de référence. Chaque boite est colorée par la couleur associée à une valeur comprise entre 2 isovaleurs consécutives. Les textes de ces deux isovaleurs sont reportés à côté de la boite.
tisoval_legend_2 définit une légende par un rectangle délimitant l'ensemble des boites colorées. Chaque boite est colorée par la couleur associée à une valeur comprise entre 2 isovaleurs consécutives. Les textes de ces deux isovaleurs sont reportés à côté de la boite.
tisoval_legend_3 définit une légende par la taille des boites élémentaires et par un point de référence. Chaque boite est colorée par la couleur associée à une isovaleur. Le texte de cette isovaleur est reportée à côté de la boite.
tisoval_legend_4 définit une légende par un rectangle délimitant l'ensemble des boites colorées. Chaque boite est colorée par la couleur associée à une isovaleur. Le texte de cette isovaleur est reportée à côté de la boite.
tisoval_legend_5 définit une légende par une seule boite rectangulaire colorée par les différentes couleurs associées à la liste des isovaleurs courante. Chaque isovaleur est annotée sur la boite au niveau d'un changement de couleur
tisoval_legend_linear définit une légende par une seule boite rectangulaire colorée par les différentes couleurs associées à la liste des isovaleurs courante. La longueur des zones colorées par la même couleur est proportionnelle à la différence entre 2 isovaleurs consécutives. 3 méthodes d'annotation des isovaleurs sont disponibles.
Ces 6 types de représentation de légende sont paramétrables par les fonctions PHIGURE suivantes
Ces fonctions doivent être appelées avant de construire la légende par tisoval_legend_1, tisoval_legend_2, tisoval_legend_3, tisoval_legend_4, tisoval_legend_5, ou tisoval_legend_linear.
D'autre part, il est aussi possible de récuperer les valeurs courantes de ces paramètres pour une structure légende donnée, en appelant les fonctions suivantes :
tinq_legend_label
tinq_legend_value
tinq_legend_path
tinq_legend_margin
tinq_iso_legend_box_spacing
tinq_iso_legend_append_string
tinq_iso_legend_period
tinq_iso_legend_strings
DIFFERENTS TYPES C UTILISE DANS LES FONCTIONS DE LEGENDE
/* type d'alignement de la boite de la légende par rapport à son point de reférence*/
typedef enum {
TBOX_CENTER,
TBOX_LEFT_BOTTOM,
TBOX_MIDDLE_BOTTOM,
TBOX_RIGHT_BOTTOM,
TBOX_MIDDLE_RIGHT,
TBOX_RIGHT_TOP,
TBOX_MIDDLE_TOP,
TBOX_LEFT_TOP,
TBOX_MIDDLE_LEFT,
} Tbox_alignment;
/* type concernant la position du libellé par rapport aux boites colorées des isovaleurs */
typedef enum {
TPOS_TOP,
TPOS_BOTTOM,
TPOS_LEFT,
TPOS_RIGHT
} Ttext_pos;
/* type de définition des marges */
typedef enum{
TRELATIVE_MARGIN,
TABSOLUTE_MARGIN
} Tmargin_type;
/* type d'incémentation des valeurs */
typedef enum {
TVERTICAL_INCREMENT,
THORIZONTAL_INCREMENT
} Tincrement_type;
/* type de présentation des isovaleurs de la légende lineaire */
typedef enum {
TLISO_LINEAR_TYPE1,
TLISO_LINEAR_TYPE2,
TLISO_LINEAR_TYPE3
} Tlegend_linear_type;