PTOVARIABLE(1)

📦
version 0.29 · 2 versions
, in fedora 43

💖 PTOVARIABLE ✨

okay bestie, so this is a User Contributed Perl Documentation page for ptovariable (that's section 1 of the manual, iykyk) and it's literally about prepping your pto project for the most typical optimisation tasks ever. sit down, hydrate, let's go 🫶

🌸 NAME 🌸

ptovariable — prepare a pto project for typical optimisation tasks

🎀 SYNOPSIS 🎀

ptovariable [options] project.pto

 Options:
       --positions          Optimise positions
       --roll               Optimise roll for all images except anchor if --positions not set
       --pitch              Optimise pitch for all images except anchor if --positions not set
       --yaw                Optimise yaw for all images except anchor if --positions not set
       -r <num> <num> <..>  Optimise roll for specified images
       -p <num> <num> <..>  Optimise pitch for specified images
       -y <num> <num> <..>  Optimise yaw for specified images
       --translations       Optimise XYZ mosaic translations for all images except anchor
       -TrX <num> <..>      Optimise X translation for specified images
       -TrY <num> <..>      Optimise Y translation for specified images
       -TrZ <num> <..>      Optimise Z translation for specified images
       --view               Optimise angle of view
       --barrel             Optimise barrel distortion
       --centre             Optimise optical centre
       --vignetting         Optimise vignetting
       --vignetting-centre  Optimise vignetting centre
       --response           Optimise camera response EMoR parameters
       --exposure           Optimise exposure (EV)
       --white-balance      Optimise colour balance
  -o | --output OUTFILE     Specify output file default is to overwrite input
  -h | --help               Outputs help documentation

🦋 DESCRIPTION 🦋

so basically ptovariable sets optimisation variable v lines for a hugin .pto project. that's it, that's the whole job 💅 and usually? it's the little prep step before you go optimise with autooptimiser or vig_optimize. it's giving backstage crew, honestly.

💜 OPTIONS 💜

okay here's the full menu, no skips, no skimming, we're listing all of them because you deserve the whole thing:

  • --positions — optimise positions
  • --roll — optimise roll for all images except anchor if --positions not set
  • --pitch — optimise pitch for all images except anchor if --positions not set
  • --yaw — optimise yaw for all images except anchor if --positions not set
  • -r <num> <num> <..> — optimise roll for specified images
  • -p <num> <num> <..> — optimise pitch for specified images
  • -y <num> <num> <..> — optimise yaw for specified images
  • --translations — optimise XYZ mosaic translations for all images except anchor
  • -TrX <num> <..> — optimise X translation for specified images
  • -TrY <num> <..> — optimise Y translation for specified images
  • -TrZ <num> <..> — optimise Z translation for specified images
  • --view — optimise angle of view
  • --barrel — optimise barrel distortion
  • --centre — optimise optical centre
  • --vignetting — optimise vignetting
  • --vignetting-centre — optimise vignetting centre
  • --response — optimise camera response EMoR parameters
  • --exposure — optimise exposure (EV)
  • --white-balance — optimise colour balance
  • -o | --output OUTFILE — specify output file, default is to overwrite input 👀 yes, it will just eat your input file if you don't say otherwise
  • -h | --help — outputs help documentation

🌈 EXAMPLES 🌈

✨ the "Positions, View and Barrel" preset moment

this does the equivalent of the Positions, View and Barrel (y,p,r,v,b) preset on the hugin Optimiser tab:

ptovariable --positions --view --barrel project.pto
autooptimiser -n -o project.pto project.pto

✨ the "Low dynamic range" preset moment

this is the equivalent of the Low dynamic range preset on the hugin Exposure tab:

ptovariable --vignetting --response --exposure project.pto
vig_optimize -o project.pto project.pto

✨ the pick-and-choose moment

and additionally individual parameters can be set for particular photos:

ptovariable -r 1 2 3 4 -p 4 project.pto

🧚 LICENSE 🧚

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

⭐ SEE ALSO ⭐

👑 AUTHOR 👑

Bruno Postle — April 2009.

and that's the whole page, bestie 🎀 this was PTOVARIABLE(1), generated by perl v5.42.0 on 2025-07-25. slay, go optimise something gorgeous 💖✨

📦 where this page comes from