Le bloc LAYER

Auteur : L.Jégou

Ce bloc va définir les propriétés de création et d'affichage d'une couche de données SIG par MapServer. Les blocs LAYER sont dessinés dans l'ordre du mapfile, c'est à dire que le premier bloc du mapfile est dessiné en premier, les suivants viendront par-dessus sur la carte. L'ordre du mapfile est donc l'ordre inverse de la superposition verticale des sources.

• Paramètres généraux :
  • NAME : Nom de la couche, utilisé comme identifiant par l'interface web. Doit être unique dans le mapfile et d'une longueur maximale de 20 caractères.
  • GROUP : Groupe auquel le LAYER appartient. Utilisé dans les modèles HTML pour activer/désactiver les couches par groupes.
  • METADATA : Bloc secondaire utilisé pour stocker des paires nom – valeur. Utilisé par les modèles HTML et en mode serveur WMS.
  • STATUS : Statut (visibilité) du layer. Valeurs : default, on, off. Doit prendre la valeur « default » pour que le layer soit visible lorsque l'on utilise MapServer en mode Map (le STATUS ON ne suffit pas à le rendre visible, il faut que le layer soit expressément requis).
  • TYPE : Type d'objet géométrique ou modalité selon laquelle la couche doit être dessinée. Valeurs : point|line|polygon|circle|annotation|raster|query. Ce paramètre peut prendre une valeur différente du type géométrique des objets contenus dans la couche d'origine, par exemple une couche de polygones peut être représentée comme un LAYER de type POINT, ce qui affichera les centroïdes des polygones (mais pas l'inverse, naturellement).
  • MINSCALE : Échelle minimale à laquelle la couche sera dessinée. Si une échelle plus petite est demandée, MapServer dessinera la couche à l'échelle précisée par ce paramètre.
  • MAXSCALE : Idem pour l'échelle maximale.
  • SYMBOLESCALE : Échelle à laquelle les symboles et/ou les textes apparaîssent à leur taille normale. Ce paramètre permet un dimensionnement dynamique de ce type d'objets selon l'échelle de la carte, dans les limites des deux paramètres précédents. Obligatoire pour l'utilisation du paramètre SIZEITEM dans un bloc CLASS.
  • TRANSPARENCY : Degré de transparence de la couche, exprimé en pourcentage (sans le signe %), de 100 – opaque à 0 – totalement transparent.
  • OFFSITE : Le numéro d'index de la couleur d'une couche raster à traiter comme transparent. Cela permet de ne garder que la région utile d'une couche raster.
  • POSTLABELCACHE : Valeur booléenne (true/false) qui indique à MapServer de dessiner cette couche après avoir dessiné les libellés (labels) qui sont dans le tampon des libellés. Prend la valeur false par défaut.
  • CLASSITEM : Nom de la colonne attributaire qui est utilisée dans les expressions de sélection des blocs CLASS.
  • LABELITEM : Nom de la colonne attributaire qui fournira le texte des étiquettes.
  • TEMPLATE : Nom du fichier modèle HTML qui prend en compte cette couche. Obligatoire pour rendre cette couche interrogeable par requête, même si on n'utilise pas de modèle HTML.
  • DEBUG : Valeur On ou Off. Si le paramètre général LOG est défini, les messages de débogage détaillés seront ajoutés au fichier de log, en plus de l'affichage à l'écran des messages d'erreur.

• Paramètres de données
  Voir les pages dédiées à l'utilisation des données vecteur, raster et distantes, cf. la question sur les types de données utilisables.
   Le bloc LAYER peut contenir des blocs de hiérarchie inférieure (cf. les questions dédiées) :
  • bloc CLASS
  • bloc LABEL