MAP

注解

MAP, END.

角[双]角

旋转地图的角度，以度为单位。默认值为0。渲染的地图将按顺时针方向旋转。以下是重要注意事项：

• 需要一个 PROJECTION 在地图级别为每个指定的对象 LAYER 对象（即使所有层都在同一投影中）。

• 要求 MapScript （ SWIG ， PHP MapScript ）不适用于 CGI 模式。

• 如果使用 LABEL 对象的角度或 LAYER 对象的 LABELANGLEITEM MAP 对象的 ANGLE) ANGLE LABELANGLEITEM

• 从MapServer 7.2开始，如果使用 STYLE MAP 对象的 ANGLE) ANGLE ANGLE

• 有关地图旋转的更多信息 Wiki Page .

配置[键][值]

这可用于在运行时为mapserver和GDAL/OGR库指定多个值。开发人员：值将传递给cplsetconfigOption（）。有关GDAL/OGR选项的详细信息，请参见其关联的驱动程序文档页面。（ GDAL / OGR ）以下选项专为MapServer提供：

cgi-context-url[值]

这个 CONFIG Map Context HowTo 更多信息。

MS_加密密钥[文件名]

这个 CONFIG msencypt utility .

MS_错误文件[文件名]

这个 CONFIG CONFIG DEBUG

MS_NONSQUARE [yes|no]

这个 CONFIG MAP ，每一个 LAYER 必须有一个 PROJECTION 对象。

注解

对WMS无效。

ON_MISSING_DATA [FAIL|LOG|IGNORE]

这个'config'参数可以用来告诉mapserver如何处理tile索引中丢失的数据（从mapserver 5.3-dev，r8015开始）。以前的MapServer版本需要编译时开关（“忽略丢失的数据”），但不再需要。

FAIL

这将导致MapServer在tile索引中丢失的文件上抛出错误并退出（即崩溃）。这是默认设置。

CONFIG "ON_MISSING_DATA" "FAIL"

LOG

这将导致mapserver在tile索引中记录丢失文件的错误消息，并继续创建映射。注意：需要设置“debug”参数和配置“ms-errorfile”才能进行日志记录，有关详细信息，请参阅下面的“debug”参数。

CONFIG "ON_MISSING_DATA" "LOG"

IGNORE

这将导致MapServer无法报告或记录丢失文件的任何错误，并且地图创建将正常进行。

CONFIG "ON_MISSING_DATA" "IGNORE"

项目库[路径]

This CONFIG parameter can be used to define the location of your EPSG files for the PROJ library. Setting the [key] to PROJ_LIB and the [value] to the location of your EPSG files will force PROJ to use this value. Using CONFIG allows you to avoid setting environment variables to point to your PROJ_LIB directory. Here are some examples:

1. UNIX

   CONFIG "PROJ_LIB" "/usr/local/share/proj/"
   

2. Windows

   CONFIG "PROJ_LIB" "C:/somedir/proj/nad/"
   

项目调试[开关]

打开项目调试。见 调试MapServer 了解更多详细信息。

数据模式[正则表达式]

这定义了一个正则表达式，用于通过URL请求更改'data'参数的请求（即map.layer[layername]=data+…）。如果一个模式不存在，那么Web用户就不能通过URL来蒙骗支持文件。这允许您根据需要将一个应用程序与另一个应用程序隔离开来，默认操作非常保守。另请参见模板模板。

DEBUG [off|on|0|1|2|3|4|5]

启用当前映射中所有层的调试。

使用MapServer版本进行调试>=5.0:。

如果使用“ms-eu-errorfile”环境变量设置了标准错误输出（stderr）或mapserver错误文件，则会生成详细输出并将其发送到标准错误输出（stderr）或mapserver错误文件。可以通过在 Mapfile 的映射级别使用'config'参数来设置环境变量，例如：

CONFIG "MS_ERRORFILE" "/ms4w/tmp/ms_error.txt"

您还可以通过在httpd.conf中添加以下内容来在Apache中设置环境变量：

SetEnv MS_ERRORFILE "/ms4w/tmp/ms_error.txt"

设置环境变量后，“debug”mapfile参数可用于控制调试输出的级别。以下是对可能的“debug”值的描述：

• DEBUG O or OFF -只有mssterror（）调用记录到ms_错误文件。根本没有msdebug（）输出。这是默认值，与mapserver 4.x中ms_错误文件的原始行为相对应。

• DEBUG 1 or ON DEBUG 0 另外，msdebug（）警告常见缺陷、断言失败或非致命错误情况（例如，某些参数的值丢失或无效、tileindex中缺少形状文件、来自远程WMS/WFS服务器的超时错误等）。

• DEBUG 2 DEBUG 1 还有一些对优化 Mapfile 和应用程序有用的通知和定时信息。

