8.2. 地图对象¶

Map对应于MapFile中的“根”，它包含所有其他对象，是应用程序级别的映射级参数。

第一部分列出了一些常规参数，详细参数将在后面的小节中解释。

8.2.1. 一般参数说明¶

常用地图设置¶

名称：生成地图、比例尺和GIF图例文件名的前缀，应尽可能短。价值： [name] 。
单位：地图坐标的单位。价值： [feet|inches|kilometers|meters|miles|dd] 。
范围：要创建的地图的空间范围。MapServer可以在运行时获取对应的值，建议指定对应的值。价值： [minx] [miny] [maxx] [maxy]
状态：~图是否为~ACTIVE标志。当其值处于禁用状态时，相应的贴图将用作底图或比例尺。价值： [on|off] 。
FONTSET：字体文件的名称(包括路径)。可以使用绝对路径或相对路径。提示：值以斜杠开头( / )。价值： [path/filename.ext 。
SYMBOLSET：符号文件的名称(包括路径)。可以使用绝对路径或相对路径。提示：值以斜杠开头( / )。价值： [path/filename.ext] 。
SHAPEPATH：Shapefile或平铺的路径。可以是相对于当前MapFile文件的绝对路径或相对路径。

示例：

# =======================================================
# General Settings of the MapFile:
# NAME: Name of the Map [keep short!]
# EXTENT of the Map: minY minY maxX maxY
# STATUS: normally on, just use for testing
# SHAPEPATH: Path to the root dir of the data
# =======================================================

NAME "hangzhou"
UNITS METERS
EXTENT 745000 156000 758000 165000
STATUS ON
FONTSET d:/mapserver/sym_fonts/fonts.txt
SYMBOLSET d:/mapserver/sym_fonts/shade.sym
SHAPEPATH d:/gis_data/hangzhou/

常规输出(输出)设置¶

ImageType：~输出格式。它的值必须与用户定义的~OUTPUTORMAT部分中的Name值匹配，或对应于内部支持的格式。价值： [gif|png|jpeg|wbmp|gtiff|swf|userdefined]
SIZE: _OutputThe size of the Map, in pixels. Value: [x] [y].
分辨率：每英寸像素数，其值只影响比例计算，缺省值为72。~值：~ [integer] 。
Web：Web对象的开始标记，Web对象定义Web界面的操作方式。
QUERYMAP：QUERYMAP对象的开始标签，QUERYMAP对象定义处理(地图)查询结果的显示效果等。

示例：

# ======================================================= # General
Output Settings of the MapFile:
# OUTPUTFORMAT specifications
# SIZE of the output map in pixel
# WEB: output location definition
# QUERYMAP: highlight color of selected objects
# =======================================================
IMAGETYPE PNG
SIZE 600 518
WEB
  IMAGEPATH "/home/gronline/mapimage/"
  IMAGEURL "/mapimage/"
END
QUERYMAP
  COLOR 255 0 0
  STYLE hilite
END

组件：基准、图例和比例尺(参考地图、图例、比例尺)¶

可以在MapFile文件中定义以下组件：

图1鹰眼示意图

Reference：Reference Map对象的开始标记~。~参考地图是在主窗口中显示地图位置的鹰眼地图。
图例：图例对象的开始标记。~它定义了图例的生成方式。为~类对中的每个层自动生成相应的图例组件。
SCALEBAR：ScaleBar对象的开始标记。它定义了地图比例工具栏的生成方式。

比例尺工具栏

示例：

# ================================================================
# Components: Reference Map, Legend, Scale Bar
# ================================================================
# ------------------------------------
# Reference Map Definition
# ------------------------------------
REFERENCE
  IMAGE images/overview_wormerl.png
  EXTENT 114052 499083 124436 505124
  STATUS ON
  COLOR -1 -1 -1
  OUTLINECOLOR 255 0 0
  SIZE 150 130
END
# ------------------------------------ # Legend Definition
# ------------------------------------
LEGEND
  STATUS embed
  POSITION ur
END
# ------------------------------------
# Scale Bar Definition
# ------------------------------------

地图定义¶

本部分包括在从层生成地图的过程中进行投影的说明。

Layer：Layer对象的开始标识符。MapFile文件中应该至少有一个层，该层用于生成地图。各层在地图上的显示顺序是颠倒的(底部的第一个层，顶部的最后一个层)；有关详细信息，请参阅层部分。
投影：投影对象的起始标识符。您应该定义两种类型的投影对象。一个是输出图像的投影(在Map对象中定义)，另一个是在没有层的情况下定义的。如果数据的投影都是相同的，那么您不需要定义任何投影，除非您想要进行投影转换。

很少使用的参数¶

CONFIG：~用于配置EPSG文件在~PROJ.4库中的位置。使用此配置允许PROJ.4使用您指定的文件。这样做的好处之一是可以避免设置相应的环境变量。例如： CONFIG PROJ_LIB /tmp/proj/ 。设置其他值将传递给 CPLSetConfigOption() 这样您就可以控制GDAL和OGR驱动程序的行为。有关详细信息，请参阅GDAL文档。价值： [key] [value] 。
DATAPATTERN：它定义一个正则表达式，该正则表达式将应用于通过URL请求更改数据参数的请求(即 map_layername _data=... ).如果模式不存在，那么网络用户就不能通过URL来摆弄支持文件。这允许您根据需要将一个应用程序与另一个应用程序隔离，默认操作非常保守。另请参阅下面的TEMPLATEPATTERN。值：[正则表达式
调试：启用对映射对象的调试。系统操作的详细信息将输出到Web对象指定的日志文件中。有关详细信息，请参阅调试部分。
IMAGECOLOR：初始化地图的颜色，如背景颜色。启用透明度(启用透明)时，指定的颜色将应用于透明区域。值： [r] [g] [b] 。
SACLE：地图的计算比例。通常在程序中使用，而不是在 Mapfile 中使用。
TEMPLATEPATTERN：它定义一个正则表达式，该正则表达式将应用于通过URL请求(即)更改模板参数的请求 map_layername_template=... ).如果模式不存在，那么网络用户就不能通过URL来摆弄支持文件。这允许您根据需要将一个应用程序与另一个应用程序隔离，默认操作非常保守。另请参阅上面的DATAPATTERN。价值： [regular expression]

8.2.2. 输出格式对象¶

一般情况下，在定制输出格式时，需要使用ImageType关键字OUTPUTFORMAT对象。仅当您需要更改默认输出格式时才进行设置，设置前应参考：

图像的大小对图像的性能(生成图像和传输图像所需的时间)有很大的影响。使用256色模式生成的图像比使用RGB模式生成的图像小。
根据数据的不同，您应该考虑使用不同的颜色深度。例如，如果使用卫星图像或航空图像，则应使用RGB模式生成图像。在这种情况下，使用JPEG生成的图像比使用PNG24生成的图像小得多。
使用JPEG输出时，可以使用质量选项来减小图像大小。
使用GD或AGG图像库。

GD和AGG图像库¶

GD是一个用于动态创建图像的开源库。GD可以创建PNG、JPEG、GIF等格式的图像。支持GRAW生成GIF图像。然而，自被Unisys收购以来，它一直在非正式地支持“Graphics Drawing”。

反颗粒几何(AGG)是一个使用C++开发的高质量2D图像渲染库。它具有抗锯齿和亚像素分辨率。这使您可以创建高质量的图像。MapServer5.0及其更高版本支持AGG。对于同一个MapFile，可以使用AGG进行渲染或使用GD进行渲染。

图2经AGG处理的图像

输出¶

一个MapFile可以定义一个或多个OUTPUTFORMAT对象，支持的输出格式包括PNG、GIF、JPEG、GeoTiff、Flash等。

对各种格式的支持取决于编译程序时使用的库。GeoTiff需要GDAL库的支持¶

Flash(SWF)需要明库的支持。

名称：MapFile的ImageType中使用的输出格式的名称。价值： [name] 。
驱动程序：生成相应格式的输出驱动程序名称。如果驱动程序支持多种格式，则格式的定义是固定的。例如，GD的驱动程序名称可以是 GD/Gif ， GD/PNG ， GD/WBMP 和 GD/JPEG ；Flasf的驱动程序名称为SWF。GDAL的驱动程序名称是GDAL/GTiff。可以使用GDAL或GD(GD更高效)生成PNG、JPEG、GIF。价值： [name]
IMAGEMODE：生成输出图像的图像模式。并非所有非栅格图像都与Flash相同。并非所有支持的格式都具有所有组合。例如，GD/GIF只支持PC256。
1. PC256：~使用~256色(MapServer的传统模式)生成假彩色图像
2. RGB：以24位REB/绿色/蓝色模式渲染图像。支持所有颜色，但不支持透明度。
3. RGBA：以24位REB/绿色/蓝色/Alpha模式渲染图像。支持所有颜色，并支持透明度。
4. INT16：使用16作为整数位深度来呈现单频带数据。目前仅对使用GDAL的栅格图像和WMS层有效。
5. FLOAT32：~呈现浮点(FLOAT)位深度为~32的单带数据。目前仅对使用GDAL的栅格图像和wms层有效。价值： [PC256/RGB/RGBA/INT16/FLOAT32]
MIMETYPE：通过网络返回给客户端的数据所使用的MIME类型。价值： [type] 那就是。

示例：

MIMETYPE "application/x-shockwave-flash"
MIMETYPE "application/x-pdf"
MIMETYPE "image/gif"
MIMETYPE "image/jpeg" MIMETYPE "image/png"

扩展名：为相应文件类型的文件生成后缀，如.png、.gif等。值： [type] 。
透明：使用此参数指示是否为此格式的图像启用透明度。注意：当IMAGEMODE为RGB时，透明度不可用，并非所有格式都支持透明度。使用透明度时，在透明区域会生成8位伪彩色图像，因此用此颜色填充地图的其他部分也将是透明的，因此应使用合适的颜色作为背景颜色。
FORMATOPTION：驱动程序或格式的可选参数。OUTPUTFORMAT的定义中可以出现零个或多个FORMATOPTION。

-gd/jpeg：可以使用“quality=n”选项设置jpeg图像的生成质量。值的范围从0到100。-gd/png：“隔行扫描= [ON/OFF] “，设置是否以隔行扫描的方式呈现图像。-GDAL/GIF：“隔行扫描= [ON/OFF] “，设置是否以隔行扫描的方式呈现图像。-GDAL/GTiff：~支持的参数如下~-TILED=YES-BLOCKXSIZE=n-BLOCKYSIZE=n-交织= [PIXEL/BAND] -压缩= [NONE,PACKBITS,JPEG,LZS,DEFAULT]
GDAL：所有格式操作都使用GDAL进行处理。有关详细信息，请参阅GDAL文档。价值： [option] 。如果定义的OUTPUTFORMAT未在映射文件中定义，则程序将隐式使用它。

以下定义如下：

与AGG文库相关：

OUTPUTFORMAT
  NAME 'AGG_PNG'
  DRIVER AGG/PNG
  IMAGEMODE RGB
  FORMATOPTION "QUANTIZE_FORCE=ON"
  FORMATOPTION "QUANTIZE_DITHER=OFF"
  FORMATOPTION "QUANTIZE_COLORS=256"
END

OUTPUTFORMAT
  NAME 'AGG_JPEG'
  DRIVER AGG/JPEG
  IMAGEMODE RGB
  FORMATOPTION "QUALITY=100"
END

与GD图形库相关：

OUTPUTFORMAT
  NAME **gif**
  DRIVER "GD/GIF"
  MIMETYPE "image/gif"
  IMAGEMODE PC256
  EXTENSION "gif"

END

OUTPUTFORMAT
  NAME **png**
  DRIVER "GD/PNG"
  MIMETYPE "image/png"
  IMAGEMODE PC256
  EXTENSION "png"
END

OUTPUTFORMAT
  NAME **png24**
  DRIVER "GD/PNG"
  MIMETYPE "image/png"
  IMAGEMODE RGB
  EXTENSION "png"
END

OUTPUTFORMAT
  NAME **jpeg**
  DRIVER "GD/JPEG"
  MIMETYPE "image/jpeg"
  IMAGEMODE RGB
  EXTENSION "jpg"
END

OUTPUTFORMAT
  NAME **wbmp**
  DRIVER "GD/WBMP"
  MIMETYPE "image/wbmp"
  IMAGEMODE PC256
  EXTENSION "wbmp"
END

OUTPUTFORMAT
  NAME **swf**
  DRIVER "SWF"
  MIMETYPE "application/x-shockwave-flash"
  EXTENSION "swf"   IMAGEMODE PC256
  FORMATOPTION "OUTPUT\_MOVIE=SINGLE"
END

OUTPUTFORMAT
  NAME **GTiff**
  DRIVER "GDAL/GTiff"
  MIMETYPE "image/tiff"
  IMAGEMODE RGB
  EXTENSION "tif"
END

8.2.3. Web对象¶

定义Web界面运行时的参数。至 WEB 开始于 END 结束。

IMAGEPATH：存储临时图像的临时目录。它必须在Web服务器运行时可用。它必须以斜杠开头 / 。价值： [path
IMAGEURL：访问存储在IMAGEPATH下的临时映像的虚拟路径。价值： [url|virtual directory]
空：查询失败时重定向到的URL。如果未定义任何值，它将重定向到~Error定义的URL。价值： [url]
Error：发生错误的URL。如果未定义，将输出MapServer的错误消息。价值： [url]
日志：存储系统日志的文件，在Web服务器运行时必须可用。价值： [filename]
MINSASLE：最小伸缩性。当用户请求的值小于该值时，将返回该比例的图像。价值： [double] 。
MINTEMPLATE：在最小比例之上使用的模板，这对于嵌套应用程序很有用。(如果高于应用程序的最小比例，则使用模板，用于嵌套应用程序)值： [file|url]
MAXSCALE：最大缩放比。当用户请求大于此值的值时，将返回此比例的图像。价值： [double] 。
MAXTEMPLATE：当最大比例大于时使用的模板，这对于嵌套应用程序很有用。(超过应用程序的最大比例时要使用的模板，对于嵌套应用程序很有用。)价值： [file|url ]。
模板：用于以交互模式表示结果的模板文件或URL。价值： [file|url] 。
Header：首先发送到客户端的模板文件。仅在多结果查询模式下使用。(在发送其他所有内容之前使用的模板。仅限多结果查询模式)。价值： [filename]
页脚：最终发送到客户端的模板文件。仅在多结果查询模式下使用。(在发送其他所有内容之前使用的模板。仅限多结果查询模式)。价值： [filename]
元数据：使用该标识符来存储任意键-值对。通常在配置OGC WMS时使用。它在创建模板时也非常灵活，此处输入的任何内容都可以通过模板转换获得。示例：

元数据标题《中国图》作者《燕鸣》完

示例：

WEB
    IMAGEPATH "f:/mapserver/mapimages/"
    IMAGEURL "/mapimages/"
    ERROR http://www.mapserver.ch/mapserver/ms_error.htm
    EMPTY http://www.mapserver.ch/mapserver/ms_empty.htm
    LOG f:/mapserver/logs/mapserver.log
END

8.2.4. QUERYMAP对象¶

定义查询结果的呈现方式

颜色：功能高亮显示的颜色，默认为黄色。价值： [r] [g] [b]
大小：贴图的大小，以像素为单位。默认大小为贴图对象中定义的大小。价值： [x][y]
状态：是否显示查询获取的地图。
Style：设置查询获取地图的逼真方式。不会处理未选择的地图或地图部件。
- 法线：以原始层的样式渲染层。
- Hilite：使用颜色值渲染选定的层。
- 选定：仅显示选定的层

价值： [normal|hilite|selected]

示例：

QUERYMAP
COLOR 255 0 0
STYLE hilite
END

8.2.5. 参考对象参考贴图¶

它是在主窗口中显示地图位置的预览。

以引用开始，以结束结束。支持三种类型的参考地图。最常见的是在预览中显示与之交互的地图的范围。也可以将参考地图作为查询的一部分。点查询将在查询点上生成一个图标(带有标记的图像)；面查询将突出显示查询区域；给予特征的查询将显示选定的部分。

图像：参考地图图像的名称(包括路径)，可以是绝对路径或相对路径。价值： [path/filename.ext]
Size：参考地图图像的像素大小
EXTENT: ~The spatial extent of the image. Value: ~[minx] [miny] [maxx] [maxy]
状态：~是否创建~引用地图，默认为关闭。价值： [on | off]
COLOR: The fill color of the corresponding BOX range, the default is red. A value of -1 is transparent. Value: [r] [g] [b]
OUTLINECOLOR: ~ corresponds to the color of the border of ~BOX, the default is black, when the value is -1, there is no border. ~value: ~[r] [g] [b]
标记：当相应的范围变得很小时显示的标记(从符号文件中获取)，默认为十字标记。~值：~ [integer | string]
MARKERSIZE：~定义替换~框的符号的大小。价值： [integer]
MINBOXSIZE：~当~box小于MINBOXSIZE时，使用标记和MARKERSIZE显示。~值：~ [integer]
MAXBOXSIZE：当长方体大于MINBOXSIZE时，不渲染任何内容。价值： [integer]

示例：

# ------------------------------------
# Reference Map Definition
# ------------------------------------
REFERENCE
  IMAGE images/overview\_wormerl.png
  EXTENT 114052 499083 124436 505124
  STATUS ON
  COLOR -1 -1 -1
  OUTLINECOLOR 255 0 0
  SIZE 150 130
END

8.2.6. 对象，有三种方法可以创建图例。¶

简单图像图例：就像使用桌面图形系统一样生成图例。这种方法非常简单，但也有很大的局限性。
使用HTML模板的图例：~是使用~MapServer自动创建图例的复杂方法。
纯HTML图例：~手动编译图例~HTML文件。这种方法很自由，但需要对应的Html文件，更新起来很麻烦。

简单的图像图例 **¶

定义图例文件的生成模式，类对象为每个单独的高亮显示创建相应的图例组件。以传说开始，以结束结束。图例图像的大小在创建之前并不是未知的，因此不要使用 <img> 标签中硬编码图像的宽度和高度。

IMAGECOLOR: ~ The initial color of the legend (eg background color). Value: ~[r] [g] [b].
Label：标签对象的开始标识符。
OUTLINECOLOR: The color of the symbol border. Value: [r] [g] [b]
位置：~图例在地图上的位置。默认为~LR。价值： [ul|uc|ur|ll|lc|lr]
KEYSIZE: The legend box in pixels, the default is 20 X 10. Value: [x] [y]
KEYSPACING: The space between the ~ symbols, the default is ~5 X 5. Value: [x] [y]
POSTLABELCACHE：~告诉~MapServer在呈现所有标签后呈现图例。在添加同类元素时非常有用。默认为False。价值： [true|false]
状态：是否创建此图例。值：启用 |off| 嵌入]

例1：

# ------------------------------------
# Legend Definition
# ------------------------------------
LEGEND
    STATUS embed
    POSITION ur
END

此图例是为所有层自动创建的，图例包含层名称。

示例2：

LAYER
 NAME "Restaurants"
 STATUS ON
 TYPE POINT
 DATA "restaurants.shp"
  CLASS
   NAME "Restaurants"
   COLOR 255 127 127
   SIZE 14
   SYMBOL "restaurants"
 END
END

这个图例将创建一个带有“Restaurants”符号和餐馆文本的图例。

如下所示：

使用模板的图例¶

MapServer3.5版及更高版本可以使用模板文件生成图例。在MapFile中，模板参数在文件中使用，以启用基于模板的图例生成。设置模板文件，该文件将替换主HTML所引用的内容 [legend] 标记在文件中。模板文件必须具有。HTML扩展名。

HTML图例模板文件¶

HTML图例模板文件包含0个或以下某个标记，程序将使用相应的标记

生成图例：

\[leg\_group\_html\] ... \[/leg\_group\_html\]
\[leg\_layer\_html &lt;OPTIONAL PARAMS&gt;\] ... \[/leg\_layer\_html\]
\[leg\_class\_html &lt;OPTIONAL PARAMS&gt;\] ... \[/leg\_class\_html\]

图例文件中除上面的标注对之外的所有内容都将被忽略

组块标签： [leg_group_html] … [leg_group_html]

在一组层中使用此标记的HTML块是这些层将显示在图例中。在使用 [leg_group_html] 标记，不属于任何编组(未在 Mapfile 中设置的图层组)的图层的样式也不会显示在图例中。组列表由以下因素确定 order_metadata ，这将在后面的…中解释。

可以显示在中的标记 [leg_group_html] 数据块：

[leg_group_name] 组的名称
[layer_status] 组中第一个图层的状态
[leg\_icon width=<optional\_width> height=<optional\_height>\] The icon of the legend, [leg_icon] is the URL of the icon.
metadata name=<metadata_field_to_display>] 返回指定的元数据

