[mapserver-commits] r10610 - trunk/docs/fr/mapfile
svn at osgeo.org
svn at osgeo.org
Sun Oct 17 14:28:09 EDT 2010
Author: yjacolin
Date: 2010-10-17 11:28:09 -0700 (Sun, 17 Oct 2010)
New Revision: 10610
Added:
trunk/docs/fr/mapfile/Include.txt
trunk/docs/fr/mapfile/feature.txt
trunk/docs/fr/mapfile/grid.txt
trunk/docs/fr/mapfile/join.txt
trunk/docs/fr/mapfile/label.txt
Log:
[fr] adding new file
Added: trunk/docs/fr/mapfile/Include.txt
===================================================================
--- trunk/docs/fr/mapfile/Include.txt (rev 0)
+++ trunk/docs/fr/mapfile/Include.txt 2010-10-17 18:28:09 UTC (rev 10610)
@@ -0,0 +1,99 @@
+.. _include:
+
+*****************************************************************************
+ INCLUDE
+*****************************************************************************
+
+.. index::
+ pair: INCLUDE; MAP
+
+Quand cette commande est rencontrée pendant la lecture du mapfile, le fichier
+inclus est immédiatement lu. En conséquence, le fichier inclus peut être composé
+d'une syntaxe de mapfile valide. Par exemple :
+
+.. code-block:: mapfile
+
+ INCLUDE 'myLayer.map'
+
+Les performances ne semblent pas être très diminuées lors d'une utilisation
+limitée, cependant dans des sessions à haute charge vous devriez utiliser les
+INCLUDE dans une étape intermédiaire avant de construire le mapfile de
+production. Le pré-processeur C peut également être utilisé (mais avec une
+syntaxe différente) et est beaucoup plus puissant.
+
+Notes
+-----
+
+- Géré dans les versions 4.10 et supérieures.
+
+- Le nom du fichier à inclure **DOIT être entre quotes**(simples ou doubles).}
+
+- Les inclusions peuvent être imbriquées, jusqu'à 5.
+
+- L'emplacement du fichier peut être donné par un chemin complet vers le
+ fichier ou (dans MapServer >= 4.10.1) par un chemin relatif au mapfile.
+
+- Le débogage peut être problématique car :
+
+ 1) une erreur dans le fichier n'est pas renvoyée à l'utilisateur ;
+
+ 2) le compteur du nombre de lignes n'est pas remis à zéro pour chaque fichier.
+ Ci-dessous une des erreurs possibles qui se produit quand le fichier à inclure
+ ne peut pas etre trouvé :
+
+ ::
+
+ msyylex(): Unable to access file. Error opening included file "parks_include.map"
+
+Exemple
+-------
+
+::
+
+ MAP
+ NAME "include_mapfile"
+ EXTENT 0 0 500 500
+ SIZE 250 250
+
+ INCLUDE "test_include_symbols.map"
+ INCLUDE "test_include_layer.map"
+ END
+
+où test_include_symbols.map contient :
+
+::
+
+ SYMBOL
+ NAME 'square'
+ TYPE VECTOR
+ FILLED TRUE
+ POINTS 0 0 0 1 1 1 1 0 0 0 END
+ END
+
+et où test_include_layer.map contient :
+
+::
+
+ LAYER
+ TYPE POINT
+ STATUS DEFAULT
+ FEATURE
+ POINTS 10 10 40 20 300 300 400 10 10 400 END
+ END
+ CLASS
+ NAME 'Church'
+ COLOR 0 0 0
+ SYMBOL 'square'
+ SIZE 7
+ STYLE
+ SYMBOL "square"
+ SIZE 5
+ COLOR 255 255 255
+ END
+ STYLE
+ SYMBOL "square"
+ SIZE 3
+ COLOR 0 0 255
+ END
+ END
+ END
\ No newline at end of file
Added: trunk/docs/fr/mapfile/feature.txt
===================================================================
--- trunk/docs/fr/mapfile/feature.txt (rev 0)
+++ trunk/docs/fr/mapfile/feature.txt 2010-10-17 18:28:09 UTC (rev 10610)
@@ -0,0 +1,50 @@
+.. _feature:
+
+*****************************************************************************
+ Entité
+*****************************************************************************
+
+POINTS
+ Un ensemble de couples xy terminés par END, par exemple :
+
+ ::
+
+ POINTS 1 1 50 50 1 50 1 1 END
+
+.. note::
+
+ Notez qu'avec les couches POLYGON/POLYLINE, le point de départ doit
+ être également le point d'arrivée (pour fermer l'entité).
+
+ITEMS
+ Liste séparée par des virgules d'attributs d'objets :
+
+ ::
+
+ ITEMS "value1;value2;value3"
+
+.. note::
+
+ Définir le même nombre d'item est recommencé pour chaque objets de la
+ même couche. Le nom de l'item doit être définir comme option
+ PROCESSING d'une couche.
+
+TEXT [string]
+ Chaîne de caractères à utiliser pour étiqueter cette entité.
+
+WKT [string]
+ Une géométrie au format OpenGIS "Well Known Text". Cette entité est
+ supportée uniquement si MapServer est compilé avec la gestion d'OGR
+ ou de GEOS.
+
+ ::
+
+ WKT "POLYGON((500 500, 3500 500, 3500 2500, 500 2500, 500 500))"
+ WKT "POINT(2000 2500)"
+
+.. note::
+
+ Les entités en ligne devraient être définies comme leurs propres couches dans le
+ mapfile. Si une autre CONNECTIONTYPE est spécifiée dans la même couche,
+ MapServer utilisera toujours les entités en ligne pour dessiner la couche et
+ ignorera les autres CONNECTIONTYPE.
Added: trunk/docs/fr/mapfile/grid.txt
===================================================================
--- trunk/docs/fr/mapfile/grid.txt (rev 0)
+++ trunk/docs/fr/mapfile/grid.txt 2010-10-17 18:28:09 UTC (rev 10610)
@@ -0,0 +1,81 @@
+.. _grid:
+
+*****************************************************************************
+ GRID
+*****************************************************************************
+
+LABELFORMAT [DD|DDMM|DDMMSS|C format string]
+ Format de l'étiquette. "DD" pour des degrés, "DDMM" pour des degrés
+ minutes et "DDMMSS" pour des degrés minutes secondes. Une chaîne
+ formattée à la manière du C est également permise, par exemple "%g°"
+ pour afficher des degrés décimaux avec un symbole "degré". La valeur par
+ défaut est l'affichage des décimales quel que soit le rendu de GRID.
+
+MINARCS [double]
+ Le nombre minimal d'arcs à dessiner. Augmentez ce paramètre pour
+ générer plus de lignes. Optionnel.
+
+MAXARCS [double]
+ Le nombre maximal d'arcs à dessiner. Diminuez ce paramètre pour
+ générer moins de lignes. Optionnel.
+
+MININTERVAL [double]
+ Le nombre minimal d'intervalles à utiliser. Il s'agit de la distance entre
+ les lignes de la grille, dans l'unité du système de coordonnées de la grille.
+ Optionnel.
+
+MAXINTERVAL [double]
+ Le nombre maximal d'intervalles à utiliser. Il s'agit de la distance entre les
+ lignes de la grille, dans l'unité du système de coordonnées de la grille.
+ Optionnel.
+
+MINSUBDIVIDE [double]
+ Le nombre minimal de segments à utiliser pour générer un arc. Si les lignes
+ doivent être très incurvées, utilisez cette option pour adoucir les lignes en
+ ajoutant plus de segments. Optionnel.
+
+MAXSUBDIVIDE [double]
+ Le nombre maximal de segments à utiliser pour générer un arc. Si le
+ graticule doit être très droit, utilisez cette option pour diminuer le nombre
+ de points et obtenir un rendu plus rapide. Optionnel, 256 par défaut.
+
+Ci-dessous est un exemple d'objet GRID :
+
+::
+
+ LAYER
+ NAME "grid"
+ METADATA
+ "DESCRIPTION" "Grid"
+ END
+ TYPE LINE
+ STATUS ON
+ CLASS
+ NAME "Graticule"
+ COLOR 0 0 0
+ LABEL
+ COLOR 255 0 0
+ FONT "fritqat"
+ TYPE truetype
+ SIZE 8
+ POSITION AUTO
+ PARTIALS FALSE
+ BUFFER 5
+ OUTLINECOLOR 255 255 255
+ END
+ END
+ PROJECTION
+ "init=epsg:4326"
+ END
+ GRID
+ LABELFORMAT "DDMM"
+ # LABELFORMAT '%g°' # dec degrees with symbol
+ MAXARCS 10
+ MAXINTERVAL 10
+ MAXSUBDIVIDE 2
+ # LABELFORMAT '%7.0f m' # nice if a projected SRS used
+ # MININTERVAL 20000
+ # MAXSUBDIVIDE 2
+ END
+ END # Layer
+
Added: trunk/docs/fr/mapfile/join.txt
===================================================================
--- trunk/docs/fr/mapfile/join.txt (rev 0)
+++ trunk/docs/fr/mapfile/join.txt 2010-10-17 18:28:09 UTC (rev 10610)
@@ -0,0 +1,283 @@
+.. _join:
+
+*****************************************************************************
+ JOIN
+*****************************************************************************
+
+.. index:: Join
+
+Description
+===========
+
+Les jointures sont définies au sein d'un objet LAYER. Il est important de
+comprendre que les jointures sont *UNIQUEMENT* disponibles une fois qu'une
+requête a été exécutée. Vous ne pouvez pas utiliser les jointures pour modifier
+ l'apparence d'une carte. L'objectif principal est de permettre de lier une table Ã
+des données codées (par exemple 1 => Forêt) mais d'autres utilisations sont
+possibles.
+
+Formats gérés
+=================
+
+- DBF/XBase files
+- CSV (Fichier texte délimité par des virgules)
+- tables PostgreSQL et PostGIS
+- tables MySQL
+
+Paramètres du MapFIle :
+===================
+
+CONNECTION [string]
+ Paramètres nécessaires pour effectuer la jointure sur une base de données
+ (non nécessaires pour des jointures vers DBF ou CSV). L'exemple suivant
+ est pour :ref:`PostgreSQL <input_postgis>` :
+
+.. code-block:: mapfile
+
+ CONNECTION "host=127.0.0.1 port=5432 user=postgres password=postgres dbname=somename"
+
+CONNECTIONTYPE [string]
+ Type de connexion (non nécessaire pour des jointures vers DBF ou CSV).
+ L'exemple suivant est pour PostgreSQL :
+
+.. code-block:: mapfile
+
+ CONNECTIONTYPE ogr
+
+FROM [item]
+ Objet de jointure dans les données. Sensible à la casse.
+
+NAME [string]
+ Nom unique de cette jointure. Obligatoire.
+
+TABLE [filename|tablename]
+ Pour les jointures basées sur des fichiers, il s'agit du nom de la XBase ou
+ du fichier texte délimité (par rapport au mapfile) sur lequel effectuer la
+ jointure. Pour les bases de données PostgreSQL et MySQL, il s'agit du
+ nom de la table PostgreSQL/MySQL sur laquelle effectuer la jointure.
+
+TEMPLATE [filename]
+ Modèle ("template") à utiliser pour les jointure 1-n (1 vers plusieurs).
+ Le modèle est généré une fois pour chaque enregistrement et ne peut contenir
+ que des substitutions pour les objets de la table jointe. Faites référence à la
+ colonne de la table jointe dans votre modèle comme ceci :
+ [joinname_columnname] où "joinname" est le NAME spécifié pour l'objet JOIN.
+
+TO [item]
+ Objet de jointure dans la table à joindre. Sensible à la casse.
+
+TYPE [ONE-TO-ONE|ONE-TO-MANY]
+ Le type de jointure. Par défaut 1-1.
+
+Exemple 1 : jointure d'un fichier SHP et d'un fichier DBF
+=========================================
+
+Couche mapfile
+----------------
+
+.. code-block:: mapfile
+
+ LAYER
+ NAME "prov_bound"
+ TYPE POLYGON
+ STATUS DEFAULT
+ DATA "prov.shp"
+ CLASS
+ NAME "Province"
+ STYLE
+ OUTLINECOLOR 120 120 120
+ COLOR 255 255 0
+ END
+ END
+ TEMPLATE "../htdocs/cgi-query-templates/prov.html"
+ HEADER "../htdocs/cgi-query-templates/prov-header.html"
+ FOOTER "../htdocs/cgi-query-templates/footer.html"
+ JOIN
+ NAME "test"
+ TABLE "../data/lookup.dbf"
+ FROM "ID"
+ TO "IDENT"
+ TYPE ONE-TO-ONE
+ END
+ END # layer
+
+Ogrinfo
+-------
+
+::
+
+ >ogrinfo lookup.dbf lookup -summary
+ INFO: Open of `lookup.dbf'
+ using driver `ESRI Shapefile' successful.
+
+ Layer name: lookup
+ Geometry: None
+ Feature Count: 12
+ Layer SRS WKT:
+ (unknown)
+ IDENT: Integer (2.0)
+ VAL: Integer (2.0)
+
+::
+
+ >ogrinfo prov.shp prov -summary
+ INFO: Open of `prov.shp'
+ using driver `ESRI Shapefile' successful.
+
+ Layer name: prov
+ Geometry: Polygon
+ Feature Count: 12
+ Extent: (-2340603.750000, -719746.062500) - (3009430.500000, 3836605.250000)
+ Layer SRS WKT:
+ (unknown)
+ NAME: String (30.0)
+ ID: Integer (2.0)
+
+Modèle
+--------
+
+::
+
+ <tr bgcolor="#EFEFEF"><td align="left">[NAME]</td><td align="left">[test_VAL]</td></tr>
+
+
+Exemple 2 : jointure d'un fichier SHP et d'une table PostgreSQL
+=================================================
+
+Couche mapfile
+---------------
+
+.. code-block:: mapfile
+
+ LAYER
+ NAME "prov_bound"
+ TYPE POLYGON
+ STATUS DEFAULT
+ DATA "prov.shp"
+ CLASS
+ NAME "Province"
+ STYLE
+ OUTLINECOLOR 120 120 120
+ COLOR 255 255 0
+ END
+ END
+ TOLERANCE 20
+ TEMPLATE "../htdocs/cgi-query-templates/prov.html"
+ HEADER "../htdocs/cgi-query-templates/prov-header.html"
+ FOOTER "../htdocs/cgi-query-templates/footer.html"
+ JOIN
+ NAME "test"
+ CONNECTION "host=127.0.0.1 port=5432 user=postgres password=postgres dbname=join"
+ CONNECTIONTYPE ogr
+ TABLE "lookup"
+ FROM "ID"
+ TO "ident"
+ TYPE ONE-TO-ONE
+ END
+ END # layer
+
+Ogrinfo
+-------
+
+::
+
+ >ogrinfo -ro PG:"host=127.0.0.1 port=5432 user=postgres password=postgre dbname=join" lookup -summary
+ INFO: Open of `PG:host=127.0.0.1 port=5432 user=postgres password=postgres dbname=join'
+ using driver `PostgreSQL' successful.
+
+ Layer name: lookup
+ Geometry: Unknown (any)
+ Feature Count: 12
+ Layer SRS WKT:
+ (unknown)
+ ident: Integer (0.0)
+ val: Integer (0.0)
+
+Modèle
+--------
+
+::
+
+ <tr bgcolor="#EFEFEF"><td align="left">[NAME]</td><td align="left">[test_val]</td></tr>
+
+.. note::
+
+ Quand vous testez cette jointure postgreSQL avec MapServer 4.10.0 sur Windows
+ entraîne un crash de mapserv.exe. Cependant si vous testez ceci avec une version
+ > 4.10.0 ce crash n'arrive pas.
+
+Exemple 3 : jointure d'un fichier SHP et d'un fichier CSV
+=========================================
+
+Couche mapfile
+----------------
+
+.. code-block:: mapfile
+
+ LAYER
+ NAME "prov_bound"
+ TYPE POLYGON
+ STATUS DEFAULT
+ DATA "prov.shp"
+ CLASS
+ NAME "Province"
+ STYLE
+ OUTLINECOLOR 120 120 120
+ COLOR 255 255 0
+ END
+ END
+ TOLERANCE 20
+ TEMPLATE "../htdocs/cgi-query-templates/prov.html"
+ HEADER "../htdocs/cgi-query-templates/prov-header.html"
+ FOOTER "../htdocs/cgi-query-templates/footer.html"
+ JOIN
+ NAME "test"
+ TABLE "../data/lookup.csv"
+ FROM "ID"
+ TO "IDENT"
+ TYPE ONE-TO-ONE
+ END
+ END # layer
+
+Structure du fichier CSV
+------------------------
+
+::
+
+ "IDENT","VAL"
+ 1,12
+ 2,11
+ 3,10
+ 4,9
+ 5,8
+ 6,7
+ 7,6
+ 8,5
+ 9,4
+ 10,3
+ 11,2
+ 12,1
+
+Ogrinfo
+-------
+
+::
+
+ >ogrinfo lookup.csv lookup -summary
+ INFO: Open of `lookup.csv'
+ using driver `CSV' successful.
+
+ Layer name: lookup
+ Geometry: None
+ Feature Count: 12
+ Layer SRS WKT:
+ (unknown)
+ IDENT: String (0.0)
+ VAL: String (0.0)
+
+Modèle
+--------
+
+::
+
+ <tr bgcolor="#EFEFEF"><td align="left">[NAME]</td><td align="left">[test_VAL]</td></tr>
\ No newline at end of file
Added: trunk/docs/fr/mapfile/label.txt
===================================================================
--- trunk/docs/fr/mapfile/label.txt (rev 0)
+++ trunk/docs/fr/mapfile/label.txt 2010-10-17 18:28:09 UTC (rev 10610)
@@ -0,0 +1,270 @@
+.. _label:
+
+*****************************************************************************
+ LABEL
+*****************************************************************************
+
+.. index:: LABEL
+
+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
+ :ref:`RFC11` 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 :
+
+ .. code-block:: mapfile
+
+ 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 :ref:`RFC19`.
+
+.. index::
+ pair: LABEL; ANTIALIAS
+
+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 :
+
+ .. code-block:: mapfile
+
+ 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 :ref:`RFC19`.
+
+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:
+
+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:
+
+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.
+
+ .. csv-table:: 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 :ref:`RFC40`.
+
+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:
+
+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 :
+
+ .. code-block:: mapfile
+
+ 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 :ref:`RFC19`.
+
+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 :ref:`RFC57`.
+
+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 :
+
+ .. code-block:: mapfile
+
+ 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 :ref:`RFC19`.
+
+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:
+
+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.
\ No newline at end of file
More information about the mapserver-commits
mailing list