pto_var(1) change image variables inside Hugin .pto project files

SYNOPSIS

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

DESCRIPTION

pto_var 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:

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.)

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.

OPTIONS

-o|--output = file.pto
Output Hugin PTO file. Default: <filename>_var.pto
-h|--help
Shows help
--opt varlist
 Change optimizer variables
--modify-opt
   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't optimise distortion (works only with
                         switch --modify-opt together)
--link varlist
   Example:
   --link=v3          Link hfov of image 3
   --link=a1,b1,c1    Link distortions parameter for image 1
--unlink varlist
   Examples:
   --unlink=v5        Unlink hfov for image 5
   --unlink=a2,b2,c2  Unlink distortions parameters for image 2
--set varlist
   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, ...
--set-from-file filename
                         Sets variables to new values
                         It reads the varlist from a file

AUTHORS

Thomas Modes