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
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 http://ogimages.bl.uk/images/zoomify/014/014EVA000000000U05043000. 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:
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").
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
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.
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
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 ("./dezoomify.py <params>"), provided that Python 3 is installed.
To download an image from a page containing a Zoomify object:
python dezoomify.py http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html output.jpg
To download from the base URL:
python dezoomify.py http://fotothek.slub-dresden.de/zooms/df/dk/0001000/df_dk_0001708 output.jpg -b
To download from pages containing Zoomify objects, but using a list of page URLs:
python dezoomify.py c:\list.txt output.jpg -l
To download from pages containing Zoomify objects, but using a list of base URLs:
python dezoomify.py 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.
python dezoomify.py http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html output.jpg -z 3
To save the tiles as they are downloaded (in the same directory as the output), add -s:
python dezoomify.py http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html output.jpg -s
python dezoomify.py http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html output.jpg -x