.. _label: ***************************************************************************** LABEL ***************************************************************************** .. index:: 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 :ref:`RFC11` 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: .. 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 Das zugehörige RFC Dokument für diese Eigenschaft ist :ref:`RFC19`. .. index:: pair: LABEL; ANTIALIAS 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: .. code-block:: mapfile 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 :ref:`RFC19`. 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: FORCE [true|false] Erzwingt das Zeichnen von Labels, auch wenn Kollisionen entstehen. Nur für gecachte Label verfügbar. Standard ist false. .. _MAXLENGTH: MAXLENGTH [integer] (ab Version 5.4) Anzahl der Zeichen nach denen ein Zeilenumbruch vorgenommen wird. Steht in Zusammenhang mit WRAP_ .. csv-table:: 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 :ref:`RFC40`. 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: 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: .. code-block:: mapfile 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 :ref:`RFC19`. 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 :ref:`RFC57`. 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: .. code-block:: mapfile 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 :ref:`RFC19`. 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: 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.