.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "ALIGN_IMAGE_STACK ""1"""
.TH ALIGN_IMAGE_STACK "1" "2018-11-21" """Version: 2018.0.0""" "HUGIN"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
align_image_stack \- Align overlapping images for HDR or focus stack creation
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBalign_image_stack\fR [options] \fIinput files\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
align_image_stack is used for the alignment of slightly misaligned images or for the
registration of a stereo images pair.  When several differently exposed images are
taken in the process of creating a High Dynamic Range image, the images are not
perfectly aligned, and the quality of the \s-1HDR\s0 image created will suffer from this.
align_image_stack uses the tools available to hugin to optimize the roll, pitch and
yaw, as well as some parameters of the lens geometry, to align the images.
.SH "OPTIONS"
.IX Header "OPTIONS"
Modes of operation:
.IP "\fB\-p\fR \fIfile\fR" 4
.IX Item "-p file"
Output .pto file (useful for debugging, or further refinement)
.IP "\fB\-a\fR \fIprefix\fR" 4
.IX Item "-a prefix"
Output aligned images as prefix_xxxx.tif
.IP "\fB\-o\fR \fIoutput\fR" 4
.IX Item "-o output"
Align images and merge them to \s-1HDR,\s0 generate output.hdr
.PP
Modifiers:
.IP "\fB\-v\fR" 4
.IX Item "-v"
Verbose, print progress messages. Repeat for higher verbosity
.IP "\fB\-e\fR" 4
.IX Item "-e"
Assume input images are full frame fish eye (default: rectilinear)
.IP "\fB\-t\fR \fInum\fR" 4
.IX Item "-t num"
Remove all control points with an error higher than num pixels
(default: 3)
.IP "\fB\-\-corr=num\fR" 4
.IX Item "--corr=num"
Correlation threshold for identifying control points (default: 0.9)
.IP "\fB\-f\fR \fI\s-1HFOV\s0\fR" 4
.IX Item "-f HFOV"
Approximate horizontal field of view of input images, use if \s-1EXIF\s0 info
not complete
.IP "\fB\-m\fR" 4
.IX Item "-m"
Optimize field of view for all images, except for first. Useful for
aligning focus stacks with slightly different magnification.
.IP "\fB\-d\fR" 4
.IX Item "-d"
Optimize radial distortion for all images, except for first.
.IP "\fB\-i\fR" 4
.IX Item "-i"
Optimize image center shift for all images, except for first.
.IP "\fB\-x\fR" 4
.IX Item "-x"
Optimize X coordinate of camera position
.IP "\fB\-y\fR" 4
.IX Item "-y"
Optimize Y coordinate of camera position
.IP "\fB\-z\fR" 4
.IX Item "-z"
Optimize Z coordinate of camera position
.IP "\fB\-S\fR" 4
.IX Item "-S"
Assume stereo images \- allow horizontal shift of control points.
.IP "\fB\-A\fR" 4
.IX Item "-A"
Align stereo window \- assumes \-S
.IP "\fB\-P\fR" 4
.IX Item "-P"
Align stereo window with pop-out effect \- assumes \-S
.IP "\fB\-C\fR" 4
.IX Item "-C"
Auto crop the image to the area covered by all images
.IP "\fB\-c\fR \fInum\fR" 4
.IX Item "-c num"
Number of control points (per grid) to create between adjacent images
(default: 8)
.IP "\fB\-l\fR" 4
.IX Item "-l"
Assume linear input files
.IP "\fB\-s\fR \fIscale\fR" 4
.IX Item "-s scale"
Scale down image by 2^scale (default: 1 [2x down\-sampling])
.IP "\fB\-g\fR \fIgsize\fR" 4
.IX Item "-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])
.IP "\fB\-\-distortion\fR" 4
.IX Item "--distortion"
Try to load distortion information from lens database
.IP "\fB\-\-use\-given\-order\fR" 4
.IX Item "--use-given-order"
Use the image order as given on the command line.
(By default images will be sorted by exposure values.)
.IP "\fB\-\-gpu\fR" 4
.IX Item "--gpu"
Use \s-1GPU\s0 for remapping
.IP "\fB\-h\fR" 4
.IX Item "-h"
Display help summary.
.SH "AUTHORS"
.IX Header "AUTHORS"
Written by Pablo d'Angelo. Also contains contributions from Douglas Wilkins, Ippei Ukai, Ed Halley, Bruno Postle, Gerry Patterson and Brent Townshend.  Stereo functionality added by Vladimir Nadvornik.
.PP
This man page was written by Cyril Brulebois
<cyril.brulebois@enst\-bretagne.fr>, updated by Terry Duell, and is licensed under the same
terms as the hugin package itself.