LineStyle

Description

L'élément LineStyle définit un style de ligne.

Contexte

Tableau 1 répertorie les éléments qui peuvent contenir ou être contenus par un élément LineStyle.

Tableau 1. Contexte
Contenu par	Élément	Contient
NamedStyle ou CompositeStyle ou AreaStyle	LineStyle	Pen

Attributs

Tableau 2 répertorie les attributs d'un élément LineStyle.

Tableau 2. Attributs
Attribut	Description
id	Identificateur unique de l'élément.
name	Nom descriptif de l'élément.
stroke	Valeur de chaîne définissant la couleur de la ligne. La valeur peut prendre toute couleur CSS valide. (Consultez l'adresse http://www.w3.org/TR/REC-CSS1#color-units.) L'attribut `stroke` est facultatif. La valeur par défaut est `black`.
stroke-opacity	Valeur à virgule flottante comprise entre 0 et 1 définissant l'opacité de la ligne. Une valeur 0 signifie que la ligne est totalement transparente. Une valeur 1 signifie que la ligne est totalement opaque. Une valeur 0,5 signifie que la ligne est 50 % transparente. L'attribut `stroke-opacity` est facultatif. La valeur par défaut est 1.
width	Valeur entière définissant la largeur de la ligne. L'attribut `width` est facultatif. La valeur par défaut est 1.
width-unit	Référence à la taille d'une image dans MapInfo Codespace qui définit une unité de largeur. L'attribut `width-unit` est facultatif. La valeur par défaut est `mapinfo:imagesize pixel`.
miterlimit	Limite du ratio entre la longueur d'anglet et la largeur de ligne de l'élément `linejoin` de type `miter`. Lorsque deux segments de ligne se rencontrent à un angle droit et que des joints d'anglet ont été définis pour `linejoin`, il est possible d'étendre l'anglet bien au-delà de l'épaisseur de la ligne traçant la voie. L'attribut `miterlimit` est facultatif. La valeur par défaut est 10.
linecap	Valeur d'énumération définissant la forme décorative à utiliser à l'extrémité des sous-voies ouvertes lors de leur traçage. Les valeurs possibles sont : `butt` `round` `square` La valeur `butt` signifie qu'aucune décoration n'est utilisée. La valeur `round` signifie que la ligne se termine par un demi-cercle dont le rayon correspond à la moitié de la largeur de la ligne. La valeur `square` signifie que la ligne se termine par un rectangle dont la longueur correspond à la moitié de la largeur de la ligne. L'attribut `linecap` est facultatif. La valeur par défaut est `round`.
linejoin	Valeur d'énumération définissant la forme à utiliser aux coins des voies ou des formes de base lors de leur traçage. Les valeurs possibles sont : `miter` `bevel` `round` La valeur `miter` signifie que les bords externes des lignes s'étendent jusqu'à leur intersection. Si l'anglet est plus long que la valeur `miterlimit`, le type `bevel` est substitué. La valeur `bevel` signifie que les lignes sont jointes en reliant les bords externes de leurs extrémités. La valeur `round` signifie que chaque segment de ligne se termine par un demi-cercle dont le rayon correspond à la moitié de la largeur de la ligne. L'attribut `linejoin` est facultatif. La valeur par défaut est `round`.
marker-placement	Valeur d'énumération définissant le style de placement des marqueurs. Les valeurs possibles sont : `LEFT` `CENTER` `RIGHT` `HORIZONTAL` `MATCH_SEGMENT` `none` Remarque : Actuellement, seule la valeur `none` est prise en charge pour le placement de marqueur. Les marqueurs peuvent être placés au niveau des nœuds de début, de fin ou central des segments de ligne et tracés en continu le long des segments de ligne. Les valeurs `LEFT`, `CENTER` et `RIGHT` indiquent la justification horizontale d'un marqueur de texte à plusieurs lignes. Les valeurs `HORIZONTAL` et `MATCH_SEGMENT` définissent l'orientation rotationnelle d'un marqueur de symbole par rapport au segment de ligne. L'attribut `marker-placement` est facultatif. La valeur par défaut est `none`.
dasharray	Série de valeurs entières délimitées par des virgules ou des espaces blancs définissant les longueurs (en pixels) des tirets et des espaces alternatifs d'une ligne en pointillés. Par exemple, `10 20 30 10` ou `10,20,30,10`. La série doit contenir un nombre pair d'entiers positifs ou la valeur spéciale `none`. Le premier entier de la série indique la longueur du premier tiret, le second la longueur du premier espace, et ainsi de suite. Par exemple, la valeur suivante, `10,20,30,10` indique une ligne en pointillés dont le premier tiret mesure 10 pixels de long, suivi d'un espace de 20 pixels de long, suivi d'un tiret de 30 pixels de long, suivi d'un espace de 10 pixels de long. Le modèle se répète sur la longueur de la ligne en pointillés. L'attribut `dasharray` est facultatif. La valeur par défaut est `none`, ce qui revient à la série `1,1`
dashoffset	Valeur entière positive définissant le nombre d'unités (en pixels) depuis le début du segment de ligne à partir duquel le premier tiret d'une ligne en pointillés est tracé. L'attribut `dashoffset` est facultatif. La valeur par défaut est `0`.

Exemple

Cet exemple définit une ligne en pointillés noire de 1 pixel de large.



<?xml version="1.0" encoding="UTF-8"?>
<NamedStyle
    version="MXP_WorkSpace_1_5"
    xmlns="http://www.mapinfo.com/mxp">
    <LineStyle
        stroke="black"
        stroke-opacity="1"
        width="1"
        width-unit="mapinfo:imagesize pixel">
        <Pen>mapinfo:pen 9</Pen>
    </LineStyle>
</NamedStyle>