MapServer banner Home | Docs | Issue Tracker | FAQ | Download
en de es fr

LABEL

Revision:$Revision: 10895 $
Last Updated:04/02/2011
ALIGN [left|center|right]
Depuis la version 5.4. Définie l’alignement du texte pour les étiquettes de plusieurs lignes (voir WRAP). Notez que l’algorithme pour l’alignement est loin d’être précis, n’espérez pas de résultats fabuleux (spécialement pour l’alignement à droite) si vous n’utilisez pas une police à taille fixe.
ANGLE [double|auto|follow|attribute]
  • Angle, données en degrées, pour dessiner l’étiquette.

  • AUTO permet à MapServer de calculer l’angle. Valide uniquement pour les couches de type ligne (LINE).

  • FOLLOW a été implémenté dans la version 4.10 et indique à MapServer de calculer une étiquette courbe appropriée aux entités linéaires (cf. la MS RFC 11: Support for Curved Labels pour les détails).

  • [ATTRIBUTE] a été implémenté dans la version 5.0 pour spécifier le nom de l’attribut dans la table attributaire à utiliser pour les valeurs angulaires. Les crochets [] sont nécessaires. Par exemple, si le fichier DBF de votre fichier Shape contient un champ nommé “MONANGLE” qui indique la valeur de l’angle pour chaque enregistrement, votre objet LABEL doit contenir :

    LABEL
      COLOR  150 150 150
      OUTLINECOLOR 255 255 255
      FONT "sans"
      TYPE truetype
      SIZE 6
      ANGLE [MYANGLE]
      POSITION AUTO
      PARTIALS FALSE
    END
    

    le document RFC associé pour cette fonctionnalité est MS RFC 19: Style & Label attribute binding.

ANTIALIAS [true|false]
Le texte doit-il être antialiasé ? Notez que ceci nécessite un plus grand nombre de couleurs, diminue les performances de rendu et génère des images plus lourdes.
BACKGROUNDCOLOR [r] [g] [b]
Couleur à utiliser pour dessiner un rectangle d’arrière plan (panneau d’étiquette (“billboard”)). Désactivé par défaut.
BACKGROUNDSHADOWCOLOR [r] [g] [b]
Couleur à utiliser pour dessiner l’ombre d’un rectangle d’arrière plan (panneau d’étiquette (“billboard”)). Désactivé par défaut.
BACKGROUNDSHADOWSIZE [x][y]
Jusqu’où le rectangle d’arrière plan doit être décalé ? 1 par défaut.
BUFFER [integer]
Remplissage, en pixels, autour des étiquettes. Utile pour maintenir un espace autour du texte pour en améliorer sa lecture. Disponible seulement pour les étiquettes “cachables”. 0 par défaut.
COLOR [r] [g] [b] | [attribute]
  • Couleur à utiliser pour dessiner le texte.

  • [ATTRIBUTE] a été implémenté dans la version 5.0 pour spécifier le nom de l’attribut dans la table attributaire à utiliser pour les valeurs de couleur. Les crochets [] sont nécessaires. Par exemple, si le fichier DBF de votre fichier Shape contient un champ nommé “MACOULEUR” qui indique la valeur de la couleur pour chaque enregistrement, votre objet LABEL doit contenir :

    LABEL
      COLOR  [MACOULEUR]
      OUTLINECOLOR 255 255 255
      FONT "sans"
      TYPE truetype
      SIZE 6
      POSITION AUTO
      PARTIALS FALSE
    END
    

    Le document RFC associé pour cette fonctionalité est MS RFC 19: Style & Label attribute binding.

ENCODING [string]

Format d’encodage géré à utiliser pour les étiquettes. Si le format n’est pas géré, l’étiquette ne sera pas dessinée. Nécessite la bibliothèque iconv ( présente sur la plupart des systèmes). La bibliothèque est toujours détectée si elle est présente sur le système mais si celle-ci n’est pas présente, l’étiquette ne sera pas dessinée.