示例：显示图层组

[leg_group_html]

<tr><td colspan=2> [leg_group_name] </b></td></tr>

[leg_group_html]

图层块标记： [leg_layer_html <OPTIONAL PARAMS>] … [/leg_layer_html] 如果未设置此~标记，则不会显示~Layer标题。

可选参数如下：

L ORDER_METADATA=<FIELD_TO_ORDER_BY>您可以使用<FIELD_TO_ORDER_BY>的值来控制图例中各层的显示顺序和可见性。

当<field_to_order_by>的值大于零时，按该值排序。

如果两个层的<field_to_order_by>的值相同，则使用地图层的顺序。

如果该值小于零，<field_to_Order_by>将不会显示在图例中。

L OPT_FLAG=<BIT_MASK>控制层的显示过程。值如下所示：

: Legend is still shown when out of Scale (default is out of Scale, no legend is shown)
: The corresponding legend is still displayed when the layer status is OFF (by default, the corresponding legend is not displayed when STATUS is OFF).
: The legend is still displayed when the layer type is QUERY (the default is not displayed when the TYPE is QUERY)
: The legend is still displayed when the ~layer type is ~ANNOTATION (the legend is not displayed when the TYPE is ANNOTATION by default) Example: opt\_flag=12 means to display all ~layer types, including ~QUERY and ANNOTATION.(4 +8)

