MapServer6.4.1教程学习--单图层地图(1-1)

示例1.1  单图层地图 
在此例中，MapServer可以创建一幅图像输出到本地目录或直接发送给请求的网络浏览器。你可以不用通过一个HTML网页，只需要输入网址： http://localhost/cgi-bin/mapserv.exe?map=/ms4w/apps/tutorial/htdocs/example1-1.map&layer=states&mode=map。如果你能够访问网络服务器(如果没有正常工作，请将网址中的”localhost”替换成网络服务器名称，如”demo.mapserver.org”或者是IP地址，如140.211.15.84)。
上述网址为拆分为三个部分：第一部分为http://localhost/cgi-bin/mapserv.exe?，称为MapServerCGI程序。如果直接调用你将得到这条熟悉的消息：没有用于解码的查询信息。查询字符串设置为空值。
网址中紧接下来的三个部分组成了查询字符串。查询字符串包含CGI参数（变量和对应的值），每个参数间用“&”分割。所以上述示例查询字符串可分为：
l  第一个参数“map”被赋值为”/ms4w/apps/tutorial/htdocs/example1-1.map”.此参数用来告诉MapServerCGI程序需要解析的mapfile文件。
l  接下来的参数（layer=states）告诉mapserv打开(”turn on”)层states。请记住我们将层对象命名为”states”.
l  最后一个参数(mode=map)告诉CGI程序mapserv从mapfile文件中输出什么。此例中告诉mapserv直接输出一幅图像到web浏览器（客户端），而不是先在服务器创建一个临时的图像。
Mapserver的”mode”变量除了”map”值以外还有其他值。比例如果你设置”mode=browse”，MapServer会输把结果图像输出到服务器的一个临时文件夹。现在我们的浏览器模式不会起作用但稍后我们会回来讨论这个问题。
Mapfile结构
如下是示例1-1mapfile的文件结构。
# The annotated map file (sort of)
# Created by Pericles S. Nacionales for the MapServertutorial
# 20050408
#
# MapServer map file uses the pound sign (#) to denotethe start of a line
# comment--each line that needs to be commented has tobe prepended with a "#".
#
# Map files begin with MAP keyword to signify the startof the map object.
# Well, the entire map file is THE map object.  Enclosed between MAP and END
# at the very bottom of this map file, arekeyword/value pairs and other
# objects.
MAP
  IMAGETYPE      PNG
  EXTENT         -97.238976 41.619778 -82.12290249.385620
  SIZE           400 300
  SHAPEPATH      "../data"
  IMAGECOLOR     255 255 255
 
  # Layer objectsare defined beneath the map object.  Youneed at least one
  # layer definedin your map file before you can display a map...  You can
  # define asmany layers as you'd like although a limit is typically hard-coded
  # in map.h inthe MapServer source.  The default limitis set at 100.  You'd
  # have to havea very specialized application to need more than 100 layers in
  # yourapplication.
 
  # Start ofLAYER DEFINITIONS ---------------------------------------------
  LAYER # Statespolygon layer begins here
    NAME         states
    DATA         states_ugl
    STATUS       OFF
    TYPE         POLYGON
 
    # The classobject is defined within the layer object. You can define as
    # manyclasses as you need (well, there are limits as with layers, but it's
    # senselessto define more than ten on a "normal" layer.  There are
    # situations,however, where you might have to do it.)
    CLASS
      NAME       "The Upper Great Lakes States"
 
      # There arestyles in a class, just like there are classes in a layer,
      # just likethere are layers in a map.  You candefine multiple styles in
      # a classjust as you can define multiple classes in a layer and multiple
      # layers in a map.
      STYLE
       COLOR        232 232 232
       OUTLINECOLOR 32 32 32
      END
    END
  END # Statespolygon layer ends here
  # End of LAYERDEFINITIONS -------------------------------
 
END # All map files must come to an end just as allother things must come to...
 
MAPFILE是MapServer的基本配置机制。它由对象（objects）组成，每个对象可以包含键值或其他对象。MAPFILE是一种层次结构，一些对象在其他对象之下…层次结构顶层是MAP对象，所有其他对象都属于它。这个例子展示了对象间非常简单的一个层次关系。当你在学习每个示例时，这些层次树的复杂度会增加。
关于mapfiles最基本的是：我们在mapfile文件中用对象名字来定义每个对象，以”END”来结束，用”#”符号开始写注释。
让我们按对象拆分”example1-1.map”。它的结构就像下面这样：
MAP
 |-LAYER
|-CLASS
  |-SYTLE
MAP对象
让我们看看MAP对象内部的关键字（参数）。
MAP
  每个mapfile文件必须以MAP对象开始—整个mapfile文件就是一个MAP对象。
IMAGETYPE
  关键字”IMAGETYPE”用来定义MapServerCGI程序输出图像的格式。此例中我们使用的是彩色PNG（类似于GIF）。也可以设置为GIF，如果我们编译GD库的时候增加了GIF支持，WBMP或JPEG。我们也可以用OUTPUTFORMAT对象来指定其他输出选项（PDF,SWF,GeoTIFF）,只要编译时添加这些支持。OUTPUTFORMAT对象超出了本教程的范围，但是你可以通过阅读MapServer网站上的文档来得到更多。
