inductiveload Martin Valgur forquest

Mandatory parameters

The image locations are given with the first positional parameter. In its raw state, this is the URL of a page ''containing'' the Zoomify object, for example

The output image is given by the second positional parameter. This should be a file on your local filesystem, for example foo.jpg or /tmp/foo.jpg.

Optional parameters

If you set the -b flag, the script will take the first positional parameter as the raw base directory of the Zoomify file structure. In this case it would be: -b There is no slash at the end of the URL.

If you set the -l flag, the script takes as an input a local file containing a list of URLs, one on each line. Each of these is interpreted as before (you can give a simple page URL or a base URL with the -b parameter). You can follow the URL with the local filename you want to save as, separated by a tab (Tabulator) character: bar.jpg

You can set the zoom level with the -z parameter. Zoom level 0 is the most zoomed-out, and the highest zoom level (most zoomed-in) depends on the particular image. Default behaviour is to use the highest available zoom level. Negative zoom levels can also be used: zoom level -1 corresponds to the most zoomed in level, -2 to half the (edge) size of that, -3 to 1/4 the size, -4 to 1/8, etc.

Increase the level of output verbosity (default is "warning") with -v ("info") or -vv ("debug").

Tile handling

The -s parameter will save the individual tiles into the folder equal to the output filename, minus the extension. For example, the tiles for C:\foo.jpg will be stored in C:\foo\.

The -x parameter will no download new tiles, it will use tiles downloaded previously and saved with the -s flag. This is useful if the image stitching fails for some reason.

Dependency handling

If you wish to use a jpegtran binary other than that provided, use the -j parameter to give the path of the executable, for example -j /usr/local/bin/jpegtran

Task administration

You can change the number of parallel download connections with -t. The default number is 16.


You run the script by writing a command like the examples below into the Windows or Linux (or whatever) command line, and not into the Python interactive prompt. If your prompt begins ">>>", you are already in Python, and need to exit. Also ensure you are using Python 3. Enter python -V to check. On Linux you can also execute the program directly ("./ <params>"), provided that Python 3 is installed.

  • To download an image from a page containing a Zoomify object:

    • python output.jpg
  • To download from the base URL:

    • python output.jpg -b
  • To download from pages containing Zoomify objects, but using a list of page URLs:

    • python c:\list.txt output.jpg -l
  • To download from pages containing Zoomify objects, but using a list of base URLs:

    • python c:\list.txt output.jpg -l -b
  • To get the image at a different zoom level (0 is lowest, highest depends on the image), add -z <level> e.g. -z 3:

    • python output.jpg -z 3
  • To save the tiles as they are downloaded (in the same directory as the output), add -s:

    • python output.jpg -s
  • To re-stitch the image from the tiles downloaded with -s, use -x:
    • python output.jpg -x


Wiki: Home

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:

JavaScript is required for this form.

No, thanks