map2img(1)

NAME
map2img - create a map image from a mapfile

SYNOPSIS
\FCmap2img\F[]
\FC-m\F[] mapfile [\FC-o\F[] image] [\FC-e\F[] minx miny maxx maxy] [\FC-s\F[] sizex sizey] [\FC-l\F[] " layer1 [layer2...]"] [\FC-i\F[] format] [\FC-all_debug\F[] n] [\FC-map_debug\F[] n] [\FC-layer_debug\F[] layername n] [\FC-p\F[] n] [\FC-c\F[] n] [\FC-d\F[] layername datavalue]

DESCRIPTION
map2img creates a map image from a mapfile. Output is either PNG or GIF depending on what version of the GD library is used. This is a useful utility to test your mapfile. You can simply provide the path to your mapfile and the name of an output image, and an image should be returned. If an image cannot be created an error will be displayed at the command line that should refer to a line number in the mapfile.

OPTIONS

\FC-m\F[] mapfile
    Map file to operate on - required

\FC-i\F[] format
    Override the IMAGETYPE value to pick output format

\FC-o\F[] image
    Output filename (STDOUT if not provided)

\FC-e\F[] minx miny maxx maxy
    Extents to render

\FC-s\F[] sizex sizey
    Output image size

\FC-l\F[] layers
    Layers to enable - make sure they are quoted and space separated if more than one listed

\FC-all_debug\F[] n
    Set debug level for map and all layers

\FC-map_debug\F[] n
    Set map debug level

\FC-layer_debug\F[] layername n
    Set layer debug level

\FC-c\F[] n
    Draw map n number of times

\FC-p\F[] n
    Pause for n seconds after reading the map

\FC-d\F[] layername datavalue
    Change DATA value for layer

EXAMPLE
Example #1

\FC
map2img -m vector_blank.map -o test.png
      \F[]

Result:
    A file named 'test.png' is created, that you can drag into your browser to view.

Example #2

\FC
map2img -m gmap75.map -o test2.png -map_debug 3
      \F[]

Result:
    A file named 'test2.png' is created, and layer draw speeds are returned such as:

\FC
msDrawRasterLayerLow(bathymetry): entering
msDrawMap(): Layer 0 (bathymetry), 0.601s
msDrawMap(): Layer 3 (drain_fn), 0.200s
msDrawMap(): Layer 4 (drainage), 0.300s
msDrawMap(): Layer 5 (prov_bound), 0.191s
msDrawMap(): Layer 6 (fedlimit), 0.030s
msDrawMap(): Layer 9 (popplace), 0.080s
msDrawMap(): Drawing Label Cache, 0.300s
msDrawMap() total time: 1.702s
msSaveImage() total time: 0.040s
      \F[]

Example #3

\FC
map2img -m gmap75.map -o test3.png -all_debug 3
      \F[]

Result:
    A file named 'test3.png' is created, layer draw speeds are returned, and some warnings that index qix files are not found, such as:

\FC
msLoadMap(): 0.671s
msDrawRasterLayerLow(bathymetry): entering.
msDrawGDAL(): src=72,417,3077,2308, dst=0,0,400,300
msDrawGDAL(): red,green,blue,alpha bands = 1,0,0,0
msDrawMap(): Layer 0 (bathymetry), 0.090s
msSearchDiskTree(): Search returned no results. Unable to open spatial index
for D:\ms4w\apps\gmap\htdocs/.\../data/drain_fn.qix. In most cases you can
safely ignore this message, otherwise check file names and permissions.
msDrawMap(): Layer 3 (drain_fn), 0.010s
msDrawMap(): Layer 4 (drainage), 0.050s
msSearchDiskTree(): Search returned no results. Unable to open spatial index
for D:\ms4w\apps\gmap\htdocs/.\../data/province.qix. In most cases you can
safely ignore this message, otherwise check file names and permissions.
msDrawMap(): Layer 5 (prov_bound), 0.030s
msSearchDiskTree(): Search returned no results. Unable to open spatial index
for D:\ms4w\apps\gmap\htdocs/.\../data/fedlimit.qix. In most cases you can
safely ignore this message, otherwise check file names and permissions.
msDrawMap(): Layer 6 (fedlimit), 0.010s
msDrawMap(): Layer 9 (popplace), 0.010s
msDrawMap(): Drawing Label Cache, 0.201s
msDrawMap() total time: 0.401s
msSaveImage() total time: 0.010s
map2img total time: 1.082s
      \F[]