OUTPUTFORMAT¶

Mapfile 可以有零个、一个或多个输出格式对象声明，定义支持的可用输出格式，包括PNG、GIF、JPEG、GEOTIFF、SVG、PDF和KML等格式。

如果在映射文件中找不到outputformat节声明，则将进行以下隐式声明。只有那些编译了支持的文件才是可用的。geotiff依赖于gdal支持的构建，pdf和svg依赖于cairo支持的构建。

OUTPUTFORMAT
  NAME "png"
  DRIVER AGG/PNG
  MIMETYPE "image/png"
  IMAGEMODE RGB
  EXTENSION "png"
  FORMATOPTION "GAMMA=0.75"
END
OUTPUTFORMAT
  NAME "png8"
  DRIVER AGG/PNG8
  MIMETYPE "image/png; mode=8bit"
  IMAGEMODE RGB
  EXTENSION "png"
  FORMATOPTION "QUANTIZE_FORCE=on"
  FORMATOPTION "QUANTIZE_COLORS=256"
  FORMATOPTION "GAMMA=0.75"
END
OUTPUTFORMAT
  NAME "jpeg"
  DRIVER AGG/JPEG
  MIMETYPE "image/jpeg"
  IMAGEMODE RGB
  EXTENSION "jpg"
  FORMATOPTION "GAMMA=0.75"
END
OUTPUTFORMAT
  NAME "jpeg_png"
  MIMETYPE "image/vnd.jpeg-png"
  DRIVER AGG/MIXED
  IMAGEMODE RGBA
  FORMATOPTION "TRANSPARENT_FORMAT=png"
  FORMATOPTION "OPAQUE_FORMAT=jpeg"
END
OUTPUTFORMAT
  NAME "jpeg_png8"
  MIMETYPE "image/vnd.jpeg-png8"
  DRIVER AGG/MIXED
  IMAGEMODE RGBA
  FORMATOPTION "TRANSPARENT_FORMAT=png8"
  FORMATOPTION "OPAQUE_FORMAT=jpeg"
END
OUTPUTFORMAT
  NAME "svg"
  DRIVER CAIRO/SVG
  MIMETYPE "image/svg+xml"
  IMAGEMODE RGB
  EXTENSION "svg"
END
OUTPUTFORMAT
  NAME "pdf"
  DRIVER CAIRO/PDF
  MIMETYPE "application/x-pdf"
  IMAGEMODE RGB
  EXTENSION "pdf"
END
OUTPUTFORMAT
  NAME "GTiff"
  DRIVER GDAL/GTiff
  MIMETYPE "image/tiff"
  IMAGEMODE RGB
  EXTENSION "tif"
END
OUTPUTFORMAT
  NAME "kml"
  DRIVER KML
  MIMETYPE "application/vnd.google-earth.kml.xml"
  IMAGEMODE RGB
  EXTENSION "kml"
END
OUTPUTFORMAT
  NAME "kmz"
  DRIVER KMZ
  MIMETYPE "application/vnd.google-earth.kmz"
  IMAGEMODE RGB
  EXTENSION "kmz"
END
OUTPUTFORMAT
  NAME "cairopng"
  DRIVER CAIRO/PNG
  MIMETYPE "image/png"
  IMAGEMODE RGB
  EXTENSION "png"
END
OUTPUTFORMAT
  NAME "myUTFGrid"
  DRIVER UTFGRID
  FORMATOPTION "LABELS=true"
  FORMATOPTION "UTFRESOLUTION=4"
  FORMATOPTION "DUPLICATES=false"
END

驱动程序[名称]: 用于生成此输出格式的驱动程序的名称。如果驱动程序支持多种格式，则某些驱动程序名称包括格式定义。对于agg，可能的驱动程序名称是“agg/png”和“agg/jpeg”。对于通过ogr输出，将追加ogr驱动程序名称，例如“ogr/mapinfo文件”。对于通过gdal的输出，格式的gdal短名称被附加，例如“gdal/gtiff”。请注意，可以使用gdal或agg生成png和jpeg输出（agg通常效率更高）。模板应用于基于模板的输出。（强制性）。其他驱动程序：kml、kmz和utfgrid。

