Auteur : L.Jégou
Un Mapfile possède une organisation hiérarchique, basée sur des blocs (ou objets, par référence aux objets de MapScript), à l'intérieur d'un bloc principal, le bloc MAP.
Chaque bloc commence par son nom et se termine par le mot-clé "END".
Au début du mapfile, juste après le mot-clé "MAP" et avant le premier sous-bloc, on trouve une en-tête avec quelques paramètres généraux.
- NAME : nom de la carte, préfixe ajouté à tous les fichiers image générés par le mapfile, donc à garder de courte taille.
- UNITS : Unité de la carte, utilisé pour les calculs et le dessin de la barre d'échelle. L'information sur l'unité du fond de carte n'est pas toujours apportée par le bloc « projection », il faut donc essayer de la fournir explicitement à chaque fois.
Valeurs : [feet|inches|kilometers|meters|miles|dd]
- EXTENT : Extension de la carte, donc coordonnées des extrémités de la carte dessinée dans l'image générée par le mapfile, exprimées dans l'unité de la projection générale du mapfile.
Valeurs : [xmin] [ymin] [xmax] [ymax]
- STATUS : On ou Off, active ou désactive la totalité du mapfile.
- FONTSET et SYMBOLSET : chemin et nom des fichiers contenant les définitions de polices de caractères (utile sous linux) et de symboles (on peut aussi définir un symbole directement dans le mapfile, mais c'est utile de pouvoir les rassembler dans un seul fichier qui poura être appellé par différents mapfiles).
- SHAPEPATH : Chemin vers le répertoire contenant les fichiers de données (des couches), ou le chemin de base à partir duquel les paramètres DATA iront les chercher.
Ensuite peuvent intervenir les paramètres de génération de l'image :
- IMAGETYPE : type de fichier image à générer. La valeur doit correspondre à l'une de celles inclues par défaut par MapServer, où à une définition explicite par ajout d'un bloc OUTPUTFORMAT. Ce paramètre dépend des options avec lesquelles à été compilé MapServer.
Valeurs : [gif|png|jpeg|wbmp|gtiff|swf|userdefined]
- SIZE : Dimensions (largeur et hauteur) de l'image à générer, en pixels, séparées par un espace.
- RESOLUTION : Résolution de l'image en dpi, par défaut 72. N'affecte que les calculs d'échelle, cf. le bloc SCALEBAR.
