LABEL

ALIGN [left|center|right]

为多行标签指定文本对齐方式（请参见换行符）。请注意，对齐算法远不精确，因此不要期望得到出色的结果（尤其是 right 对齐）如果不使用固定宽度的字体。

5.4 新版功能.

ANGLE [double|auto|auto2|follow|attribute]

  • 逆时针角度，以度数表示，用于绘制标签。默认值为0。

  • 自动允许MapServer计算角度。仅对线条层有效。

  • Auto2与Auto相同，只是没有应用任何逻辑来防止文本以阅读方向呈现（即文本可能被颠倒呈现）。在添加指示线条方向的文本箭头时很有用。

  • 以下内容在4.10版中介绍，并告诉MapServer为适当的线性特征计算一个曲线标签（请参见 MS RFC 11：支持曲线标签 MAXOVERLAPANGLE.

  • 在5.0版中引入了[attribute]来指定要用于角度值的属性表中的项名称。需要硬括号[]。例如，如果您的shapefile的dbf有一个名为“myangle”的字段，该字段保存每个记录的角度值，则标签对象可能包含：

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

    此功能的关联RFC文档是 MS RFC 19:样式和标签属性绑定 .

抗锯齿[真假]

文本是否应消除锯齿？请注意，这需要更多可用的颜色，降低绘图性能，并导致略大的输出图像。仅对gd（gif）渲染有用。默认值为假。对其他渲染器没有效果（不能关闭消除混叠）。

背景色 [R][G][B] | [十六进制字符串]

颜色以绘制背景矩形（即广告牌）。默认情况下关闭。

注解

在6.0中删除。使用A LABEL STYLE object with GEOMTRANSFORM labelpoly 和 COLOR.

背景阴影颜色[R][G][B][十六进制字符串]

颜色以绘制背景矩形（即广告牌）阴影。默认情况下关闭。

注解

在6.0中删除。使用A LABEL STYLE object with GEOMTRANSFORM labelpoly, COLOR 和 OFFSET.

背景阴影大小[X][Y]

背景矩形应该偏移多远？默认值为1。

注解

在6.0中删除。使用A LABEL STYLE object with GEOMTRANSFORM labelpoly, COLOR 和 OFFSET.

缓冲区[整数]

标签周围填充，以像素为单位。用于保持文本周围的间距以增强可读性。仅适用于缓存标签。默认值为0。

颜色[R][G][B][十六进制字符串][属性]

  • 用于绘制文本的颜色。

  • ` r`、`g`和'b`应为整数[0..255]。要指定绿色，请使用以下内容：

    COLOR 0 255 0

  • hexadecimal string 可以是

    • RGB值：“rrggbb”。要指定洋红色，请使用以下选项：

      COLOR "#FF00FF"

    • rgba值（添加半透明）：“rrggbbaa”。要指定半透明品红色，请使用以下选项：

      COLOR "#FF00FFCC"

  • 在5.0版中引入了[attribute]来指定要用于颜色值的属性表中的项名称。需要硬括号[]。例如，如果您的shapefile的dbf有一个名为“mycolor”的字段，该字段保存每个记录的颜色值，则标签对象可能包含：

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

    此功能的关联RFC文档是 MS RFC 19:样式和标签属性绑定 .

编码[字符串]

支持用于标签的编码格式。如果不支持该格式，则不会绘制标签。需要ICONV库（大多数系统上都有）。如果库存在于系统上，则始终会检测到库，但如果不存在，则不会绘制标签。

需要在MapServer中显示国际字符。更多信息可在 Label Encoding document .

7.0 版后已移除: 远离的。UTF-8现在是MapServer使用的编码，数据集编码使用 LAYER ENCODING.

表达式 [字符串]

LABEL EXPRESSION 在里面 CLASS .

6.2 新版功能.

字体[名称属性]

  • 字体别名（在字体集中定义）用于标记。

  • 在5.6版中引入了[attribute]来指定字体别名。

  • 如果字形在字体中不可用，则可能包含以逗号分隔的最多MS_max_label_字体（通常为5个）字体别名列表，用作支持该字体的渲染器中的回退字体。如果直接指定，请确保用引号将列表括起来。见 MS RFC 80:字体回退支持 .

  • 自版本7以来，MapServer支持特定于语言的字体。见 MS RFC 98:标签/文本呈现大修 .

力[真假]

强制打开特定类的标签，而不考虑冲突。仅适用于缓存标签。默认值为假。如果“force”为真，“partials”为假，则“force”优先，并绘制部分标签。

最大长度[整数]

此关键字与wrap_u关键字交互，因此换行符只出现在定义的字符数之后。

与wrap关键字交互

最大长度=0

最大长度>0

wrap='char'，

始终在换行符处换行

在最大长度字符后的第一个换行符处换行

