MAP

备注

MAP, END.

../_images/map_classes.png
角[双]角

旋转贴图的角度,以度为单位。默认值为0,并且必须在-360到360的范围内。渲染的贴图将沿顺时针方向旋转。以下是重要注意事项:

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

  • 要求 MapScriptSWIGPHP 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

_nonsquare女士[是否]

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

备注

对WMS无效。

ON_MISSING_DATA [FAIL|LOG|IGNORE]

这个 CONFIG

FAIL

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

CONFIG "ON_MISSING_DATA" "FAIL"
LOG

DEBUG DEBUG

CONFIG "ON_MISSING_DATA" "LOG"
IGNORE

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

CONFIG "ON_MISSING_DATA" "IGNORE"
项目库[路径]

CONFIG 参数可用于定义EPSG文件的位置 PROJ 类库。设置 [key] 到proj_lib和 [价值] 添加到EPSG文件的位置将强制Proj使用此值。使用 CONFIG 允许您避免将环境变量设置为指向PROJ_LIB目录。以下是一些示例:

  1. UNIX

    CONFIG "PROJ_LIB" "/usr/local/share/proj/"
    
  2. Windows

    CONFIG "PROJ_LIB" "C:/somedir/proj/nad/"
    
项目调试[开关]

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

数据模式[正则表达式]

Removed in version 8.0: 看见 VALIDATION 取而代之的是

DATA

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

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

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

CONFIG

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

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

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

DEBUG 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 还有一些对优化映射文件和应用程序有用的通知和定时信息。

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

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

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

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

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

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

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

LOG 中的参数 WEB

除霜[双倍]

5.6 新版功能.

设置用于符号的参考分辨率(每英寸像素数)。默认值为72。最小值为10,最大值为1000。

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

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

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

FONTSET [文件名]

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

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

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

  • r, gb

    IMAGECOLOR 0 255 0
    
  • hexadecimal string 可以是

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

      IMAGECOLOR "#FF00FF"
      
    • rgba值(添加半透明):“rrggbbaa”。要指定半透明品红色,请使用以下选项:

      IMAGECOLOR "#FF00FFCC"
      
图像质量

4.6 版后已移除.

DeprecatedOUTPUTFORMAT 为jpeg输出指定压缩质量的声明。

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

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

隔行扫描[开关]

4.6 版后已移除.

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

LAYER

表示开始 LAYER 对象。

LEGEND

表示开始 LEGEND 对象。

最大大小[整数]

设置地图图像的最大大小。这将覆盖缺省值。例如,将其设置为4096表示在两个维度上最多可以有4096个像素(即最大为4096x4096)。对于MapServer版本>=7.0.3,缺省值为4096(对于早期版本,缺省值为2048)。必须是大于0的值。

姓名[姓名]

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

OUTPUTFORMAT

表示开始 OUTPUTFORMAT 对象。

PROJECTION

表示开始 PROJECTION 对象。

QUERYMAP

表示开始 QUERYMAP 对象。

REFERENCE

表示开始 REFERENCE 映射对象。

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

比例计算。默认值为72。最小值为10,最大值为1000。

scaledenom[双]

地图的计算比例。通常由应用程序设置。比例尺被指定为实际比例尺分数的分母,例如,对于比例为1:24,000的地图,使用24000。在MapServer5.0中实现,以取代过时的 SCALE 参数。必须大于或等于1。

参见

Map Scale

SCALEBAR

表示开始 SCALEBAR 对象。

shapepath[文件名]

SHAPEPATH.

大小[X] [Y]

输出图像(即地图)的像素大小。值必须小于MaxSize属性。

状态[关于关闭]

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

符号集[文件名]

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

备注

这个 SYMBOLSET SYMBOLSET END.

SYMBOL

表示开始 SYMBOL 对象。

templatePattern[正则表达式]

Removed in version 8.0: 看见 VALIDATION 取而代之的是

TEMPLATE

透明[开关]

4.6 版后已移除.

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

UNITS [dd英尺英寸公里米英里Nauticalmiles]

Nauticalmiles

WEB

表示开始 WEB 对象。