2.8. 地图中的注记¶

生成地图时，MapServer会自动执行多个任务。它可以注释特征并防止相邻尺寸之间的冲突，它提供位图和TrueType字体的使用。

2.8.1. 查看示例¶

http://webgis.cn/cgi-bin/mapserv?map=/owg/mfa4.map&layer=states_poly&layer=states_line&mode=map

MapServer有一个非常灵活的注释引擎。它支持本地位图和TrueType字体。字体缩放使用TrueType支持，尺寸的角度和位置可以自定义。

以下是Mapfile(mfa4.map)：

MAP
    IMAGETYPE "PNG"
    EXTENT -180 -90 180 90
    SIZE 600 300
    SHAPEPATH "/gdata"
    IMAGECOLOR 255 255 255
    FONTSET "../fonts/fonts.list"
    LAYER
        NAME "states_poly"
        DATA "wcountry.shp"
        STATUS OFF
        TYPE POLYGON
        LABELITEM "NAME"
        CLASS
            NAME "States"
            STYLE
                COLOR 232 232 232
            END
            LABEL
                COLOR 132 31 31
                SHADOWCOLOR 218 218 218
                SHADOWSIZE 2 2
                TYPE TRUETYPE
                FONT "arial-bold"
                SIZE 8
                ANTIALIAS TRUE
                POSITION CC
                PARTIALS FALSE
                MINDISTANCE 300
                BUFFER 4
            END
        END
    END
    LAYER
        NAME "states_line"
        DATA "wcountry.shp"
        STATUS OFF
        TYPE LINE
        CLASS
            NAME "State Boundary"
            STYLE
                COLOR 132 132 32
            END
        END
    END
END

带注记的 Mapfile

文件包含的字体别名字体位置由 FONTSET 关键字分配。

要在shapefile中使用属性标注每个城区，请将名称确定为的值 LABELITEM 关键字。渲染国家/地区要素时，要素的值 NAME 属性将用于创建标签。

如果想看shapefile，有几种方法。可以在Excel或其他可以读取DBF文件的电子表格程序中打开关联的DBF文件，可以看到要素属性值。如果只想找出属性的名称，可以使用实用程序dbfinfo，它是shapelib库的一部分。此外，该应用程序 ogrinfo 提供地理信息以及要素值。

每个地区将使用027至030中指定的标签参数进行标签。Label对象以关键字Label开始，以关键字End结束(第030行)。LABELITEM值设置为‘NAME’的Layer对象。选择属性名称作为标签文本的来源。每个标签都将绘制为黑色，并且其大小将很小。除了小号，还可以选择小号、中号、大号或大号。

按对象划分的MapFile结构如下所示：

                                  MAP
      (states_poly) LAYER----------|---------LAYER (states_line)
     (land) CLASS-----|-CLASS (water)        |-CLASS
        STYLE-|-LABEL   |-STYLE                |-STYLE

文件的更改如下：

Open the file:diff_mfa4_mfa3.html

2.8.2. 批注参数说明¶

在这里，我们介绍几个参数和尺寸对象：

FONTSET "../fonts/fonts.list"

在这里，我们为TrueType字体列表(或字体的完整路径集)指定文件。该文件列出了每种可用的字体。有关详细信息，请参见文件本身和《 Mapfile 参考》。FONTSET的map对象是一个参数。

此文件的内容如下：

# This be the fonts list
arial                           Vera.ttf
arial-bold                      VeraBd.ttf
arial-italic                    VeraIt.ttf
arial-bold-italic               VeraBI.ttf
times                           VeraSe.ttf
times-bold                      VeraSeBd.ttf
andale-mono                     VeraMono.ttf
vera_sans                       Vera.ttf
vera_sans-bold                  VeraBd.ttf
vera_sans-italic                VeraIt.ttf
vera_sans-bold-italic           VeraBI.ttf
vera_sans_mono                  VeraMono.ttf
vera_sans_mono-bold             VeraMoBd.ttf
vera_sans_mono-italic           VeraMoIt.ttf
vera_sans_mono-bold-italic      VeraMoBI.ttf
vera_serif                      VeraSe.ttf
vera_serif-bold                 VeraSeBd.ttf
simsun                       simsun.ttc

LABELITEM

在 "STATE" 情况下，指定的数据属性用于批注。 LABELITEM 是Layer对象的参数。

LABEL 标志着定义的开始 LABEL 物体。标注对象可用于其他对象(即比例尺对象)

COLOR 对象，则指定详图索引文本的颜色。

SHADOWCOLOR 指定标注文字的阴影颜色。

SHADOWSIZE 指定阴影的大小。该值对应于 X 和 Y 。因此， 2 表示两个像素宽乘两个像素高。

TYPE 在标签对象中，类型指定要使用的字体类型，有TrueType或Bitmap(内置字体)可供选择，可选择 TRUETYPE 。

FONT 如果指定为TrueType，则需要指定要使用的字体。这里提到的值是“alias”；字体列表文件中的“alias”。

SIZE 如果使用TrueType字体，则以像素为单位的值是尺寸大小。如果是位图，就说“小”或“大”之类的东西。

ANTIALIAS 这将打开或关闭Truetype抗锯齿。请记住，该值不是 OPEN 或 CLOSE ，但 TRUE 或 FALSE 。

POSITION 定位标签文本的标签点。该值是垂直和水平位置的组合。有以下选项： C 对于中心垂直对齐， U 对于上层，和``L`` 越低越好。对于水平对齐，有以下选项： C 对于中锋， L 用于左侧，以及 R 这是对的。因此，要调用标注ID的中心进行文本对齐，请使用值 CC (中心-中心)。或者，如果希望它是左下角的ID，可使用 LL 。另一种方法是让MapServer决定标签的最佳位置。为此，可使用 AUTO 价值。

PARTIALS 告知MapServer是否生成不完整的标签文本。这里的默认设置是不生成标签文本的片段。该值为 TRUE 或 FALSE 。

MINDISTANCE 重复批注之间的最小距离(以像素为单位)。查看如果增大或减小该值会发生什么情况。

BUFFER 标注的填充(像素)。这用于提高可读性。4个像素的缓冲区意味着不会在彼此的4个像素上绘制任何标签。再说一次，改变一下，看看它是如何运作的。