Nécessaire pour afficher des caractères internationaux dans MapServer. Plus d’informations sur : http://www.foss4g.org/FOSS4G/MAPSERVER/mpsnf-i18n-en.html

FONT [name|attribute]
  • Nom de la police de caractères (comme défini dans le FONTSET) à utiliser pour les étiquettes.
  • [Attribute] a été introduit dans la version 5.6 pour définir l’alias de la police.
FORCE [true|false]
Force l’affichage des étiquettes d’une classe particulière, sans s’occuper des superpositions (collisions). Disponible seulement pour les étiquettes en cache. Désactivé par défaut.
MAXLENGTH [integer]

Introduit dans mapserver 5.4, ce mot clé interagit avec le mot clé WRAP afin que les retours à la lignes aient lieu seulement après un nombre définie de caractères.

Interaction avec le mot clé WRAP
  maxlength = 0 maxlength > 0 maxlength < 0
wrap = ‘char’ retour à la ligne au caractère WRAP nouvelle ligne dès le premier caractère WRAP après MAXLENGTH caractères retour fixe (toujours exactement après MAXLENGTH caractères)
pas de wrap aucun traitement ignore l’étiquette s’il contient plus que MAXLENGTH caractères retour fixe (toujours exactement après MAXLENGTH caractères)

Le document RFC associé pour cette fonctionalité est MS RFC 40: Support Label Text Transformations.

MAXSIZE [integer]
Taille maximale de la police de caractères à utiliser pour redimensionner le texte (en pixels). 256 par défaut.
MINDISTANCE [integer]
Distance minimale entre des étiquettes en double, en pixels.
MINFEATURESIZE [integer|auto]
Taille minimale d’une entité devant être étiquettée, en pixels. Pour les données linéaires, la longueur totale de la ligne affichée est utilisée, pour les entités polygonales la taille du plus petit côté du rectangle englobant est utilisée. Le mot-clé “Auto” indique à MapServer d’étiqueter uniquement les entités plus grandes que leur propre étiquette. Disponible seulement pour les étiquettes en cache.
MINSIZE [integer]
Taille minimale de la police de caractères à utiliser pour redimensionner le texte (en pixels). 4 par défaut.
OFFSET [x][y]
Valeurs de décalage pour les étiquettes, relatives au coin inférieur gauche de l’étiquette ou du point d’insertion de l’étiquette, en pixels. Dans le cas d’un texte tourné (rotation), cette commande spécifie les valeurs comme si toutes les étiquettes étaient horizontales et toute rotation sera compensée.
OUTLINECOLOR [r] [g] [b] | [attribute]
  • Couleur utilisée pour dessiner une ligne d’un pixel autour du texte.

  • [ATTRIBUTE] a été implémenté dans la version 5.0 pour spécifier le nom de l’attribut dans la table attributaire à utiliser pour les valeurs de couleur. Les crochets [] sont nécessaires. Par exemple, si le fichier DBF de votre fichier Shape contient un champ nommé “MACOULEUREXTERIEURE” qui indique la valeur de la couleur pour chaque enregistrement, votre objet LABEL doit contenir :

    LABEL
      COLOR  150 150 150
      OUTLINECOLOR [MACOULEUREXTERIEURE]
      FONT "sans"
      TYPE truetype
      SIZE 6
      POSITION AUTO
      PARTIALS FALSE
    END
    

    Le document RFC associé pour cette fonctionalité est MS RFC 19: Style & Label attribute binding.

