Difference between revisions of "Align image stack"

From PanoTools.org Wiki
Jump to navigation Jump to search
(Note exposure blending and extended depth of field uses)
(8 intermediate revisions by 5 users not shown)
Line 1: Line 1:
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]] and extended [[Depth of Field]] images.
+
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.
 
 
This article is a stub.
 
  
 
== Usage ==
 
== Usage ==
  align_image_stack [options] input files
+
  align_image_stack [options] input_files
 
=== Options: modes of operation ===
 
=== Options: modes of operation ===
 
  -p file   
 
  -p file   
Output .pto file (useful for debugging, or further refinement)"
+
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
Line 19: Line 17:
 
  -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
 +
Correlation threshold for identifying control points (default: 0.9)
 
  -f HFOV   
 
  -f HFOV   
 
Approximate horizontal [[field of view]] of input images, use if [[EXIF]] info not complete
 
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
 +
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 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 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     
 
  -c num     
Number of [[control points]] to create between adjacent images (default: 200)
+
Number of [[control points]] to create between adjacent images (default: 8)
 +
-l
 +
Assume linear input files
 +
-s scale
 +
Scale down image by 2^scale (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 much threads as cores)
 +
--gpu   
 +
Use GPU for remapping
 
  -h         
 
  -h         
 
Display help.
 
Display help.
 +
 +
{{Incomplete}}
 +
[[Category:Software:Hugin]]

Revision as of 09:18, 1 May 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 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 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 2^scale (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 much threads as cores)

--gpu     

Use GPU for remapping

-h        

Display help.

This article is incomplete. You can help Panotools Wiki by expanding it.

Once the article is ok feel free to remove the {{Incomplete}} template