EXTENT
   这个关键字指定了地图的输出范围，我们最初地图的边界框。EXTENT值以如下格式给出：
<Lower Left X> <Lower Left Y> <UpperRight X> <Upper Right Y>
用空格分割每个值。这里需要和数据单位一致，或者如果指定了不同的输出投影，则应与输出投影的单位一致。
这个盒子中数据是地理投影，所以单位是度小数。你可以用实用工具orginfo，它是GDAL/OGR库的一部分，去获取某个Shapefile（或其他支持的矢量格式）数据集的空间范围。这里是用来获取此例空间范围的命令：
Ogrinfo –al –so –states_ugl.shp
返回如下输出：
Layer name: states_ugl
Geometry: Polygon
Feature Count: 204
Extent: (-97.238976, 41.619778) -(-82.122902, 49.385620)
Layer SRS WKT:
(unknown)
AREA: Real (12.3)
PERIMETER: Real (12.3)
STATESP020: Real (11.0)
STATE: String (20.0)
STATE_FIPS: String (2.0)
CLASS: String (5.0)
你也可以用ArcView或其他开源GIS软件包，如QGIS,Thuban等。通过改变EXTENT的值来体会它是如何改变你的地图的。
SIZE
   它是以像素来表示MapServer将要生成图像（地图）的尺寸。所以我们的地图是400像素宽和300像素高。再一次你可以随意更改这个值来看看它是如何影响你的地图的。
SHAPEPATH
   这个关键字表示你数据层的路径。你可以用绝对路径（"/ms4w/apps/tutorial/data" or "C:/ms4w/apps/tutorial/data"）或相对于你mapfile位置的相对路径（此例中使用"../data"）来表示。这个路径不需要也不应该能通过网络访问，除非你想让其他人下载你的原始数据。
网络不应该直接操作这里（It has nothing directly to do with the web so don't even think ofURLs here）。只需要确保用户通过web服务器（在*nix世界通常是”nobody”或”apache”）能够读取SHAPEPATH路径下的数据。
IMAGECOLOR
   这代表你地图的背景色。它的值是RGB，所以红色分量255，绿色分量255，蓝色分量255的颜色会形成白色背景。去试试这个关键字吧。
LAYER对象
现在我们来看看LAYER对象的关键字。
LAYER
        MAP对象里面表示LAYER对象开始的标记。你可以随意指定尽可能多的层数（MapServer版本小于5的情况下会有限制，但是可以通过编辑map.h文件然后重新编译MapServer的方式来改变）。
NAME
层的标识符。MapServer用名称来打开或关闭层。但在此例中不会有效，因为我们把层的状态（STATUS）设置为默认（OFF）。我们在稍后的例子中再讨论。
DATA
数据名称（本例为Shapefile数据集）。MapServer除了ESRI的Shapefile文件格式外还支持其他的矢量数据格式，这是通过使用OGR库（GDAL软件包的一部分）来实现的。请访问GDAL项目官网http://gdal.osgeo.org/阅读http://gdal.osgeo.org/ogr来学习更多MapServer支持的其他矢量格式。除此之外，Jeff Mckenna和Tyler Mitchell写了一个用于MapServer矢量数据格式的详细指南（http://mapserver.org/input/vector/index.html#vector）。
TYPE
     数据的类型是什么？如果是矢量数据，你可以指定它是多边形（POLYGON），线（LINE，即使你的数据是POLYLINE，你也可以表示为LINE），或者是点（POINT）。你也可以指定栅格（RASTER）或注记（ANNOTATION）数据。在这里我们希望显示多边形（POLYGON）。
STATUS
     层根据它的状态来打开或关闭。默认的是打开。ON或OFF仅当层名作为查询字符串的一部分传递的时候起作用。
CLASS对象
     让我们看看类对象的关键字。
CLASS
       在层（LAYER）对象内表示类（CLASS）对象开始的标记。在一个层里面你可以随意指定类的数量 （MapServer版本小于5的情况下会有限制，但是可以通过编辑map.h文件然后重新编译MapServer的方式来改变）。
NAME
       类的描述性标识符。像MAP对象可以拥有很多层一样，LAYER对象也可以拥有很多类。CLASS名称被MapServer用作图例的标签，所以命名类对象时确认使用一个合适的描述名称。我们在此系列稍后教程中讨论图例。
STYLE对象
最后 ，让我们看看STYLE对象的关键字。
STYLE
       样式（SYTLE）对象开始的标记。在一个类里面你可以定义多个样式。当你想将一个样式叠加到另一个时会很有用。
COLOR
多边形的填充色。如果类型（TYPE）是线（LINE），则是线的颜色。这个值是RGB格式的。
OUTLINECOLOR
这是多边形轮廓线颜色。值是RGB格式的。默认情况下MapServer不绘制多边形轮廓线，所以如果你想看到多边形边界线，你需要定义OUTLINECOLOR。
本系统教程第一个例子结束。
 
 
PS:中文版权为asswclw所有，请尊重劳动成果，转载将注明出处。