OUTLINEWIDTH [integer]
Largeur du contour si OUTLINECOLOR a été définie. 1 par défaut. Pour l’instant sur le moteur de rendu AGG gère des valeurs supérieures à 1, et rend un contour avec un effet “d’halo” : valeurs recommendées : 3 ou 5.
PARTIALS [true|false]
Le texte peut-il être caché s’il n’apparait qu’en partie sur la carte ? Activé par défaut.
POSITION [ul|uc|ur|cl|cc|cr|ll|lc|lr|auto]
Position de l’étiquette relative au point d’insertion (couches seulement). La première lettre est la position en “Y”, la seconde lettre est la position en “X”. “Auto” indique à MapServer de calculer une position d’étiquette qui n’interférera pas avec d’autres étiquettes. Avec des points, MapServer sélectionne l’une des 8 positions extérieures (c’est à dire en excluant cc). Avec les polygones, MapServer sélectionne cc (ajouté dans MapServer 5.4), uc, lc, cl et cr comme positions possible. Avec des lignes, il utilise seulement lc ou uc, jusqu’à ce qu’il trouve une position qui n’entraîne pas de chevauchement (collision) avec des étiquettes déjà dessinées. Si toutes les positions entraînent un conflit, alors l’étiquette n’est pas dessinée (sauf si le paramètre d’étiquette FORCE est activé). “Auto” est seulement disponible avec les étiquettes en cache.
PRIORITY [integer]|[item_name]|[attribute]

Le paramètre de priorité (ajouté dans la version 5.0) prend un chiffre entier entre 1 (la plus basse) et 10 (la plus haute). La valeur par défaut est de 1. Il est également possible d’affecter la priorité à un attribut (item_name) en utilisant des crochets autour de l’attribut. Par exemple : “PRIORITY [monattribut]”.

Les étiquettes sont stockées dans le cache des étiquettes et sont dessinées par ordre de priorité : les plus hauts niveaux de priorité sont dessinés en premier. Spécifier dans le mapfile une valeur en dehors de la plage correcte du paramètre PRIORITY entrainera une erreur (“parse error”). Une valeur en dehors de la plage correcte récupérée depuis MapScript ou depuis un attribut prendra la valeur minimale ou maximale de PRIORITY au moment du rendu. Il n’y a pas d’impact attendu sur les performances lors de l’utilisation des priorités des étiquettes.

[Attribute] a été introduit dans la version 5.6.
REPEATDISTANCE [integer]
  • Introduit à la version 5.6. L’étiquette sera répétée sur chaque ligne d’une géoémtrie multligne et sera répétée plusieurs fois le long d’une ligne donnée dans un interval de REPEATDISTANCE pixels.
Le document RFC associé pour cette fonctionalité est MS RFC 57: Labeling enhancements: ability to repeat labels along a line/multiline.
SHADOWCOLOR [r] [g] [b]
Couleur de l’ombre.
SHADOWSIZE [x][y]
Décalage de l’ombre en pixels.
SIZE [integer]|[tiny|small|medium|large|giant]|[attribute]
  • Taille du texte. Utiliser “integer” pour donner la taille en pixels de votre police de caractères TrueType ou utilisez l’un des 5 mots-clés listés pour les polices de caractères bitmap.

  • [Attribute] a été implémenté dans la version 5.0 pour spécifier le nom de l’attribut dans la table attributaire à utiliser pour les valeurs de taille. Les crochets [] sont nécessaires. Par exemple, si le fichier DBF de votre fichier Shape contient un champ nommé “MATAILLE” qui indique la valeur de la taille pour chaque enregistrement, votre objet LABEL doit contenir :

    LABEL
      COLOR  150 150 150
      OUTLINECOLOR 255 255 255
      FONT "sans"
      TYPE truetype
      SIZE [MYSIZE]
      POSITION AUTO
      PARTIALS FALSE
    END
    

    Le document RFC associé pour cette fonctionalité est MS RFC 19: Style & Label attribute binding.

TYPE [bitmap|truetype]
Type de police de caractères à utiliser. Généralement les polices bitmap sont plus rapides à dessiner que les polices TrueType. Cependant les polices TrueType sont redimensionnables et disponibles sous de nombreuses formes. Assurez-vous que le paramètre FONT est activé si vous choisissez “TrueType”.
WRAP [character]
Caractère qui représente une rupture de ligne dans le texte de l’étiquette et qui entraine la création d’une étiquette multi-ligne. Interagit avec MAXLENGTH pour le retour à la ligne conditionnel après un nomber de caractères données.