https://sourceforge.net/p/dezoomify/wiki/CommandSyntax/Recent changes to CommandSyntaxenWed, 19 Nov 2014 10:07:32 -0000https://sourceforge.net/p/dezoomify/wiki/CommandSyntax/<div class="markdown_content"><pre>--- v11 +++ v12 @@ -10,7 +10,7 @@ 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: `http://foo.com/zoomify/1 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. +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"). </pre> </div>Martin ValgurWed, 19 Nov 2014 10:07:32 -0000https://sourceforge.netcca2f3e6b624a0faea56fa7eb971ccabbb9f066ahttps://sourceforge.net/p/dezoomify/wiki/CommandSyntax/<div class="markdown_content"><pre>--- v10 +++ v11 @@ -8,7 +8,7 @@ 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 space: `http://foo.com/zoomify/1 bar.jpg` +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: `http://foo.com/zoomify/1 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. </pre> </div>forquestWed, 20 Nov 2013 22:29:55 -0000https://sourceforge.net97534ad73fc005500d7d84b347968bc4fd110c4ehttps://sourceforge.net/p/dezoomify/wiki/CommandSyntax/<div class="markdown_content"><pre>--- v9 +++ v10 @@ -6,7 +6,7 @@ ###Optional parameters### -If you set the **-b** flag, the script will take the **-i** 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 **-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 space: `http://foo.com/zoomify/1 bar.jpg` @@ -26,27 +26,29 @@ ####Task administration#### -You can change the number of download threads with **-t**. The default number is 16. Feel free to try even higher values, as tile downloading is the biggest bottleneck in the whole program and connections being blocked on the server side should not really be an issue. +You can change the number of parallel download connections with **-t**. The default number is 16. ##Examples## 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 "), 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 c:\output.jpg` + * `python dezoomify.py http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html output.jpg` -* To download from the *base* URL (add the -b flag, but *don't* remove the -i parameter, -b just modifies the intent of -i, and doesn't replace it): - * `python dezoomify.py http://fotothek.slub-dresden.de/zooms/df/dk/0001000/df_dk_0001708 -b c:\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 -l c:\output.jpg` + * `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 -l -b c:\output.jpg` + * `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 ` *e.g.* `-z 3`: - * `python dezoomify.py http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html -z 3 c:\output.jpg` + * `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 -s c:\output.jpg` +* 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` +* To re-stitch the image from the tiles downloaded with -s, use -x: + * `python dezoomify.py http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html output.jpg -x` </pre> </div>Martin ValgurSun, 06 Oct 2013 23:23:50 -0000https://sourceforge.net1196ab8ec550b982ea81611e33bb493d8edd1411https://sourceforge.net/p/dezoomify/wiki/CommandSyntax/<div class="markdown_content"><pre>--- v8 +++ v9 @@ -1,8 +1,8 @@ ###Mandatory parameters### -The image locations are given with the **-i** parameter. In its raw state, this is the URL of a page ''containing'' the Zoomify object, for example `-i http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html` +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 `http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html` -The output image is given by the **-o** parameter. This should be a file on your local filesystem, for example `-o foo.jpg` or `-o /tmp/foo.jpg`. +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### @@ -11,6 +11,8 @@ 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 space: `http://foo.com/zoomify/1 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. + +Increase the level of output verbosity (default is "warning") with **-v** ("info") or **-vv** ("debug"). ####Tile handling#### @@ -24,8 +26,6 @@ ####Task administration#### -Enable debugging output with the **-d** flag. - You can change the number of download threads with **-t**. The default number is 16. Feel free to try even higher values, as tile downloading is the biggest bottleneck in the whole program and connections being blocked on the server side should not really be an issue. ##Examples## @@ -33,20 +33,20 @@ 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 "), provided that Python 3 is installed. * To download an image from a page containing a Zoomify object: - * `python dezoomify.py -i http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html -o c:\output.jpg` + * `python dezoomify.py http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html c:\output.jpg` * To download from the *base* URL (add the -b flag, but *don't* remove the -i parameter, -b just modifies the intent of -i, and doesn't replace it): - * `python dezoomify.py -i http://fotothek.slub-dresden.de/zooms/df/dk/0001000/df_dk_0001708 -b -o c:\output.jpg` + * `python dezoomify.py http://fotothek.slub-dresden.de/zooms/df/dk/0001000/df_dk_0001708 -b c:\output.jpg` * To download from pages containing Zoomify objects, but using a list of *page* URLs: - * `python dezoomify.py -i c:\list.txt -l -o c:\output.jpg` + * `python dezoomify.py c:\list.txt -l c:\output.jpg` * To download from pages containing Zoomify objects, but using a list of *base* URLs: - * `python dezoomify.py -i c:\list.txt -l -b -o c:\output.jpg` + * `python dezoomify.py c:\list.txt -l -b c:\output.jpg` * To get the image at a different zoom level (0 is lowest, highest depends on the image), add `-z ` *e.g.* `-z 3`: - * `python dezoomify.py -i http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html -z 3 -o c:\output.jpg` + * `python dezoomify.py http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html -z 3 c:\output.jpg` * To save the tiles as they are downloaded (in the same directory as the output), add -s - * `python dezoomify.py -i http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html -s -o c:\output.jpg` + * `python dezoomify.py http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html -s c:\output.jpg` </pre> </div>Martin ValgurMon, 25 Feb 2013 21:47:11 -0000https://sourceforge.net838eadcaa1dc06fc0b23afa5efe46174c0d3696ahttps://sourceforge.net/p/dezoomify/wiki/CommandSyntax/<pre>--- v7 +++ v8 @@ -26,7 +26,7 @@ Enable debugging output with the **-d** flag. -You can change the number of download threads with **-t**. The default number is 16. You can try even higher values, as tile downloading is the biggest bottleneck in the whole program and connections being blocked on the server side should not really be an issue. +You can change the number of download threads with **-t**. The default number is 16. Feel free to try even higher values, as tile downloading is the biggest bottleneck in the whole program and connections being blocked on the server side should not really be an issue. ##Examples## </pre>Martin ValgurFri, 07 Oct 2011 01:32:04 -0000https://sourceforge.net26218d9d63775325bfb9604035542bd75e1658a1https://sourceforge.net/p/dezoomify/wiki/CommandSyntax/<pre>--- v6 +++ v7 @@ -26,7 +26,7 @@ Enable debugging output with the **-d** flag. -You can change the number of download threads with **-t**. The default number is 4. +You can change the number of download threads with **-t**. The default number is 16. You can try even higher values, as tile downloading is the biggest bottleneck in the whole program and connections being blocked on the server side should not really be an issue. ##Examples## </pre>Martin ValgurFri, 07 Oct 2011 01:27:21 -0000https://sourceforge.net5c60fd4b0a294611bf456fc6807f95ef0ac560e1https://sourceforge.net/p/dezoomify/wiki/CommandSyntax/<pre>--- v5 +++ v6 @@ -2,37 +2,35 @@ The image locations are given with the **-i** parameter. In its raw state, this is the URL of a page ''containing'' the Zoomify object, for example `-i http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html` -The output image is given by the **-o** parameter. This should be a file on your local filesystem, for example `-o C:\foo.jpg` or `-o /tmp/foo.jpg`. - +The output image is given by the **-o** parameter. This should be a file on your local filesystem, for example `-o foo.jpg` or `-o /tmp/foo.jpg`. + ###Optional parameters### -If you set the **-b** flag, the script will take the **-i** 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`. These is no slash at the end of the URL. +If you set the **-b** flag, the script will take the **-i** 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 space: `http://foo.com/zoomify/1 bar.jpg` -The **-e** flag sets the extension of the files we will be collecting and tiling: in all cases I have seen, this is the default, 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. ####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 or the download was interrupted. +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#### Enable debugging output with the **-d** flag. You can change the number of download threads with **-t**. The default number is 4. ##Examples## -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 in Python already, and need to exit. Also ensure you are using Python 3. Enter `python -V` to check. +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 -i http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html -o c:\output.jpg` </pre>Martin ValgurThu, 06 Oct 2011 18:25:28 -0000https://sourceforge.net34dffd05cd86af4bcf5e3e40d3c422f6ea4139dfhttps://sourceforge.net/p/dezoomify/wiki/CommandSyntax/<pre>--- v4 +++ v5 @@ -46,7 +46,7 @@ * To download from pages containing Zoomify objects, but using a list of *base* URLs: * `python dezoomify.py -i c:\list.txt -l -b -o c:\output.jpg` -* To get the image at a different zoom level (0 is lowest, highest depends on the image), add `-z <level>` *e* `-z 3`: +* 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 dezoomify.py -i http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html -z 3 -o c:\output.jpg` </pre>inductiveloadThu, 06 Oct 2011 13:56:49 -0000https://sourceforge.neta5dd6c7588522e0f16dbf8c0ad097ed5f2115b26https://sourceforge.net/p/dezoomify/wiki/CommandSyntax/<pre>--- v3 +++ v4 @@ -46,7 +46,7 @@ * To download from pages containing Zoomify objects, but using a list of *base* URLs: * `python dezoomify.py -i c:\list.txt -l -b -o c:\output.jpg` -* To get the image at a different zoom level (0 is lowest, highest depends on the image), add -z <level> ''eg'' "-z 3": +* To get the image at a different zoom level (0 is lowest, highest depends on the image), add `-z <level>` *e* `-z 3`: * `python dezoomify.py -i http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html -z 3 -o c:\output.jpg` </pre>inductiveloadThu, 06 Oct 2011 13:56:30 -0000https://sourceforge.net5b5fe85865fb6207d8973d79df1e2c0cdd88e1fehttps://sourceforge.net/p/dezoomify/wiki/CommandSyntax/<pre>--- v2 +++ v3 @@ -29,3 +29,26 @@ Enable debugging output with the **-d** flag. You can change the number of download threads with **-t**. The default number is 4. + +##Examples## + +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 in Python already, and need to exit. Also ensure you are using Python 3. Enter `python -V` to check. + +* To download an image from a page containing a Zoomify object: + * `python dezoomify.py -i http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html -o c:\output.jpg` + +* To download from the *base* URL (add the -b flag, but *don't* remove the -i parameter, -b just modifies the intent of -i, and doesn't replace it): + * `python dezoomify.py -i http://fotothek.slub-dresden.de/zooms/df/dk/0001000/df_dk_0001708 -b -o c:\output.jpg` + +* To download from pages containing Zoomify objects, but using a list of *page* URLs: + * `python dezoomify.py -i c:\list.txt -l -o c:\output.jpg` + +* To download from pages containing Zoomify objects, but using a list of *base* URLs: + * `python dezoomify.py -i c:\list.txt -l -b -o c:\output.jpg` + +* To get the image at a different zoom level (0 is lowest, highest depends on the image), add -z <level> ''eg'' "-z 3": + * `python dezoomify.py -i http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html -z 3 -o c:\output.jpg` + + +* To save the tiles as they are downloaded (in the same directory as the output), add -s + * `python dezoomify.py -i http://www.bl.uk/onlinegallery/onlineex/evancoll/a/zoomify72459.html -s -o c:\output.jpg` </pre>inductiveloadTue, 04 Oct 2011 00:57:23 -0000https://sourceforge.net3ddc3133205d342f666ae0091ec7c00fed71b5c4