Differences

This shows you the differences between two versions of the page.

--- pr0ntools:pr0nts [2012/02/18 08:38] – mcmaster
+++ pr0ntools:pr0nts [2025/08/04 21:19] (current) – removed mcmaster
@@ Line 1: / Line 1: @@
-The goal of this tool is to be able to stitch large panoramas easier on machines with fewer resources than may be desirable.  Instead of outputting a single large image like a standard stitch would do this tool generates a folder full of tiles.  These can then be processed into a Google maps type application.
-There are two modes:
-  * Single: cut up a single input image
-  * Project:
-====== Configuration ======
-I have some limited configuration file support.  In particular you can have a JSON file called ~/.pr0nrc that can look like this:
-    {
-        "enblend": {
-            "opts":"-m 10240"
-        }
-    }
-That is you can pass in arbitrary additional options to enblend.  In the above example I do this to increase the cache size to 10 GB on my desktop which can afford that sort of memory allocation.
-====== Usage ======
-  usage: pr0nts [-h] [--stw SUPER_TW] [--sth SUPER_TH] [--force] [--merge]
-              [--out-ext OUT_EXTENSION] [--full] [--st-xstep SUPER_T_XSTEP]
-              [--st-ystep SUPER_T_YSTEP] [--clip-width CLIP_WIDTH]
-              [--clip-height CLIP_HEIGHT] [--ignore-errors]
-              pto project
-  create tiles from unstitched images
-  positional arguments:
-    pto project           pto project
-  optional arguments:
-    -h, --help            show this help message and exit
-    --stw SUPER_TW        Supertile width
-    --sth SUPER_TH        Supertile height
-    --force               Force by replacing old files
-    --merge               Don't delete anything and only generate things missing
-    --out-ext OUT_EXTENSION
-                          Select output image extension (and type), .jpg, .png,
-                          .tif, etc
-    --full                use only 1 supertile
-    --st-xstep SUPER_T_XSTEP
-                          Supertile x step (advanced)
-    --st-ystep SUPER_T_YSTEP
-                          Supertile y step (advanced)
-    --clip-width CLIP_WIDTH
-                          x clip (advanced)
-    --clip-height CLIP_HEIGHT
-                          y clip (advanced)
-    --ignore-errors       skip broken tile stitches (advanced)
-====== Examples ======
-===== Simple =====
-pr0nts out.pto
-Pick some halfway reasonable defaults (that may still need fiddling) and output tiles to the directory "out" (or whatever $X in $X.pto is).  If the directory already exists an error will be thrown.
-===== Advanced =====
-pr0nts --clip-width 3264 --clip-height 2448 --stw=$[3264 * 5] --sth=$[2448 * 6] out.pto --merge --ignore-errors
-Note my camera takes 3264 X 2448 images.  Don't stitch 3264 x units on each side overlapping another image and 2448 in the y direction.  Supertiles should be 16320 X 14688 pixels.  Use out.pto to determine stitch parameters and merge with the existing output.  If a command fails skip that supertile and try the next.
-====== Symptoms and fixes ======
-===== Garbled tiles =====
-{{:pr0ntools:stitch:photometric_error.png?200|}}
-{{:pr0ntools:stitch:poor_opt.png?200|Caption}}
-Changes are your project is poorly optimized.  You should be able to get an RMS error of < 5 without too much trouble and for good results it should be < 1.
-===== Uneven adjacent tile brightness =====
-Your source images have uneven brightness.  This can happen using auto-brightness, lamp misalignment, an uneven sample, or because there is a brightness gradient from using polarized light on non-strain-free objectives.  Try increasing the clip width/height as it will force a large area to be melded together before creating a tile.