Auteur : L.Jégou
Ce bloc définit les paramètres de la petite carte utilisée comme référence pour la carte principale. C'est une image sur laquelle va être dessiné un rectangle représentant l'extension de la carte principale, ou la localisation des résultats d'une requête, en mode QUERY.
MapServer va faire la relation entre la carte principale et la carte de référence grâce aux paramètres EXTENT des deux cartes, et afficher un rectangle (ou un symbole) permettant de localiser et de mesurer l'extension de la carte principale sur la carte de référence. Par défaut le bloc REFERENCE a un paramètre STATUS à OFF, pour activer cette carte il faut donc penser à avoir une ligne « STATUS ON ».
Paradoxalement, MapServer a besoin d'une image fixe représentant la petite carte de référence, il ne va pas la générer. Cela permet par contre l'utilisation d'une image externe. Il faut donc alors, pour produire cette image, utiliser un mapfile simplifié (uniquement les contours de la couche principale par exemple), réglé pour générer une image de petites dimensions. On peut naturellement créer un mapfile spécifique pour générer cette image, puis l'utiliser comme référence dans le mapfile principal.
- COLOR [r] [g] [b]
Couleur de fond du rectangle de référence tracé sur la carte. Une valeur à -1 indique que le rectangle doit être évidé. La couleur par défaut est le rouge.
- EXTENT [minx] [miny] [maxx] [maxy]
Etendue spatiale de la carte de référence.
- IMAGE [fichier]
Nom de fichier complet de l'image de la carte de référence. Doit être une image de type GIF.
- MARKER [integer|string]
Numéro ou nom du SYMBOL (dans le fichier SYMBOLSET du mapfile) utilisé lorsque le rectangle de référence devient trop petit (voir les valeurs MINBOXSIZE et MAXBOXSIZE ci-dessous). Un croisillon par défaut.
- MARKERSIZE [integer]
Taille du SYMBOL utilisé en remplacement du rectangle.
- MINBOXSIZE [integer]
Si le rectangle de référence est plus petit (largeur ou hauteur en pixels) que cette valeur, alors c'est le SYMBOL défini dans MARKER et MARKERSIZE qui est utilisé (ou le croisillon par défaut).
- MAXBOXSIZE [integer]
Si le rectangle de référence est plus grand (largeur ou hauteur en pixels) que cette valeur, alors il n'est pas dessiné.
- OUTLINECOLOR [r] [g] [b]
Couleur du contour du rectangle de référence. Une valeur à -1 indique qu'aucun contour n'est dessiné.
- SIZE [x][y]
Taille en pixels de la carte (image) de référence.
- STATUS [on|off]
Indique si la carte de référence doit être utilisée. Attention, ce paramètre est OFF par défaut.
