Addition to Error Message Documentation

[ben]

G'day,

Playing with stretching my browser across two monitors (so I could get a really big screenshot!) I started getting an error somthing like :

msWMSLoadGetMapParams(): WMS server error. Image Size out of range, WIDTH and HEIGHT must be between 1 and 2048 pixels.

This is a very useful message, but finding the work around was not so easy. (increase MAXSIZE in the MAP object - not so long ago you had to recompile the entire mapserver to do this.)

I wonder if this could be added to the Documentation >> Errors page to save someone else the searching (This is a really good resource, and the first place I go now.).

I don't think I can add or edit on the new site, so I am posting this here as recommended.

cheers

Ben

[ben]

Possible entry...

msWMSLoadGetMapParams(): WMS server error. Image Size out of range, WIDTH and HEIGHT must be between 1 and 2048 pixels.

Error displayed when using a high resolution monitor with a scaleable map window - It means that the returned image (as requested by the wms client) would be larger than the mapsize limit set in MapServer. An example of when it might occur would be while using single tile mode through openlayers.

This limit is set to reduce the overhead on MapServer when generating the map images, so increasing it too much will place heavy loads on your Server.

Solution

Use map tiling, or if this is not possible increase the mapsize:

In the MAP object part of the mapfile set the MAXSIZE to a larger scale:

MAP
    NAME        map
    UNITS       DD
    MAXSIZE     3072    # a 50% increase in the biggest dimension

[havatv]

The error message + a short description was added in the errors document for trunk and 6.0 in r12594 and r12595.