Difference between revisions of "Align image stack"
m (A little grammar, with some punctuation & regularizing (while I was at it).) |
|||
| Line 5: | Line 5: | ||
=== Options: modes of operation === | === Options: modes of operation === | ||
-p file | -p file | ||
| − | Output .pto file ( | + | Output .pto file. (Useful for debugging, or further refinement.) |
-a prefix | -a prefix | ||
| − | Align images, output as prefix_xxxx.tif | + | Align images, output as prefix_xxxx.tif. |
-o output | -o output | ||
| − | Merge images to HDR, generate output.hdr | + | Merge images to HDR, generate output.hdr. |
=== Options: modifiers === | === Options: modifiers === | ||
-v | -v | ||
| − | Verbose, print progress messages | + | Verbose, print progress messages. |
-e | -e | ||
| − | Assume input images are full frame [[Fisheye Projection|fish eye]] (default: [[Rectilinear Projection|rectilinear]]) | + | Assume input images are full frame [[Fisheye Projection|fish eye]] (default: [[Rectilinear Projection|rectilinear]]). |
-t num | -t num | ||
| − | Remove all control points with an error higher than num pixels (default: 3) | + | Remove all control points with an error higher than num pixels (default: 3). |
--corr=num | --corr=num | ||
| − | Correlation threshold for identifying control points (default: 0.9) | + | Correlation threshold for identifying control points (default: 0.9). |
-f HFOV | -f HFOV | ||
| − | Approximate horizontal [[field of view]] of input images | + | Approximate horizontal [[field of view]] of input images. Use if [[EXIF]] info not complete. |
-m | -m | ||
| − | Optimize field of view for all images, except for first. Useful for aligning focus stacks with slightly different magnification | + | Optimize field of view for all images, except for first. Useful for aligning focus stacks with slightly different magnification. |
-d | -d | ||
Optimize radial distortion for all images, except for first. | Optimize radial distortion for all images, except for first. | ||
| Line 36: | Line 36: | ||
Assume stereo images - allow horizontal shift of control points. Adds all control points as "horizontal lines". | Assume stereo images - allow horizontal shift of control points. Adds all control points as "horizontal lines". | ||
-A | -A | ||
| − | Align stereo window - assumes -S. Adds one "normal" control point that is the nearest point so everything will appear behind the display plane. | + | Align stereo window - assumes -S. Adds one "normal" control point that is the nearest point, so that everything will appear behind the display plane. |
-P | -P | ||
| − | Align stereo window with pop-out effect - assumes -S. Adds one "normal" control point that is the nearest point from the border areas so the center of the image may appear in front of the display plane. | + | Align stereo window with pop-out effect - assumes -S. Adds one "normal" control point that is the nearest point from the border areas, so that the center of the image may appear in front of the display plane. |
-C | -C | ||
Auto crop the image to the area covered by all images. | Auto crop the image to the area covered by all images. | ||
-c num | -c num | ||
| − | Number of [[control points]] to create between adjacent images (default: 8) | + | Number of [[control points]] to create between adjacent images (default: 8). |
-l | -l | ||
| − | Assume linear input files | + | Assume linear input files. |
-s scale | -s scale | ||
| − | Scale down image by 2 | + | Scale down image by 2<sup>scale</sup> (default: 1 [2x downsampling]). Scaling down images will improve speed at the cost of accuracy. |
| − | -g gsize | + | -g gsize |
Break image into a rectangular grid (gsize x gsize) and attempt to find num control points in each section (default: 5 [5x5 grid] ) | Break image into a rectangular grid (gsize x gsize) and attempt to find num control points in each section (default: 5 [5x5 grid] ) | ||
--distortion | --distortion | ||
| − | Try to load distortion information from lens database | + | Try to load distortion information from lens database. |
--use-given-order | --use-given-order | ||
| − | Use the image order as given from command line (By default images will be sorted by exposure values as found in EXIF data.) | + | Use the image order as given from command line. (By default images will be sorted by exposure values as found in EXIF data.) |
--threads=NUM | --threads=NUM | ||
| − | Use NUM threads ( | + | Use NUM threads. (By default it uses as many threads as cores.) |
--gpu | --gpu | ||
| − | Use GPU for remapping | + | Use GPU for remapping. |
-h | -h | ||
Display help. | Display help. | ||
Revision as of 22:51, 11 September 2014
align_image_stack is a command-line tool available in the development version of hugin to align overlapping images to facilitate HDR creation, Exposure blending, extended Depth of Field, and Stereoscopic images.
Usage
align_image_stack [options] input_files
Options: modes of operation
-p file
Output .pto file. (Useful for debugging, or further refinement.)
-a prefix
Align images, output as prefix_xxxx.tif.
-o output
Merge images to HDR, generate output.hdr.
Options: modifiers
-v
Verbose, print progress messages.
-e
Assume input images are full frame fish eye (default: rectilinear).
-t num
Remove all control points with an error higher than num pixels (default: 3).
--corr=num
Correlation threshold for identifying control points (default: 0.9).
-f HFOV
Approximate horizontal field of view of input images. Use if EXIF info not complete.
-m
Optimize field of view for all images, except for first. Useful for aligning focus stacks with slightly different magnification.
-d
Optimize radial distortion for all images, except for first.
-i
Optimize image center shift for all images, except for first.
-x
Optimize X coordinate of the camera position.
-y
Optimize Y coordinate of the camera position.
-z
Optimize Z coordinate of the camera position. Useful for aligning more distorted images.
-S
Assume stereo images - allow horizontal shift of control points. Adds all control points as "horizontal lines".
-A
Align stereo window - assumes -S. Adds one "normal" control point that is the nearest point, so that everything will appear behind the display plane.
-P
Align stereo window with pop-out effect - assumes -S. Adds one "normal" control point that is the nearest point from the border areas, so that the center of the image may appear in front of the display plane.
-C
Auto crop the image to the area covered by all images.
-c num
Number of control points to create between adjacent images (default: 8).
-l
Assume linear input files.
-s scale
Scale down image by 2scale (default: 1 [2x downsampling]). Scaling down images will improve speed at the cost of accuracy.
-g gsize
Break image into a rectangular grid (gsize x gsize) and attempt to find num control points in each section (default: 5 [5x5 grid] )
--distortion
Try to load distortion information from lens database.
--use-given-order
Use the image order as given from command line. (By default images will be sorted by exposure values as found in EXIF data.)
--threads=NUM
Use NUM threads. (By default it uses as many threads as cores.)
--gpu
Use GPU for remapping.
-h
Display help.