.\" -*- 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 "PTO_VAR ""1"""
.TH PTO_VAR """1""" 2024-03-20 """Version: 2023.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
pto_var \- change image variables inside Hugin .pto project files
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBpto_var\fR [options] \-\-opt|\-\-link|\-\-unlink|\-\-set "image variables list input.pto
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBpto_var\fR is a command line tool, suitable for inclusion in shell scripts, and allows the change of image variables inside a Hugin .pto project file.
Optimisation variables can be set, altered, linked and unlinked,  
The following image variables are allowed:
.Sp
.RS 4
position: y, p, r, TrX, TrY, TrZ
lens parameters: v, a, b, c, d, e, g, t
photometric parameters: EeV, Er, Eb, Vb, Vc, Vd, Vx, Vy, Ra, Rb, Rc, Rd, Re (Vignetting and response parameter will treated as group.)
.RE
.PP
The image numbers start with zero.
If the number is missing this applies to the variables of all images (In this case a special treatment applies to the position of the anchor image).
An exclamation mark before the variable will remove the variable from the list of variables to optimised.
.SH OPTIONS
.IX Header "OPTIONS"
.IP "\fB\-o|\-\-output\fR = file.pto" 4
.IX Item "-o|--output = file.pto"
Output Hugin PTO file. Default: <filename>_var.pto
.IP \fB\-h|\-\-help\fR 4
.IX Item "-h|--help"
Shows help
.IP "\fB\-\-opt\fR varlist" 4
.IX Item "--opt varlist"
.Vb 1
\& Change optimizer variables
.Ve
.IP \fB\-\-modify\-opt\fR 4
.IX Item "--modify-opt"
.Vb 10
\&   Modify the existing optimizer variables
\&   (without pto_var will start with an 
\&    empty variables set)
\&   Examples:
\&   \-\-opt=y,p,r           Optimize yaw, pitch and roll of all images
\&                         (special treatment for anchor image applies)
\&   \-\-opt=v0,b2           Optimize hfov of image 0 and barrel distortion
\&                         of image 2
\&   \-\-opt=v,!v0           Optimize field of view for all images except
\&                         for the first image
\&   \-\-modify\-opt \-\-opt=!v will not optimize field of view.
\&   \-\-opt=!a,!b,!c        Don\*(Aqt optimise distortion (works only with
\&                         switch \-\-modify\-opt together)
.Ve
.IP "\fB\-\-link varlist\fR" 4
.IX Item "--link varlist"
.Vb 3
\&   Example:
\&   \-\-link=v3          Link hfov of image 3
\&   \-\-link=a1,b1,c1    Link distortions parameter for image 1
.Ve
.IP "\fB\-\-unlink varlist\fR" 4
.IX Item "--unlink varlist"
.Vb 3
\&   Examples:
\&   \-\-unlink=v5        Unlink hfov for image 5
\&   \-\-unlink=a2,b2,c2  Unlink distortions parameters for image 2
.Ve
.IP "\fB\-\-set varlist\fR" 4
.IX Item "--set varlist"
.Vb 7
\&   Examples:
\&   \-\-set=y0=0,r0=0,p0=0  Resets position of image 0
\&   \-\-set=Vx4=\-10,Vy4=10  Sets vignetting offset for image 4
\&   \-\-set=v=20            Sets the field of view to 20 for all images
\&   \-\-set=y=val+20        Increase yaw by 20 deg for all images
\&   \-\-set=v=val*1.1       Increase fov by 10 % for all images
\&   \-\-set=y=i*20        Set yaw to 0, 20, 40, ...
.Ve
.IP "\fB\-\-set\-from\-file filename\fR" 4
.IX Item "--set-from-file filename"
.Vb 2
\&                         Sets variables to new values
\&                         It reads the varlist from a file
.Ve
.SH AUTHORS
.IX Header "AUTHORS"
Thomas Modes