可以显示在 [leg_layer_html] 区块如下：~

[leg_layer_name] 返回层名称的值
[leg_icon width=<option_width> height=<option_height>] 返回图例图标的URL
[metadata name=<metadata_field_to_display>] 返回指定的元数据值和Web元数据示例：使用HREF链接显示图层标题

[leg_layer_html order_metadata=WMS_ORDER visibility_flag=15]

<a href=“ [leg_layer_name] “> [metadata name=WMS_TITLE] </a><BR> [/leg_layer_html]

CLASS block tag:[leg _ class _ html & lt;OPTIONAL PARAMS>] .[/ leg _ class _ html]

如果未设置，则不会显示任何样式。

不会显示名称为空的

可选参数：

L OPT_FLAG=<BIT_MASK>控制层的显示。值如下所示：

- 1 : Legend is still shown when out of Scale (default is out of Scale, no legend is shown)
- 2 : The corresponding legend is still displayed when the layer status is OFF (by default, the corresponding legend is not displayed when STATUS is OFF).
- 4 : The legend is still displayed when the layer type is QUERY (by default it is not displayed when the TYPE is QUERY)
- 8 : The legend is still displayed when the layer type is ANNOTATION (by default, the legend is not displayed when the TYPE is ANNOTATION)

示例： opt_flag=12 用于显示所有层类型的方法，包括查询和注释。(4X8)

