Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Alternatively you can also download wmstester.jar to your local PC and run it from there, but then you need to ensure that you already have Java installed.

 


In a Windows environment, open Windows Command Line, and run the following to get a help listing:

Code Block
languagetext
themeRDark
c:\weave\jre\bin\java -jar c:\weave\wmstest.jar -h
usage: wmstest -f <filename> | -u <url> [-e <minx,miny,maxx,maxy> | -l <x,y,scale>] [-c <crs>] [-x <scale>] [-s <width,height>] [-D <DPI>] [--ignorescales] [-t <timeout>] [-n] [-o <filename>] [-d] [-b <threads>] [--format <format>] [-U <username>] [-P <password>] [-q] [-h] [-V]

 


The parameters that can be used in the tester are given in the table below. The - or -- syntax can be used:

ParameterDescription
-f, --file <filename>

Filename of a text file that has a list of base URL's for the WMS services. Each line in the file should contain a single WMS URL.

-u, --url <url>

The base URL for the WMS service, this can be added more than once, but the -f command can also be used for multiple URL's.

-e, --envelope minx,miny,maxx,maxy>

The envelope to use to draw the map. This is alternative to -l, and can not be set if -l is set.

-l, --location <x,y,scale>

The centre location to use to draw the map. This is alternative to -e, and can not be set if -e is set.

-c, --crs <crs>

The CRS to use for the map requests. The default is EPSG:4326.If not set a suitable CRS wil be determined by the following logic:

  • If all layers support WGS84 that will be used
  • If all layers have a common CRS one of those will be used
  • If a layer supports WGS84 that will be used
  • If a layer supports any other CRS that will be used
-x, --maxscale <scale>

The maximum scale to use to generate the map.

-s, --size <width,height>

The width and height, in pixels, of the generated map image. The default is 400,400

-D, --dpi <DPI>

DPI to use when creating the map images. The default is 90.71.

-t, --timeout <timeout> 

The network timeout in seconds. The default is 120

-n, --nomap

Just retrieve the capabilities document, and do not generate a map request.

-o, --output <filename>

Output results to a CSV file.

-d, --dump

Dump the generated images to a file.

-b, --background <threads>

Create all the connections in the background at the same time, rather than processing the URLs one by one. Including the <threads> value will specify how may tasks to do at once, if a value for <threads> is not set then all tasks will be performed at once, if this option isn't included at all then each task will be performed one after the other.

-U, --username <username>

Username to connect with, and must be supplied if the password is set.

-P, --password <password>

Password to connect with, and must be supplied if username is set.

-q, --quiet

Do not output results to the console.

-h, --help

Show this help and quit.

-V, --version

Print the version of the WMS Tester and exit.

--ignorescalesDon't make use of the scale ranges reported by the WMS service to adjust the extents of the generated map images.
--formatSet the format of the image to generate, the default is image/jpeg.

 

If neither -l or -e is set then the area to draw will be calculated based on the extent of the layer, but it will be adjusted if a maximum scale range has been applied to the layer, or -x is set, unless --ignorescales is specified.

...


Examples of the WMS Tester

...