LineStyle

Beschreibung

Das LineStyle-Element definiert einen Stil für eine Linie.

Context

Tabelle 1 listet die Elemente auf, die ein LineStyle-Element enthalten oder in diesem enthalten sein können.

Tabelle 1. Context
Enthalten in Element Enthält

NamedStyle oder CompositeStyle oder AreaStyle

LineStyle

Pen

Attribute

Tabelle 2 listet die Attribute eines LineStyle-Elements auf.

Tabelle 2. Attribute
Attribut Beschreibung

id

Ein eindeutiger Bezeichner für das Element.

name

Ein beschreibender Name für das Element.

stroke

Ein Zeichenfolgenwert, der die Farbe der Linie angibt.

Der Wert kann jede gültige CSS-Farbe sein. (Siehe http://www.w3.org/TR/REC-CSS1#color-units.)

Das Attribut stroke ist optional. Der Standardwert ist black.

stroke-opacity

Ein Gleitpunktwert von 0 bis 1, der die Undurchsichtigkeit der Linie angibt.

Ein Wert von 0 bedeutet, dass die Linie vollkommen durchsichtig ist. Ein Wert von 1 bedeutet, dass die Linie vollkommen undurchsichtig ist. Ein Wert von 0,5 bedeutet, dass die Linie eine Transparenz von 50 % hat.

Das Attribut stroke-opacity ist optional. Der Standardwert ist 1.

width

Ein ganzzahliger Wert, der die Breite der Linie angibt.

Das Attribut width ist optional. Der Standardwert ist 1.

width-unit

Ein Verweis auf eine Bildgröße im MapInfo-Codespace, der eine Breiteneinheit angibt.

Das Attribut width-unit ist optional. Der Standardwert ist mapinfo:imagesize pixel.

miterlimit

Eine Beschränkung für das Verhältnis der Gehrungslänge zur Zeilenbreite für linejoin vom Typ miter. Wenn zwei Liniensegmente in einem spitzen Winkel aufeinandertreffen und Gehrungsverbindungen für linejoin angegeben wurden, ist es möglich, dass die Gehrung die Stärke der Linie, die den Pfad trifft, übersteigt.

Das Attribut miterlimit ist optional. Der Standardwert ist 10.

linecap

Ein Aufzählungswert, der die dekorative Form angibt, die am Ende von offenen Unterpfaden verwendet wird, wenn diese berührt werden. Die folgenden Werte sind möglich:

  • butt
  • round
  • square

Der Wert butt bedeutet, dass keine Dekoration verwendet wird. Der Wert round bedeutet, dass die Linie in einem Halbkreis endet, dessen Radius die Hälfte der Linienbreite beträgt. Der Wert square bedeutet, dass die Linie in einem Rechteck endet, dessen Länge die Hälfte der Linienbreite beträgt.

Das Attribut linecap ist optional. Der Standardwert ist round.

linejoin

Ein Aufzählungswert, der die Form angibt, die an den Ecken des Pfads oder bei Standardformen verwendet wird, wenn diese berührt werden. Die folgenden Werte sind möglich:

  • miter
  • bevel
  • round

Der Wert miter bedeutet, dass sich die Außenkanten von Linien verlängern, bis sie sich überschneiden. Wenn die Gehrung länger ist als miterlimit, wird der Typ bevel ersetzt. Der Wert bevel bedeutet, dass Linien verbunden werden, indem die Außenkanten ihrer Enden verbunden werden. Der Wert round bedeutet, dass jedes Liniensegment in einem Halbkreis endet, dessen Radius die Hälfte der Linienbreite beträgt.

Das Attribut linejoin ist optional. Der Standardwert ist round.

marker-placement

Ein Aufzählungswert, der den Platzierungsstil von Markierungen angibt. Die folgenden Werte sind möglich:

  • LEFT
  • CENTER
  • RIGHT
  • HORIZONTAL
  • MATCH_SEGMENT
  • none
Anmerkung: Derzeit wird für die Markierungsplatzierung nur none unterstützt.

Markierungen können an den Anfangs-, Mittel- oder Endknoten von Liniensegmenten platziert werden und fortlaufend entlang von Liniensegmenten gezeichnet werden. Die Werte LEFT, CENTER und RIGHT geben die horizontale Ausrichtung für eine mehrzeilige Textmarkierung an. Die Werte HORIZONTAL und MATCH_SEGMENT geben die Rotationsausrichtung einer Symbolmarkierung relativ zum Liniensegment an.

Das Attribut marker-placement ist optional. Der Standardwert ist none.

dasharray

Ein Array von durch Komma oder Leerzeichen getrennten ganzzahligen Werten, der die Länge (in Pixel) von wechselnden Strichen und Leerzeichen für eine gestrichelte Linie angibt. Beispiel: 10 20 30 10 oder 10,20,30,10.

Der Array muss eine gerade Anzahl von positiven ganzzahligen Werten oder den Sonderwert none enthalten. Der erste ganzzahlige Wert gibt die Länge des ersten Striches an, die zweite ganzzahlige Zahl die Länge des ersten Leerzeichens, usw. durch den Array.

Der folgende Wert beispielsweise
    10,20,30,10
gibt eine gestrichelte Linie an, in welcher der erste Strich 10 Pixel lang ist. Darauf folgt ein Leerzeichen von 20 Pixel Länge, gefolgt von einem 30 Pixel langen Strich, gefolgt von einem 10 Pixel langen Leerzeichen. Das Muster wiederholt sich anschließend für die Länge der gestrichelten Linie.

Das Attribut dasharray ist optional. Der Standardwert ist none, was dem Array 1,1 entspricht.

dashoffset

Ein positiver ganzzahliger Wert, der die Anzahl von Einheiten (in Pixel) vom Anfang des Liniensegments angibt, an dem der erste Strich einer gestrichelten Linie gezeichnet wird.

Das Attribut dashoffset ist optional. Der Standardwert ist 0.

Beispiel

Dieses Beispiel zeigt eine gestrichelte schwarze Linie, die ein Pixel breit ist.



<?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>