Change the output format of the map

View examples

Depending on the format you choose, the image may not be displayed in your browser. If the link doesn't appear in your browser, right-click on the image above to see what format is specified in MapFile for saving.

Different output results

Mapfile example

The following is the Mapfile used in this example mfa8.map ):

01 MAP
02     EXTENT -180 -90 180 90
03     SIZE 600 300
04     SHAPEPATH "/gdata"
05     IMAGECOLOR 0 0 255
06     FONTSET "../fonts/fonts.list"
07     SYMBOLSET "../symbols/symbols35.sym"
08     IMAGETYPE "PNG24"
09     OUTPUTFORMAT
10         NAME "png8"
11         DRIVER "AGG/PNG8"
12         MIMETYPE "image/png; mode=8bit"
13         IMAGEMODE RGB
14         EXTENSION "png"
15         FORMATOPTION "QUANTIZE_FORCE=on"
16         FORMATOPTION "QUANTIZE_COLORS=256"
17         FORMATOPTION "GAMMA=0.75"
18     END
19     OUTPUTFORMAT
20         NAME "png"
21         DRIVER "AGG/PNG"
22         IMAGEMODE RGB
23     END
24     OUTPUTFORMAT
25         NAME "png24"
26         DRIVER "AGG/PNG"
27         IMAGEMODE RGBA
28         TRANSPARENT TRUE
29     END
30     OUTPUTFORMAT
31         NAME "jpeg"
32         DRIVER "AGG/JPEG"
33         IMAGEMODE RGB
34     END
35     OUTPUTFORMAT
36         NAME "svg"
37         DRIVER "CAIRO/SVG"
38         MIMETYPE "image/svg+xml"
39         IMAGEMODE RGB
40         EXTENSION "svg"
41     END
42     OUTPUTFORMAT
43         NAME "pdf"
44         DRIVER "CAIRO/PDF"
45         MIMETYPE "application/x-pdf"
46         IMAGEMODE RGB
47         EXTENSION "pdf"
48     END
49     OUTPUTFORMAT
50         NAME "cairopng"
51         DRIVER "CAIRO/PNG"
52         MIMETYPE "image/png"
53         IMAGEMODE RGB
54         EXTENSION "png"
55     END
56     OUTPUTFORMAT
57         NAME "GTiff"
58         DRIVER "GDAL/GTiff"
59         MIMETYPE "image/tiff"
60         IMAGEMODE RGB
61         EXTENSION "tif"
62     END
63     LAYER
64         NAME "topo"
65         DATA "land_shallow_topo_8192.tif"
66         STATUS OFF
67         TYPE RASTER
68     END
69     LAYER
70         NAME "wcountry-line"
71         DATA "wcountry.shp"
72         STATUS OFF
73         TYPE LINE
74         CLASS
75             NAME "State Boundary"
76             STYLE
77                 SYMBOL "line5"
78                 COLOR 255 255 0
79                 SIZE 1
80             END
81         END
82     END
83 END

Files are changed as follows:

f1MAPf1MAP
nn2    EXTENT -180 -90 180 90
3    SIZE 600 300
4    SHAPEPATH "/gdata"
5    IMAGECOLOR 0 0 255
6    FONTSET "../fonts/fonts.list"
7    SYMBOLSET "../symbols/symbols35.sym"
2    IMAGETYPE "PNG24"8    IMAGETYPE "PNG24"
n3    EXTENT -20042150 -7515806 20104978 7515807n9    OUTPUTFORMAT
4    SIZE 350 26010        NAME "png8"
5    SHAPEPATH "/gdata"11        DRIVER "AGG/PNG8"
6    SYMBOLSET "../symbols/symbols35.sym"12        MIMETYPE "image/png; mode=8bit"
7    FONTSET "../fonts/fonts.list"13        IMAGEMODE RGB
8    PROJECTION14        EXTENSION "png"
9        "init=epsg:3857"15        FORMATOPTION "QUANTIZE_FORCE=on"
16        FORMATOPTION "QUANTIZE_COLORS=256"
17        FORMATOPTION "GAMMA=0.75"
18    END
19    OUTPUTFORMAT
20        NAME "png"
21        DRIVER "AGG/PNG"
22        IMAGEMODE RGB
23    END
24    OUTPUTFORMAT
25        NAME "png24"
26        DRIVER "AGG/PNG"
27        IMAGEMODE RGBA
28        TRANSPARENT TRUE
29    END
30    OUTPUTFORMAT
31        NAME "jpeg"
32        DRIVER "AGG/JPEG"
33        IMAGEMODE RGB
34    END
35    OUTPUTFORMAT
36        NAME "svg"
37        DRIVER "CAIRO/SVG"
38        MIMETYPE "image/svg+xml"
39        IMAGEMODE RGB
40        EXTENSION "svg"
41    END
42    OUTPUTFORMAT
43        NAME "pdf"
44        DRIVER "CAIRO/PDF"
45        MIMETYPE "application/x-pdf"
46        IMAGEMODE RGB
47        EXTENSION "pdf"
48    END
49    OUTPUTFORMAT
50        NAME "cairopng"
51        DRIVER "CAIRO/PNG"
52        MIMETYPE "image/png"
53        IMAGEMODE RGB
54        EXTENSION "png"
55    END
56    OUTPUTFORMAT
57        NAME "GTiff"
58        DRIVER "GDAL/GTiff"
59        MIMETYPE "image/tiff"
60        IMAGEMODE RGB
61        EXTENSION "tif"
10    END62    END
15        TYPE RASTER67        TYPE RASTER
t16        PROJECTIONt68    END
17            "init=epsg:4326"69    LAYER
70        NAME "wcountry-line"
71        DATA "wcountry.shp"
72        STATUS OFF
73        TYPE LINE
74        CLASS
75            NAME "State Boundary"
76            STYLE
77                SYMBOL "line5"
78                COLOR 255 255 0
79                SIZE 1
80            END
18        END81        END

Now our MapFile contains a new object OUTPUTFORMAT . Within the MAP object defined by this object, and when used with the keyword IMAGETYPE.

Depending on the compiled library of MapServer, you can have a variety of output formats to choose from - the GD library provides PNG (8-bit and 24-bit), GIF, JPEG, WBMP , the GDAL library, which sources many of MapServer's input formats, and can also provide output in PNG, JPEG, TIFF/GeoTIFF, and other raster formats; the pdflib library provides PDF output.

Have a look at your MAPFILE object by changing the keyword IMAGETYPE and experiment with OUTPUTFORMAT . It should be used as IMAGETYPE value (eg: IMAGETYPE png or PNG24 IMAGETYPE ), the name of the output format.

Please consult the OUTPUTFORMAT object reference:

//www.mapserver.org/mapfile/outputformat.html#outputformat