1PTO_VAR("1")                         HUGIN                        PTO_VAR("1")
2
3
4

NAME

6       pto_var - change image variables inside Hugin .pto project files
7

SYNOPSIS

9       pto_var [options] --opt|--link|--unlink|--set "image variables list
10       input.pto
11

DESCRIPTION

13       pto_var is a command line tool, suitable for inclusion in shell
14       scripts, and allows the change of image variables inside a Hugin .pto
15       project file.  Optimisation variables can be set, altered, linked and
16       unlinked, The following image variables are allowed:
17
18           position: y, p, r, TrX, TrY, TrZ lens parameters: v, a, b, c, d, e,
19           g, t photometric parameters: EeV, Er, Eb, Vb, Vc, Vd, Vx, Vy, Ra,
20           Rb, Rc, Rd, Re (Vignetting and response parameter will treated as
21           group.)
22
23       The image numbers start with zero.  If the number is missing this
24       applies to the variables of all images (In this case a special
25       treatment applies to the position of the anchor image).  An exclamation
26       mark before the variable will remove the variable from the list of
27       variables to optimised.
28

OPTIONS

30       -o|--output = file.pto
31           Output Hugin PTO file. Default: <filename>_var.pto
32
33       -h|--help
34           Shows help
35
36       --opt varlist
37            Change optimizer variables
38
39       --modify-opt
40              Modify the existing optimizer variables
41              (without pto_var will start with an
42               empty variables set)
43              Examples:
44              --opt=y,p,r           Optimize yaw, pitch and roll of all images
45                                    (special treatment for anchor image applies)
46              --opt=v0,b2           Optimize hfov of image 0 and barrel distortion
47                                    of image 2
48              --opt=v,!v0           Optimize field of view for all images except
49                                    for the first image
50              --modify-opt --opt=!v will not optimize field of view.
51              --opt=!a,!b,!c        Don't optimise distortion (works only with
52                                    switch --modify-opt together)
53
54       --link varlist
55              Example:
56              --link=v3          Link hfov of image 3
57              --link=a1,b1,c1    Link distortions parameter for image 1
58
59       --unlink varlist
60              Examples:
61              --unlink=v5        Unlink hfov for image 5
62              --unlink=a2,b2,c2  Unlink distortions parameters for image 2
63
64       --set varlist
65              Examples:
66              --set=y0=0,r0=0,p0=0  Resets position of image 0
67              --set=Vx4=-10,Vy4=10  Sets vignetting offset for image 4
68              --set=v=20            Sets the field of view to 20 for all images
69              --set=y=val+20        Increase yaw by 20 deg for all images
70              --set=v=val*1.1       Increase fov by 10 % for all images
71              --set=y=i*20        Set yaw to 0, 20, 40, ...
72
73       --set-from-file filename
74                                    Sets variables to new values
75                                    It reads the varlist from a file
76

AUTHORS

78       Thomas Modes
79
80
81
82"Version: 2022.0.0"               2023-01-19                      PTO_VAR("1")