.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    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
.\" ========================================================================
.\"
.IX Title "AUTOOPTIMISER ""1"""
.TH AUTOOPTIMISER """1""" 2023-10-06 """Version: 2022.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
autooptimiser \- Optimize image positions
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBautooptimiser\fR [options] \fIproject.pto\fR
.PP
(\fB\-\fR can be specified to read the project from stdio.)
.SH DESCRIPTION
.IX Header "DESCRIPTION"
autooptimiser works similarly to PToptimizer but with extra command-line
options.
.PP
It is also different in that PToptimizer appends its output onto the input file
in the form of 'o' lines which need further processing.  autooptimiser simply
updates the project and writes it to a new file.
.SH OPTIONS
.IX Header "OPTIONS"
.IP "\fB\-o\fR \fIfile.pto\fR" 4
.IX Item "-o file.pto"
Output file. If omitted, stdout is used.
.PP
Optimisation options (if not specified, no optimisation takes place):
.IP \fB\-a\fR 4
.IX Item "-a"
Auto align mode, includes various optimisation stages, depending on
the amount and distribution of the control points
.IP \fB\-p\fR 4
.IX Item "-p"
Pairwise optimisation of yaw, pitch and roll, starting from first
image
.IP \fB\-m\fR 4
.IX Item "-m"
Optimise photometric parameters
.IP \fB\-n\fR 4
.IX Item "-n"
Optimize parameters specified in script file (like PToptimizer).
.PP
Post-processing options:
.IP \fB\-l\fR 4
.IX Item "-l"
Level horizon (works best for horizontal panoramas)
.IP \fB\-s\fR 4
.IX Item "-s"
Automatically select a suitable output projection and size
.PP
Other options:
.IP \fB\-q\fR 4
.IX Item "-q"
Quiet operation (no progress is reported)
.IP "\fB\-v\fR \fIHFOV\fR" 4
.IX Item "-v HFOV"
Specify horizontal field of view of input images. Used if the .pto
file contains invalid HFOV values (autopano-SIFT writes .pto files
with invalid HFOV)
.PP
When \fB\-a\fR, \fB\-l\fR, \fB\-m\fR and \fB\-s\fR options are used together, an operation similar
to the one of the "Align" button in hugin is performed.
.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.
.PP
This man page was written by Cyril Brulebois
<cyril.brulebois@enst\-bretagne.fr> and is licensed under the same
terms as the hugin package itself.
