LABEL

ALIGN [left|center|right]

Ab Version 5.4 . Definiert die Textausrichtung für mehrzeilige Labels (siehe WRAP). Der Algorithmus zur Platzierung ist noch nicht sehr genau, besonders für Schriften ohne feste Breite (insbesondere für rechtsbündige Anordnung) kann diese Einstellung eine ungünstige Platzierung liefern.

ANGLE [double|auto|follow|attribute]

• Winkel, angegeben in Grad, um den rotiert wird.

• AUTO für die Berechnung des Winkels durch MapServer. Nur für Linienlayer gültig.

• FOLLOW (ab Version 4.10) ermöglicht MapServer ein Label zu berechnen wobei die Ausrichtung dem Linienverlauf folgt (siehe MS RFC 11: Support for Curved Labels für weitere Details).

• [Attribute] (ab Version 5.0) gibt die Spalte in der Attributtabelle an, die die Winkelwerte für die Rotation enthält. Die eckigen Klammern müssen angegeben werden. Beispiel: Enthält die zugehörige Tabelle (DBF-Datei) ein Feld “MYANGLE” mit den Winkelwerten für jedes Element, kann dies analog dem folgenden Beispiel benutzt werden:

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

  Das zugehörige RFC Dokument für diese Eigenschaft ist MS RFC 19: Style & Label attribute binding.

ANTIALIAS [true|false]

Soll Kantenglättung (Antialiasing) benutzt werden? Diese Einstellung erfordert mehr verfügbare Farben, reduziert die Zeichengeschwindigkeit und produziert leicht größere Ausgabebilder.

BACKGROUNDCOLOR [r] [g] [b]

Farbe mit der das Hintergrundrechteck gezeichnet wird. Standard ist aus.

BACKGROUNDSHADOWCOLOR [r] [g] [b]

Farbe mit der die Schattenfarbe des Hintergrundrechtecks gezeichnet wird. Standard ist aus.

BACKGROUNDSHADOWSIZE [x][y]

Gibt den Abstand des Hintergrundrechecks an. Standard ist 1.

BUFFER [integer]

Padding (Polster), in Pixel, rundherum um Labels. Sinnvoll um einen Abstand um jedes Label herum zu definieren um die Lesbarkeit zu erhöhen. Nur für gecachte Label verfügbar. Standard ist 0.

COLOR [r] [g] [b] | [attribute]

• Farbe mit der Text gezeichnet wird.

• [Attribute] (ab Version 5.0) gibt die Spalte in der Attributtabelle an, die die Farbwerte enthält. Die eckigen Klammern müssen angegeben werden. Beispiel: Enthält die zugehörige Tabelle (DBF-Datei) ein Feld “MYCOLOR” mit den Farbwerten für jedes Element, kann dies analog dem folgenden Beispiel benutzt werden:

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

  Das zugehörige RFC Dokument für diese Eigenschaft ist MS RFC 19: Style & Label attribute binding.

ENCODING [string]

Enkodierung die für Labels benutzt wird. Wird das Format nicht unterstützt, so wird das Label nicht gezeichnet. Benötigt die iconv Bibliothek, die auf vielen Systemen vorhanden ist. Ist die Bibliothek vorhanden, wird sie auch erkannt, andererseits wird das Label nicht gezeichnet.

Wird benötigt um internationale Zeichen darzustellen. Weitere Informationen unter: http://www.foss4g.org/FOSS4G/MAPSERVER/mpsnf-i18n-en.html.

FONT [name]

Name der Schrift (wie in FONTSET angegeben) um Label zu zeichnen.

FORCE [true|false]

Erzwingt das Zeichnen von Labels, auch wenn Kollisionen entstehen. Nur für gecachte Label verfügbar. Standard ist false.

MAXLENGTH [integer]

(ab Version 5.4) Anzahl der Zeichen nach denen ein Zeilenumbruch vorgenommen wird. Steht in Zusammenhang mit WRAP

Verhalten von WRAP

	maxlength = 0	maxlength > 0	maxlength < 0
wrap = ‘char’	immer bei WRAP Zeichen umbrechen	Zeilenumbruch beim ersten WRAP Zeichen nach MAXLENGTH Zeichen	harter Umbruch (immer nach genau MAXLENGTH Zeichen umbrechen)
no wrap	keine Verarbeitung	Label nicht zeichnen wenn länger als MAXLENGTH Zeichen	harter Umbruch (immer nach genau MAXLENGTH Zeichen umbrechen)

Das zugehörige RFC Dokument für diese Eigenschaft ist MS RFC 40: Support Label Text Transformations.

MAXSIZE [integer]

Maximale Schriftgröße bei skaliertem Text (Pixel). Standard ist 256.

MINDISTANCE [integer]

Mindestabstand zwischen doppelten Label. Angabe in Pixel.

MINFEATURESIZE [integer|auto]

Mindestgröße eines Features um ein Label gezeichnet zu bekommen. Angabe in Pixel. Für Linienobjekte wird die Gesamtlänge der angezeigten Linie benutzt, für Polygone die Maße der Bounding Box. Bei “Auto” werden nur Objekte beschriftet deren Abmaße größer als das zugehörige Label sind. Nur für gecachte Label verfügbar.

MINSIZE [integer]

Minimale Schriftgröße bei skaliertem Text (Pixel). Standard ist 4.