没有包装

不处理

如果包含超过maxlength_u个字符，则跳过标签

此功能的关联RFC文档是 MS RFC 40：支持标签文本转换 .

5.4 新版功能.

不支持隐含强制换行符的负maxlength，因为版本7，解决方法意味着预处理此类标签以包括换行符或换行符。

最大重叠角[双]

用于筛选角度的角度阈值跟随字符重叠的标签（以度为单位的浮点值）。默认情况下，将从MapServer 6.0开始启用此筛选。默认的maxoverlappangle值将为22.5度，这也与geoserver中的默认值匹配。用户可以根据他们所处理的数据类型和对标签中错误重叠的容忍度自由地上下调整值。根据RFC 60，如果maxoverlappangle设置为0，那么我们将回到6.0之前的行为，即使用maxoverlappangle=0.4*ms_pi（180度的40%=72度）。

此功能的关联RFC文档是 MS RFC 60：标签增强：能够跳过字符重叠过多的角度跟踪标签 .

maxscaledenom

最小刻度 LABEL 画出来。比例作为实际比例分数的分母给出，例如，对于比例为1:24000的地图，使用24000。

5.4 新版功能.

参见

Map Scale

最大尺寸[双]

缩放文本时使用的最大字体大小（像素）。默认值为256。从5.4版开始，该值也可以是一个分数值（不仅是整数）。见 LAYER SYMBOLSCALEDENOM .

心态[整数]

重复标签之间的最小距离。以像素为单位。从7.2版开始，从标签边界开始计算距离。以前的版本使用标签中心。

MinFeatureSize[整数自动]

必须标记功能的最小尺寸。以像素为单位。对于线数据，使用显示线的总长度，对于多边形特征，使用边界框的最小尺寸。”auto“关键字告诉mapserver只标记大于其相应标签的功能。仅可用于缓存标签。

MINSCALEDENOM [double]

最大刻度 LABEL 画出来。比例作为实际比例分数的分母给出，例如，对于比例为1:24000的地图，使用24000。

5.4 新版功能.

参见

Map Scale

小尺寸[双]

缩放文本时使用的最小字体大小（像素）。默认值为4。从5.4版开始，该值也可以是一个分数值（不仅是整数）。见 LAYER SYMBOLSCALEDENOM .

偏移[ x] [y]

标签相对于标签左下角和标签点的偏移值。以像素为单位。在旋转文本的情况下，指定值，就像所有标签都是水平的一样，任何旋转都将得到补偿。

与“跟随角度”一起使用时，有两个附加选项可用于渲染与原始特征平行的标签：

  • 偏移量X-99：将根据X符号将标签呈现到功能的左侧或右侧。

  • 偏移量x 99：根据x的符号，将呈现功能上方或下方的标签。

见 LAYER SYMBOLSCALEDENOM .

outlinecolor[r][g][b] [十六进制字符串][属性]

  • 颜色以在文本中的字符周围绘制一个像素轮廓。

  • ` r`、`g`和'b`应为整数[0..255]。要指定绿色，请使用以下内容：

    OUTLINECOLOR 0 255 0

  • hexadecimal string 可以是

    • RGB值：“rrggbb”。要指定洋红色，请使用以下选项：

      OUTLINECOLOR "#FF00FF"

    • rgba值（添加半透明）：“rrggbbaa”。要指定半透明品红色，请使用以下选项：

      OUTLINECOLOR "#FF00FFCC"

  • 在5.0版中引入了[attribute]来指定要用于颜色值的属性表中的项名称。需要硬括号[]。例如，如果您的shapefile的dbf有一个名为“myoutcolor”的字段，该字段保存每个记录的颜色值，则标签对象可能包含：

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

    此功能的关联RFC文档是 MS RFC 19:样式和标签属性绑定 .

大纲宽度[整数]

如果已设置大纲颜色，则为大纲的宽度。默认值为1。目前，只有agg渲染器支持大于1的值，并将这些值呈现为“光环”效果：建议值为3或5。如果渲染器支持它，并且文本大小是可变的，则轮廓将按比例缩放到文本，因此指定为outline width的值是指定大小_u的相同比例的宽度。

分词[真假]

文本能从地图边缘跑掉吗？默认值为true。如果“force”为真，“partials”为假，则“force”优先，并绘制部分标签。

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

标签相对于标签点的位置（仅限图层）。第一个字母是“Y”位置，第二个字母是“X”位置。auto“告诉mapserver计算一个不会干扰其他标签的标签位置。对于点，MapServer从8个外部位置（即不包括CC）中进行选择。对于多边形，mapserver从cc（添加在mapserver 5.4中）、uc、lc、cl和cr中选择尽可能多的位置。对于线，它只使用lc或uc，直到找到一个与已经绘制的标签不冲突的位置。如果所有位置都导致冲突，则不会绘制标签（除非标签的强制_ua参数设置为“真”）。“自动”放置仅对缓存标签可用。