可在下使用的标记 [leg_class_html] ：

[leg_class_name] 类名的值

[leg_class_title] 班级标题的价值

[leg_icon width=<option_width> height=<option_height>] 返回图例图标的URL

[metadata name=<metadata_field_to_display>] 返回指定的元数据值

和Web元数据 _data

示例：

\[leg\_class\_html opt\_flag=15\]

<img源= [leg_icon] > [leg_class_name] <br>

[/leg_class_html]

条件文本

标签：

[如果名称=<字段_到_检查>操作符=<eq |neq| Isset|isull>

value=<to_compare_with_field>]

…

[/if] 这个 [if] 标记可以位于 [leg_*_html] 标签，建议使用嵌套。参数op的值可以是eq(等于)、neq(不等于)、isset、isNULL。默认为相等。

2.6.3纯HTML图例¶

这是另一种创造传奇的方式。经过前处理，使用HTML、PHTML、PHP等。

示例：

8.2.7. SCALEBAR对象¶

SCALEBAR定义了地图比例尺的生产方式。以SCALEBAR开头，以END结尾。图例图像的大小在创建之前并不是未知的，因此不要在模板文件的&lt；img>标记中硬编码图像的宽度和高度。

注意：TrueType类型的字体目前不可用。

间隔有多少部分：~图例吧是分的吗？默认值为~4。值： [integer]
UNITS: the unit of output scale bar. The default is meters. The real map can be obtained by using the map unit as its unit. Value: ~[feet | inches | kilometers | meters | miles]
COLOR: renders the layer using the color specified by COLOR when not using the property sheet. Value:[r] [g] [b]
IMAGECOLOR: initializes the color of the scale bar. Value:[r] [g] [b]
BACKGROUNDCOLOR: background color. Value:[r] [g] [b]
OUTLINECOLOR: the color of the border (border). The default value of-1 indicates an unbounded color. ~ value:[r] [g] [b]
LABEL: note the size of the SIZE. Note: TrueType-type postures cannot be used. ~ use ~[tiny | small | medium | large | giant] to define the value of SIZE. ~ usually you should use ~ tiny or small.
位置：~比例尺放置的位置，默认为~LR： [ul|uc|ur|ll|lc|lr] 那就是。
SIZE: the size of the scale bar. Value:[tiny | small | medium | large | giant].
Style：比例尺的类型。价值： [0 | 1]
POSTLABELCACHE：~告诉~MapServer在呈现所有标签后呈现图例。在添加相同类型的元素时，该选项非常有用。默认值为FALSE。价值： [true | false] 。
状态：是否创建比例尺图像以及是否嵌入图像。注意：您需要定义一个MARKERSET来嵌入比例尺。实际上，图例栏随后会变成一个 _custom 标记为与其他批注相同。~值：~ [on | off | embed] 。
透明：图例栏的背景是否透明，默认为关闭。价值： [on | off] 。

例1：

# ------------------------------------
# Scale Bar Definition - STYLE 0
# ------------------------------------
SCALEBAR
INTERVALS 5
UNITS kilometers
OUTLINECOLOR 0 0 0
STYLE 0
STATUS embed
  LABEL
    SIZE small
    COLOR 0 0 0
  END
END

插图栏如下所示：