@@ -1,58 +1,66 @@
-.\" Process this file with
-.\" groff -man -Tascii foo.1
-.TH AUTOPANO-COMPLETE 1 "MAY 2004" autopano-sift "User Manual"
-autopano-complete \- Generate panorama project file from images.
-.I -o output.pto
-.I [image3 [..]]
-Generate panorama project from image files. First, generate temporary keypoint
-files for each of the image files given on the command line. Then match the
-image files to identify the same features in two or more images. Generate a
-PTO panorama project file from the matching results. (Programs such as
-can read it.)
-The image files to read in. They can be in any common format, including JPEG,
-PNG and TIFF.
-.IP "-o|--output <file>"
-Set PTO panorama output file (mandatory).
-.IP "-s|--size <pixelsize>"
-Set downscale resolution. If any of the image dimensions exceed this side, the
-image is resized so the longer side of the images will be this size. This is a
-preprocessing step and no file on disc will be changed. Use this when memory
-.IP "-p|--points <count>"
-The maximum number of control points to generate per image pair. When more
-than the given number of pairs are found, only the best are kept.
-Do not use the RANSAC algorithm (RANdom Sample Consensus), which does use
-geometric correllation to remove unwanted matches. Use this when uncommon lens
-geometries are used, such as fisheye lenses.
-In any case, wipe the table - the previously generated keypoint files - and
-then generate the keypoint files from the images and match. If no clean is
-used, then previous image keypoint files are also used for matching.
-Output a concise usage help.
-No bugs known, if you find any, please send a bug report to me. I will try to
-fix it. An old, obselete version of this script exists with similar
-Pablo d'Angelo <pablo dot dangelo at web dot de>,
-Sebastian Nowozin <nowozin at cs dot tu dash berlin dot de>
-.SH "SEE ALSO"
-.BR autopano-sift (7),
-.BR generatekeys (1),
-.BR autopanog (1),
-.BR showone (1),
-.BR showtwo (1)
+AUTOPANO-SIFT(7) Overview AUTOPANO-SIFT(7)
+ autopano-sift - Automatic panorama stitching package
+ The autopano-sift package contains a number programs to ease the cre-
+ ation of panoramic images. A tedious task in panoramic image creation
+ from many individual images is the aligning of the images so they fit
+ together. This is normally done by using control points which give
+ information about shared image features. For example, image two images
+ of a church. Lets assume both images overlap so that the rooftop of the
+ church is visible in both. By telling a panorama software that the roof
+ is in both images at a specific position the images can be aligned. At
+ least three control point pairs between every two images are required
+ The manual work of creating this control points can be immense. Espe-
+ cially for panorama images holding more than one line of images there
+ is a huge number of possible overlaps.
+ The autopano-sift package can automatically create control point pairs
+ by using a combination of sophisticated algorithms and models. For most
+ feature-rich images it works very well, often outperforming humans in
+ coverage, precision and speed.
+ In the following, the individual utilities are introduced. If you want
+ a quick start, try the autopanog(1) GUI frontend.
+ autopanog The GTK# GUI frontend for generating and matching SIFT key-
+ points. As a user wanting to stitch panorama images, this is all you
+ will ever need. See autopanog(1)
+ autopano The keypoint matching program. It can take SIFT keypoint files
+ as input and produce PTO output files. See autopano(1)
+ generatekeys The SIFT keypoint extraction program. Takes an image from
+ you, and gives keypoints back. Optionally can downscale the image to a
+ given resolution, so your memory size is cared for. See generatekeys(1)
+ showone Show the SIFT keypoints overlayed over the source image. Use
+ includes debugging and tuning of SIFT parameters and to get an impres-
+ sion how well spread the keypoints are. See showone(1)
+ showtwo Do simplistic matching of SIFT keypoints between two images,
+ without geometric model. Use includes representing general matching
+ quality. Optionally filter only a given number of "best" keypoint
+ matches. See showtwo(1)
+ If you find any bugs in the programs, please mail the author.
+ Sebastian Nowozin <nowozin at cs dot tu dash berlin dot de>
+ autopano(1), autopanog(1), generatekeys(1), showone(1), showtwo(1)
+autopano-sift MAY 2004 AUTOPANO-SIFT(7)