LABEL

ALIGN [左|中|右|属性]

5.4 新版功能.

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

[属性] 是在7.6版中添加的。如果使用属性，则该属性应为：

  • 类型的 字符串 并且应为以下之一： left ， 居中 ， 正确的 。

  • 类型的 整数 也应该是 [1，2，3] 这意味着：

    • 1=“左”

    • 2=“居中”

    • 3=“右”

如果 [属性] 类型为 整数 如上所述，由于避免了字符串比较，标签生成将会快得多。

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

  • 逆时针方向的角度，以度为单位绘制标签。默认值为0，并且必须在-360到360的范围内。

  • 自动允许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][十六进制字符串]

Removed in version 6.0: 使用 LABEL STYLE 具有`GEOMTRANSFORM LabelPoly`和 COLOR 取而代之的是。

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

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

Removed in version 6.0: 使用 LABEL STYLE 具有以下内容的对象 GEOMTRANSFORM labelpoly ， COLOR 和 OFFSET 取而代之的是。

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

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

Removed in version 6.0: 使用 LABEL STYLE 具有以下内容的对象 GEOMTRANSFORM labelpoly ， COLOR 和 OFFSET 取而代之的是。

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

缓冲区[整数]

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

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

  • 用于绘制文本的颜色。

  • r, g 和 b

    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:样式和标签属性绑定 .

编码[字符串]

Removed in version 7.0: UTF-8现在是MapServer使用的编码，数据集编码使用 LAYER ENCODING 取而代之的是。

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

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

表达式[字符串]

6.2 新版功能.

LABEL EXPRESSION 在里面 CLASS .

字体[名称属性]

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

  • [Attribute] 在版本5.6中引入以指定字体别名。

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

  • 从版本7开始，MapServer支持语言特定的字体。看见 MS RFC 98:标签/文本呈现大修 。

FORCE [True|False|组]

FORCE 是真的 PARTIALS FORCE

版本6.2中添加的编组参数确定是否允许标签与同一要素中的其他标签相交。可以使用多个样式块来代替文本或与文本一起呈现图形符号。看见 复杂多标签/符号符号 。

最大长度[整数]

5.4 新版功能.

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

与wrap关键字交互

最大长度=0

最大长度>0

wrap='char'，

始终在换行符处换行

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

没有包装

不处理

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

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

从版本7开始不支持隐含强制换行符的负MAXLENGTH，解决方法包括对此类标签进行预处理以包括换行符或换行符。必须大于0。

最大重叠角[双]

用于过滤出字符重叠的标签的角度阈值(以度为单位的浮点值)。从MapServer 6.0开始，默认情况下将启用此过滤。默认的MAXOVERLAPANGLE值将为22.5度，这也与Geoserver中的默认值匹配。用户将可以根据他们处理的数据类型以及他们对标签中不良重叠的容忍度，自由地调高或调低值。根据RFC 60，如果MAXOVERLAPANGLE设置为0，那么我们将退回到6.0之前的行为，即使用MAXOVERLAPANGLE=0.4*MS_PI(180度的40%=72度)。必须介于0到360之间。

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

maxscaledenom[双]

5.4 新版功能.

此操作的最小比例 LABEL 已经抽签了。比例尺被指定为实际比例尺分数的分母，例如，对于比例为1：24,000的地图，使用24000。必须大于或等于0。

参见

Map Scale

最大尺寸[双]

缩放文本时使用的最大字体大小(像素)。默认值为256。从5.4版开始，该值也可以是小数值(不仅是整数)。必须大于0。看见 LAYER SYMBOLSCALEDENOM 。

心态[整数]

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

MinFeatureSize[整数自动]

必须标注要素的最小大小。以像素为单位。对于线数据，使用显示的线的总长度，对于多边形要素，使用边界框的最小尺寸。“Auto”关键字告诉MapServer只标记大于其对应标签的要素。仅适用于缓存的标签。必须大于0。

Minscaledenom[双]

5.4 新版功能.

此对象的最大比例 LABEL 已经抽签了。比例尺被指定为实际比例尺分数的分母，例如，对于比例为1：24,000的地图，使用24000。必须大于或等于0。

参见

Map Scale

小尺寸[双]

缩放文本时使用的最小字体大小(像素)。默认值为4。从版本5.4开始，该值也可以是小数值(不仅是整数)。必须大于0。看见 LAYER SYMBOLSCALEDENOM 。

OFFSET [x|attribute_x] [y|attribute_y]

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

[attribute_x] 和 [attribute_y] 是在7.6版中添加的。如果使用属性，则其类型必须为 整数 。

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

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

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

见 LAYER SYMBOLSCALEDENOM .

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

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

  • r, g 和 b

    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:样式和标签属性绑定 .

大纲宽度[整数]

如果是，则轮廓的宽度 OUTLINECOLOR 已经设置好了。默认为1。当前，只有AGG渲染器支持大于1的值，并将这些值渲染为光环效果：推荐值为3或5。如果渲染器支持该渲染器并且文本大小可变，则轮廓将与文本成比例缩放，因此指定为OUTLINEWIDTH的值是与 SIZE 是指定的。必须大于0。

分词[真假]

文字可以从地图的边缘消失吗？默认值为FALSE。如果 FORCE 是真的，而且 PARTIALS 是假的， FORCE 优先，并绘制部分标签。

备注

从MapServer 7.2版本开始，默认设置从TRUE更改为FALSE。

POSITION [Ul|uc|ur|cl|cc|cr|ll|lc|lr|自动|属性]

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

与属性一起使用时，它的类型必须为 字符串 并使用以下选项之一： Ul|uc|ur|cl|cc|cr|ll|lc|lr|自动 。

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

5.0 新版功能.

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

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

5.6版中引入了[attribute]。

repeatInstance[整数]

5.6 新版功能.

标签将在多线形状的每一条线上重复，并将以重复像素的间隔沿给定线重复多次。必须大于0。

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

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

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

  • r, g 和 b

    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 [整数] | [小型|小型|中型|大型|巨型] | [属性] | [表达式]

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

    当缩放生效时（ SYMBOLSCALEDENOM 是为指定的 LAYER ） SIZE

  • 在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:样式和标签属性绑定 .

  • [表达式] 在7.6版中添加，以允许算术表达式返回整数值作为 MS RFC 124：改进MapServer中的SLD支持 。属性可以用作此表达式的一部分：

    LABEL
  TEXT "[name]"
  COLOR 255 255 255
  TYPE TRUETYPE
  FONT vera-bold
  SIZE (( [s12] * [s12] ) - 132 )
END

备注

大小值只能是整数(不是小数值)，因为渲染器Freetype只接受整数。必须大于0。

STYLE

一开始 STYLE 对象。

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

GEOMTRANSFORM [LABELCENTER|Labelpnt|LabelPoly]

6.0 新版功能.

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

  • LabelCenter将文本放置在要素的中心。

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

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

STYLE 对象。

示例-为标签绘制一个红色背景矩形，并在多边形要素中居中显示灰色文本中的“阴影”(即广告牌)：

STYLE
  GEOMTRANSFORM 'labelcenter'
  COLOR 153 153 153
END # STYLE
STYLE
  GEOMTRANSFORM 'labelpoly'
  COLOR 255 0 0
END # STYLE
../_images/label-style-center-poly.png
文本[字符串表达式]

6.2 新版功能.

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

类型[位图TrueType]

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

备注

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

换行[字符]

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

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

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