Useful stitcher commandline arguments for timelapse

For now, please contact us and we'll help you stitch your timelapse gigapan.  For those interested in what's going on under the hood, or interested to experiment with stitching themselves, here are new commandline flags that support timelapse stitching:

Compensating for automatic exposure

If lighting might change between frames, but a human isn't present for each capture, we recommend setting the camera for automatic exposure (we like aperture priority, with an overriding adjustment to bring down the exposure 1/2-1 stops to reduce saturation).

The newest stitcher can read exposure from EXIF information on each input image and adjust brightness of the individual images to match exposure across an individual frame.  The feature cannot yet be used at the same time as automatic vignetting correction, so you have to turn off VC in order to use the feature:

--no-vignette-correction:  turn off vignetting correction

--equalize-exposure-using-exif:  equalize exposures across the panorama using EXIF tags (aperture, exposure, ISO)

--load-camera-response-curve path-to-response-curve:  Use camera response curve for equalizing exposure.  Required.  Many cameras are similar;  we've successfully used the Canon G10 response (filename g10.response) for the Canon G9 for example (attached).

--adjust-exposure EV:  After adjusting overall exposure to average of input exposures, adjust entire image by this many stops (floating point).  Use a positive number to make brighter and negative to make darger; e.g. to make image half a stop brighter use --adjust-exposure 0.5.

Aligning to other panoramas

--master: master.gigapan: Align this panorama to master.gigapan and crop the stitched image to line up pixel-to-pixel with master.gigapan.  This flag may be repeated to align to multiple master gigapans.

Running without human intervention

--images image1.jpg image2.jpg ... imageN.jpg:  Stitch these images
--batch-mode:  Don't display blocking dialog boxes when encountering problems or asking for confirmation;  instead, log and keep going if possible
--stitch-quit:  Go ahead and stitch input images, then quit
--xvfb:  Run Linux stitcher without real X display.  Requires Xvfb (X virtual framebuffer) to be installed.

Setting the order of input images and # of rows/columns

Flags which affect ordering of pictures in stitch:
Select one of --rowfirst or --colfirst:
  --colfirst   images complete columns first (default)
  --rowfirst   images complete rows first (use --ncols instead of --nrows, see below)
Select one of --downward or --upward:
  --downward   image capture moves from top to bottom (default)
  --upward     image capture moves from bottom to top
Select one of --rightward or --leftward
  --rightward  image capture moves from left to right (default)
  --leftward   image capture moves from right to left

There are 8 possible combinations (order of the flags does not matter):

--colfirst --downward --rightward       --rowfirst --downward --rightward
           1 4 7                                   1 2 3
           2 5 8                                   4 5 6
           3 6 9                                   7 8 9

--colfirst --downward --leftward       --rowfirst --downward --leftward
           7 4 1                                   3 2 1
           8 5 2                                   6 5 4
           9 6 3                                   9 8 7

--colfirst --upward --rightward       --rowfirst --upward --rightward
           3 6 9                                   7 8 9
           2 5 8                                   4 5 6
           1 4 7                                   1 2 3

--colfirst --upward --leftward       --rowfirst --upward --leftward
           9 6 3                                   9 8 7
           8 5 2                                   6 5 4
           7 4 1                                   3 2 1

--ncols N   Set # of cols.  Used instead of --nrows when using --rowfirst

Randy Sargent,
Jun 12, 2011, 4:38 AM