.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16) .\" .\" 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" '' '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 turned on, 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. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" .\" 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" "2013-11-09" """Version: 2013.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: .PP .Vb 3 \& 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.) .Ve .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: _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