.\" Automatically generated by Pod::Man 4.14 (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
..
.\" 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 "PTO_VAR ""1"""
.TH PTO_VAR "1" "2023-12-30" """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 \s-1PTO\s0 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