扩展名[类型]: 提供创建此类文件时要使用的扩展名。（可选）

格式选项[选项]

提供驱动程序或特定格式选项。OutputFormat声明中可能存在零个或多个FormatOption语句。（可选）

agg/*：“gamma=n”用于指定应用于多边形渲染的gamma校正。允许值为[0.0,1.0]，默认值为0.75。该值用于防止伪影出现在相邻多边形的边界上。设置为1.0以禁用伽玛校正。

agg/jpeg：“quality=n”选项可用于设置生成的jpeg的质量（值为0-100）。

agg/png：“compression=n”用于确定应用于png创建的zlib压缩。n应为0到9之间的整数值，0表示 no 压缩（不推荐），1表示最快压缩，9表示最佳压缩。压缩级别是有代价的（无论是CPU处理还是文件大小，选择最适合您的设置）。默认值是compression=6。
agg/png支持从24/32位量化为8位，以减小最终图像大小（从而节省带宽）（另请参见 MapServer issue #2436 对于应用这些选项时的策略）：
- “Quantize_force=on”用于将RGB或RGBA图像还原为8位（或更少）调色板图像。选择调色板中使用的颜色以最适合RGB或RGB图像中的实际颜色。
- “量化颜色=256”用于指定应用量化时要使用的颜色数量。最大值为256。指定17到255之间的任何内容都可能是浪费质量，因为每个像素仍然用一个完整的字节进行编码。如果指定的值小于16，将生成微小的图像，但会严重降级。
- “palete=/path/to/palete.txt”用于定义可以找到调色板颜色的绝对路径。该文件必须包含256个r、g、b三元组（对于RGB图像模式），或r、g、b四元组（对于RGB图像模式）。预期的格式是每行一个三元组（或四元组），每个值用逗号分隔，每行一个三元组/四元组。如果要对调色板使用透明度，请在调色板文件中使用这两种颜色：0,0,0,0和25525525255。
  
  备注
  
  如果你有完全透明的区域，0,0,0很重要。25525525255为不透明白色。调色板中的重要颜色实际上取决于实际地图，尽管0,0,0,0,0255和25525525255在大多数情况下很可能会显示出来。
- “Palette_force=on”用于使用预定义的调色板减少图像深度。此选项与以前的量化选项不兼容。要允许除预定义调色板中的颜色之外的其他颜色用于消除混叠，请与“量化颜色”一起使用。

AGG/混合

7.2 新版功能.

agg/mixed是一个元驱动程序，它根据结果图像是否具有透明度自动选择适当的格式。它要求定义透明格式和不透明格式选项，并将其设置为其他有效格式。透明格式和不透明格式的有效格式是由agg/png、agg/jpeg或gdal/XXXX驱动程序处理的格式。默认情况下，“jpeg_png”格式（带有“image/vnd.jpeg png”mime类型）预配置为在非不透明像素时使用PNG图像，而在仅不透明像素时使用JPEG。类似地，“jpeg_png8”格式（带有“image/vnd.jpeg-png8”mime类型）被预先配置为在非不透明像素时使用png 8位图像，在仅不透明像素时使用jpeg。
- “transparent_format=name”：当图像包含非不透明/透明像素时使用的输出格式。
- “opaque_format=name”：当图像仅包含不透明像素时使用的输出格式。
例子：
```
OUTPUTFORMAT
  NAME "jpeg_low"
  MIMETYPE "image/jpeg; quality=50"
  DRIVER AGG/JPEG
  IMAGEMODE RGB
  FORMATOPTION "QUALITY=50"
END

OUTPUTFORMAT
  NAME "jpeg_low_png"
  MIMETYPE "image/vnd.jpeg-png; quality=50"
  DRIVER AGG/MIXED
  IMAGEMODE RGBA
  FORMATOPTION "TRANSPARENT_FORMAT=png"
  FORMATOPTION "OPAQUE_FORMAT=jpeg_low"
END
```
开罗/ PDF：
- “GEO_ENCODING=ISO32000”或“GEO_ENCODING=OGC_BP”：
  
  6.2 新版功能.
  
  将生成地理空间PDF。需要带有PDF驱动程序的GDAL 1.10。请参阅 GDAL Geospatial PDF 要求的文档。
- “METADATA_ITEM：OPTION=VALUE”：
  
  6.2 新版功能.
  
  可以使用METADATA_ITEM前缀提供其他PDF选项。以下选项可用： AUTHOR ， CREATOR ， CREATION_DATE ， KEYWORDS ， PRODUCER ， SUBJECT ， TITLE 。
例子：
```
OUTPUTFORMAT
  NAME pdf
  DRIVER "CAIRO/PDF"
  MIMETYPE "application/x-pdf"
  IMAGEMODE RGB
  EXTENSION "pdf"
  FORMATOPTION "GEO_ENCODING=ISO32000"
  FORMATOPTION "METADATA_ITEM:CREATOR=MapServer, with GDAL trunk"
  FORMATOPTION "METADATA_ITEM:PRODUCER=MapServer, with GDAL trunk"
END
```

gd/png：“interlace=[开/关]”选项可用于打开或关闭隔行。

警告

在MapServer 7.0中删除了GD支持。
gd/gif:可以使用“interlace=[开/关]”选项打开或关闭隔行扫描。

警告

在MapServer 7.0中删除了GD支持。

gdal/gtiff：支持“tiled=yes”、“blockxsize=n”、“blockysize=n”、“interleave=[pixel/band]”和“compress=[none，packbits，jpeg，lzw，deflate]”格式特定选项。
gdal/*：所有格式选项都传递到gdal create函数。gdal支持的选项在每个gdal格式的详细文档中描述。

gdal/*：在原始图像模式（imagemode byte/int16/float）中使用“nullvalue=n”来预初始化栅格，并尝试将其记录在结果文件中，作为nodata值。如果设置了rangeset_nullvalue，则会在WCS模式下自动设置。
OGR/*：参见废气再循环输出有关OGR格式选项详细信息的文档。

UTFGRID:见 MS RFC 93:UTF网格支持 .
- “标签=真”。可以使用标签边界框绘制到地图的父要素ID（通过utfitem派生）来呈现标签。
- “utfsolution=4”。网格的分辨率。分辨率越高，网格越小，因此会降低其重量，但也会降低其精度。
- “重复=假”。可能不希望删除重复的功能ID/密钥对，因为根据地图中的功能数量，该过程可能会很昂贵。此选项可用于跳过此步骤。生成的JSON文件会大一点。

选择生成输出的成像模式。对于像flash这样的非栅格格式很重要。并非所有格式都支持所有组合。（可选）

PC256：在调色板中生成最多256种颜色的伪彩色结果（旧版MapServer模式）。仅支持gd/gif和gd/png。

警告

在MapServer 7.0中删除了GD支持。

RGB：以24位红/绿/蓝模式渲染。支持所有颜色，但不支持透明度。

rgba：以32位红/绿/蓝/阿尔法模式渲染。支持所有颜色和基于字母的透明度。所有功能在最初透明的背景下呈现。

字节：呈现原始8位像素值（不显示）。当前仅适用于栅格图层（通过gdal）和WMS图层。

Int16：呈现原始的16位有符号像素值（不显示）。当前仅适用于栅格图层（通过gdal）和WMS图层。

float32：渲染原始32位浮点像素值（不显示）。当前仅适用于栅格图层（通过gdal）和WMS图层。

特征：输出是非图像结果，例如通过模板或OGR编写的特征。

MIMEType [类型]: 提供通过Web返回结果时要使用的MIME类型。（可选）

姓名[姓名]: 要在映射文件的imagetype关键字中用于选择此输出格式的名称。此名称也用于描述允许的WXS格式的元数据中，并且可以通过OGC请求中的关键字（有时与mimetype一起）选择输出格式。（可选）

透明[开关]: 指示是否应为此格式启用透明度。请注意，透明度不适用于ImageMode RGB输出。并非所有格式都支持透明度（可选）。当为8位伪彩色映射生成的典型情况启用透明度时，图像颜色将在输出文件调色板中标记为透明。使用此颜色绘制的任何其他地图组件也将是透明的，因此对于具有透明度的地图生成，最好使用其他未使用的颜色作为背景色。

	Home \| Products \| Issue Tracker \| Service Providers \| FAQ \| Twitter \| Download \|