LEADER

目录

描述

自6.2版以来，MapServer能够为标签空间有问题的功能绘制标签线（通常在标签文本大于标记的多边形时）。此功能是通过添加的 MS RFC 81:带引线的偏移标签 .

支持的层类型

点、线、面

映射文件参数

网格步进[整数]

指定为标签行测试的位置之间的像素数。您可以从值5开始，然后根据性能增加(请参见下面的示例)。必须大于0。

最大距离[整数]

指定可以绘制引线的距正常标签位置的最大距离(以像素为单位)。您可以从值30开始，然后根据结果放置增加(请参见下面的示例)。必须大于0。

STYLE

表示开始 STYLE 对象。使用此选项设置引线样式。

Mapfile 片段

LAYER
  NAME "my-labels"
  TYPE POLYGON
  ...
  CLASS
    ...
    LABEL
     ...
    END
    LEADER
      GRIDSTEP 5 # number of pixels between positions that are tested
      MAXDISTANCE 30 # distance in pixels that leader text can be drawn
      STYLE # normal line styles are supported
        COLOR 255 0 0
        WIDTH 1
      END
    END
  END
END

示例：世界国家标签

以下示例使用多边形图层显示国家/地区标签。

备注

本例的数据和 Mapfile 可从https://download.osgeo.org/mapserver/tickets/label-leader.zip(11Mb)下载。

Mapfile 示例1

MAP

NAME "leader-test"
STATUS ON
SIZE 800 600
SYMBOLSET "../etc/symbols.txt"
EXTENT -43 10 83 83
UNITS DD
SHAPEPATH "../data"
IMAGECOLOR 255 255 255
FONTSET "../etc/fonts.txt"

WEB
  IMAGEPATH "/ms4w/tmp/ms_tmp/"
  IMAGEURL "/ms_tmp/"
END


#
# Start of layer definitions
#

LAYER
  NAME "continents"
  TYPE POLYGON
  STATUS ON
  DATA "world_countries-dissolve.shp"
  LABELITEM "NA2DESC"
  CLASS
    NAME "World Countries"
    STYLE
      COLOR 200 200 200
      OUTLINECOLOR 120 120 120
    END
    LABEL
     COLOR  0 0 0
     FONT sans
     TYPE truetype
     SIZE 8
     POSITION AUTO
     PARTIALS FALSE
     OUTLINECOLOR 255 255 255
     MINFEATURESIZE 2
     MINDISTANCE 1000
     BUFFER 5
    END
    ################################
    # Leader Object
    ################################
    LEADER
      GRIDSTEP 40
      MAXDISTANCE 1000
      STYLE
        COLOR 200 100 100
        WIDTH 2
      END
    END
  END
END


END # Map File

地图图像

../_images/leader1.png

Mapfile 示例2

这一次使用较短的最大引线（maxDistance）并增加测试数（gridStep）。

MAP

LAYER
  ...
  CLASS
    ...
    LABEL
     ...
    END
    ################################
    # Leader Object
    ################################
    LEADER
      GRIDSTEP 10
      MAXDISTANCE 100
      STYLE
        COLOR 200 100 100
        WIDTH 2
      END
    END
  END
END


END # Map File

地图图像

../_images/leader2.png