OFFSET [x][y]

Abstandswerte für Labels, relativ zur linken unteren Labelecke und dem Beschriftungspunkt. Angabe in Pixel. Für rotierte Labels benutzen Sie Werte so, als ob alle Labels horizontal sind und die Rotation anschließend erfolgt.

OUTLINECOLOR [r] [g] [b] | [attribute]

• Farbe mit der eine 1-Pixel breite Linie um den Text gezeichnet wird.

• [Attribute] (ab Version 5.0) gibt die Spalte in der Attributtabelle an, die die Farbwerte enthält. Die eckigen Klammern müssen angegeben werden. Beispiel: Enthält die zugehörige Tabelle (DBF-Datei) ein Feld “MYOUTCOLOR” mit den Farbwerten für jedes Element, kann dies analog dem folgenden Beispiel benutzt werden:

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

  Das zugehörige RFC Dokument für diese Eigenschaft ist MS RFC 19: Style & Label attribute binding.

OUTLINEWIDTH [integer]

Breite der Umrisslinie wenn OUTLINECOLOR gesetzt wurde. Standard ist 1. Derzeitig unterstützt nur der AGG Renderer Werter größer als 1. Für einen ‘Halo’-Effekt werden Werte zwischen 3 und 5 empfohlen.

PARTIALS [true|false]

Erlaubt oder verhindert das Abschneiden von Text an der Kartenkante. Standard ist erlauben.

POSITION [ul|uc|ur|cl|cc|cr|ll|lc|lr|auto]

Position des Labels relativ zum Beschriftungspunkt (nur Layers). Erster Buchstabe “Y” Position, zweiter Buchstabe “X” Position. Bei “Auto” berechnet MapServer die Labelposition so, das keine Überschneidung mit anderen Labels stattfindet. Bei Punkten nimmt MapServer einen Wert der umliegenden 8 Positionen (alles außer cc). Bei Polygonen wird zwischen cc (ab Version 5.4), uc, lc, cl und cr gewählt. Bei Linien wird nur zwischen lc und uc gewählt, bis eine Position gefunden wurde die mit bereits gezeichneten Label nicht kollidiert. Sollten alle Positionen eine Kollision verursachen, wird das Label nicht gezeichnet (es sei denn der Parameter FORCE wurde auf true gesetzt). “Auto” ist nur für gecachte Label verfügbar.

PRIORITY [integer]|[item_name]|[attribute]

(ab Version 5.0) Die Priorität kann mit Werten zwischen 1 (kleinste) und 10 (höchste) angegeben werden. Standard ist 1. Es ist ebenso möglich den Wert aus einer Spalte der Attributtabelle zu benutzen, dabei muß der Spaltennamen in eckige Klammern gesetzt werden. Beispiel: “PRIORITY [attributname]”

Labels werden im Label-Cache zwischengespeichert und entsprechend ihrer Priorität gerendert, beginnend mit der höchsten Priorität. Wird ein Wert außerhalb des Wertebereichs für PRIORITY im Mapfile angegeben, wird ein Parserfehler ausgegeben. Wird ein ungültiger Wert mittels Mapscript gesetzt oder aus der Attributtabelle gelesen, wird zur Laufzeit das Minimum oder Maximum benutzt. Auf die Geschwindigkeit hat die Verwendung von Prioritäten keinen Einfluss.

[Attribute] ist ab Version 5.6 verfügbar

REPEATDISTANCE [integer]

(ab Version 5.6) Das Label wird an jeder Linie von Multiline-Shapefiles wiederholt gezeichnet. Eine mehrfache Beschriftung entlang von Linien erfolgt mit einem Intervall von REPEATDISTANCE Pixel.

Das zugehörige RFC Dokument für diese Eigenschaft ist MS RFC 57: Labeling enhancements: ability to repeat labels along a line/multiline.

SHADOWCOLOR [r] [g] [b]

Farbe des Schattens.

SHADOWSIZE [x][y]

Abstand des Schattens in Pixel.

SIZE [integer]|[tiny|small|medium|large|giant]|[attribute]

• Textgröße. Bei TrueType Label erfolgt die Angabe durch ganzzahlige Werte, für Bitmap-Schriften durch Verwendung eines der aufgeführten Schlüsselworte.

• [Attribute] (ab Version 5.0) gibt die Spalte in der Attributtabelle an, die die Größenwerte enthält. Die eckigen Klammern müssen angegeben werden. Beispiel: Enthält die zugehörige Tabelle (DBF-Datei) ein Feld “MYSIZE” mit den Größenwerten für jedes Element, kann dies analog dem folgenden Beispiel benutzt werden:

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

  Das zugehörige RFC Dokument für diese Eigenschaft ist MS RFC 19: Style & Label attribute binding.

TYPE [bitmap|truetype]

Art der zu benutzenden Schrift. Bitmap-Schriften können schneller gezeichnet werden als TrueType-Schriften. TrueType-Schriften hingegen können skaliert werden und sind in einer größeren Vielfalt zu haben. Bei Benutzung von TrueType muss auch der Parameter FONT gesetzt werden.

WRAP [character]

Zeichen das durch einen Zeilenumbruch ersetzt wird. Dadurch sind mehrzeilige Label möglich. Steht im Zusammenhang mit MAXLENGTH für bedingte Zeilenumbrüche.