• DEBUG 3 DEBUG 2 另外，一些调试输出对于排除正在调用的WMS连接URL、数据库连接调用等问题很有用。这是调试 Mapfile 的推荐级别。

• DEBUG 4 - DEBUG 3 还有更多的细节…

• DEBUG 5 - DEBUG 4 再加上任何msdebug（）输出，对开发人员可能比对用户更有用。

还可以使用“ms-debug level”环境变量设置调试级别。

这个 DEBUG DEBUG 中的参数 LAYER 对象。

有关此调试机制的详细信息，请参阅 调试MapServer 文件。

使用低于5的MapServer版本进行调试：

如果使用“web”对象中的“log”参数设置了详细输出，则生成详细输出并将其发送到标准错误输出（stderr）或MapServer日志文件。Apache用户将在Apache的错误日志文件中看到绘图的时间细节。要求使用debug=msdebug选项（--with debug configure选项）生成mapserver。

DEFRESOLUTION [double]

设置用于符号学的参考分辨率（每英寸像素）。默认值为72。

用于在以下情况下自动缩放符号 RESOLUTION RESOLUTION / DEFRESOLUTION.

5.6 新版功能.

范围[最小值][最小值][最大值][最大值]

要创建的地图的空间范围。在大多数情况下，您需要指定它，尽管如果没有指定，MapServer有时（代价高昂）会计算一个。

FONTSET [文件名]

要使用的fontset文件的文件名。可以是相对于 Mapfile 的路径，也可以是完整路径。

imagecolor[r][g][b][十六进制字符串]

用于初始化地图的颜色（即背景色）。启用透明度时（*transparent on*in OUTPUTFORMAT ）对于8位伪彩色映射生成的典型情况，该颜色将在输出文件调色板中标记为透明。使用此颜色绘制的任何其他地图组件也将是透明的，因此对于具有透明度的地图生成，最好使用其他未使用的颜色作为背景色。

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

  IMAGECOLOR 0 255 0
  

• hexadecimal string 可以是

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

    IMAGECOLOR "#FF00FF"
    

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

    IMAGECOLOR "#FF00FFCC"
    

IMAGEQUALITY [int]

Deprecated 在 OUTPUTFORMAT 为jpeg输出指定压缩质量的声明。

4.6 版后已移除.

IMAGETYPE [jpeg|pdf|png|svg|...|userdefined]

要生成的输出格式（栅格或矢量）。此处使用的名称必须与用户定义的或内部可用的“名称”匹配。 OUTPUTFORMAT IMAGEFORMATs, see the OUTPUTFORMAT 部分。

隔行扫描[开关]

Deprecated 在 OUTPUTFORMAT 指定是否应隔行扫描输出图像的声明。

4.6 版后已移除.

LAYER

表示开始 LAYER 对象。

LEGEND

表示开始 LEGEND 对象。

最大大小[整数]

设置地图图像的最大大小。这将覆盖默认值。例如，将其设置为4096意味着您可以在两个维度中拥有最多4096个像素（即最大4096x4096）。对于MapServer版本>=7.0.3，默认值为4096（对于早期版本，默认值为2048）。

NAME [姓名]

附加到使用此 Mapfile 创建的地图、比例尺和图例gif文件名的前缀。它应该保持简短。

OUTPUTFORMAT

表示开始 OUTPUTFORMAT 对象。

PROJECTION

表示开始 PROJECTION 对象。

QUERYMAP

表示开始 QUERYMAP 对象。

REFERENCE

表示开始 REFERENCE 映射对象。

分辨率[double]设置输出的每英寸像素数，仅影响

比例计算。默认值为72。

scaledenom[双]

SCALE 参数。

参见

Map Scale

SCALEBAR

表示开始 SCALEBAR 对象。

shapepath[文件名]

SHAPEPATH.

大小[X] [Y]

输出图像（即地图）的像素大小。

状态[关于关闭]

地图是否激活？有时，您可能希望关闭此选项以仅使用参考地图或比例尺。

符号集[文件名]

要使用的符号集的文件名。可以是相对于 Mapfile 的路径，也可以是完整路径。

注解

这个 SYMBOLSET SYMBOLSET END.

SYMBOL

表示开始 SYMBOL 对象。

templatePattern[正则表达式]

这将定义一个正则表达式，用于通过URL请求更改“template”参数的请求（即map.layer[layername].template=…）。如果一个模式不存在，那么Web用户就不能通过URL来蒙骗支持文件。这允许您根据需要将一个应用程序与另一个应用程序隔离开来，默认操作非常保守。另请参见数据模式。

透明[开关]

4.6 版后已移除.

使用 TRANSPARENT ON 在 OUTPUTFORMAT 指定输出图像是否应透明的声明。

UNITS [dd|feet|inches|kilometers|meters|miles|nauticalmiles]

地图坐标的单位。用于scaleBar和scale计算。`在MapServer 5.6中添加了nauticalmiles。

WEB

表示开始 WEB 对象。