优先级[整数][项目名称][属性]

priority参数采用介于1（最低）和10（最高）之间的整数值。默认值为1。也可以使用[项目名称]周围的方括号将优先级绑定到属性（项目名称）。例如，“优先级[someattribute]”

标签存储在标签缓存中，并按优先级顺序呈现，首先呈现最高优先级。在 Mapfile 中指定超出范围的优先级值将导致分析错误。通过mapscript设置的或来自形状属性的超出范围的值将在渲染时被钳制为最小/最大值。使用标签优先级对性能没有预期的影响。

5.6版中引入了[attribute]。

5.0 新版功能.

repeatInstance [整数]

标签将在多行形状的每一行上重复，并沿给定行以重复像素间隔重复多次。

此功能的关联RFC文档是 MS RFC 57：标签增强：沿行/多行重复标签的能力 .

5.6 新版功能.

阴影颜色[R][G][B][十六进制字符串]

放置阴影的颜色。在绘制主标签之前，具有相同文本的标签将呈现此颜色，从而对标签字符产生阴影效果。渲染阴影的偏移使用shadowSize设置。

  • ` r`、`g`和'b`应为整数[0..255]。要指定绿色，请使用以下内容：

    SHADOWCOLOR 0 255 0

  • hexadecimal string 可以是

    • RGB值：“rrggbb”。要指定洋红色，请使用以下选项：

      SHADOWCOLOR "#FF00FF"

    • rgba值（添加半透明）：“rrggbbaa”。要指定半透明品红色，请使用以下选项：

      SHADOWCOLOR "#FF00FFCC"
阴影大小[X][Y][属性][属性][X][属性][属性][Y]

阴影偏移（像素），请参见阴影颜色。

[attribute]是在6.0版中引入的，可以如下使用：

SHADOWSIZE 2 2
SHADOWSIZE [shadowsizeX] 2
SHADOWSIZE 2 [shadowsizeY]
SHADOWSIZE [shadowsize] [shadowsize]
SIZE [integer]|[tiny|small|medium|large|giant]|[attribute]

  • 文本大小。使用数字给出基于TrueType字体的标签的像素大小，或位图字体的其他5个列出的关键字中的任何一个。

    当缩放生效时（ symbolscaledenom<symbolscaledenom>`为 :ref:`layer）指定，size`为要在地图缩放1中使用的字体大小：`symbolscaledenom。

  • 在5.0版中引入了[attribute]来指定要用于大小值的属性表中的项名称。需要硬括号[]。例如，如果您的shapefile的dbf有一个名为“mySize”的字段，该字段保存每个记录的大小值，则标签对象可能包含：

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

    此功能的关联RFC文档是 MS RFC 19:样式和标签属性绑定 .

注解

大小值只能是整数（而不是小数），因为呈现器freetype只接受整数。

STYLE

一开始 STYLE 对象。

标签的特定机制 STYLE 对象是geomtransform选项：

土工转换

创建可用于设置标签样式的几何图形。不适用于角度跟随标签。

  • labelpnt在标签附着的地理位置上绘制一个标记。只有当标签位于CC位置时，这才对应于标签文本的中心。

  • labelpoly为文本生成边框，在所有方向添加1个像素的填充。

STYLE 对象。

示例-为标签（即广告牌）绘制一个红色背景矩形，其中“阴影”为灰色：

STYLE
  GEOMTRANSFORM 'labelpoly'
  COLOR 153 153 153
  OFFSET 3 2
END # STYLE
STYLE
  GEOMTRANSFORM 'labelpoly'
  COLOR 255 0 0
END # STYLE

6.0 新版功能.

文本[字符串表达式]

要为要素添加标签的文本（在使用多个标签时很有用）。覆盖从中获取的值 LAYER LABELITEM 以及 CLASS TEXT. See TEXT 在里面 CLASS .

6.2 新版功能.

类型[位图TrueType]

要使用的字体类型。通常，位图字体的绘制速度比TrueType字体快。但是，TrueType字体具有可扩展性，可以在各种面中使用。如果选择TrueType，请确保设置字体参数。

注解

位图字体仅受agg和gd渲染器支持。

换行[字符]

在标签文本中表示行尾条件的字符，从而产生多行标签。与maxlength_u交互，在给定的字符数后进行条件换行。

启用“换行”后，标签也将以零宽度的Unicode字符（0x200b）换行。例如，允许在连字符后换行，而不删除换行处的连字符。您可以在Postgis查询中使用“replace（field，”-“，e”-u200b”）插入此字符。

7.2.1 新版功能: 在零宽度空间包装