Auteur : L.Jégou
MapServer peut générer trois types de légendes :
- légendes simples sous forme d'images ;
- légendes basées sur un modèle (template) de légende HTML ;
- légendes en HTML pur.
Les légendes simples sont des images, inclues ou pas dans l'image de la carte principale, reprenant chaque classe nommée des layers du mapfile et son figuré. Il faut donc penser à nommer toutes les classes que l'on veut voir apparaître en légende (paramètre NAME).
Lorsque la légende simple est incluse dans l'image de la carte (paramètre : STATUS EMBED), on peut préciser l'endroit où la légende sera dessinée avec le paramètre POSITION. Ce paramètre prend une valeur correspondant à un code composé de deux lettres, la première pour le haut / bas, u pour « upper », l pour « lower », la seconde pour gauche / droite, l pour « left », r pour « right », et c pour « center » :
| ul | uc | ur |
| . | . | . |
| ll | lc | lr |
Les caissons (rectangles colorés) de légende pour les couches de polygones sont réglables en taille avec le paramètre KEYSIZE (valeurs : largeur hauteur) et leur espacement avec le paramètre KEYSPACING (valeurs : écart horizontal espace écart vertical). Il n'est pas possible de titrer une légende avec le seul mapfile (la générer sous un titre texte dans la page html qui contient la carte ou utiliser un modèle html).
- IMAGECOLOR [r] [g] [b]
Couleur de fond de la légende.
- LABEL
Il est possible d'ajouter un bloc LABEL dans le bloc LEGEND pour en paramétrer les libellés.
- OUTLINECOLOR [r] [g] [b]
Couleur de contour des caissons.
- POSITION [ul|uc|ur|ll|lc|lr]
Position de la légende dans l'image de la carte, cf. ci-dessus.
- KEYSIZE [x][y]
Taille en pixels des caissons de légende, 20x10 pixels par défaut.
- KEYSPACING [x][y]
Ecart entre les caissons (Y) et les libellés (X). 5 pixels partout par défaut.
- POSTLABELCACHE [true|false]
Demande à MapServer de dessiner la légende après que tous les libellés en cache soient dessinés. Utile pour ajouter des filets et autres éléments de décoration. A False par défaut.
- STATUS [on|off|embed]
Permet d'activer ou non la légende. "embed" permet d'intégrer l'image de la légende dans l'image de la carte principale, plutôt que de générer un autre fichier image.
- TEMPLATE [filename]
Permet de préciser un fichier modèle (template) HTML pour la légende.
