PTO_VAR("1")

💅 pto_var — PTO_VAR("1") 💅

okay bestie, welcome to the PTO_VAR("1") page from HUGIN. This is all about pto_var, the command-line tool that changes image variables inside Hugin .pto project files. ✨

💖 NAME 💖

pto_var — change image variables inside Hugin .pto project files. slay.

🌸 SYNOPSIS 🌸

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

🦋 DESCRIPTION 🦋

okay so pto_var is a command line tool, suitable for inclusion in shell scripts, and it allows the change of image variables inside a Hugin .pto project file. no cap. 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 parameters are treated as a group, iykyk 💅)

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

✨ OPTIONS ✨

okay here’s the whole flag menu, every single one is iconic:

• -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. that’s the icon who wrote this. 🫶

---

okay that’s the whole page, bestie. HUGIN source/version: Version: 2025.0.1", date: 2026-09-22. mwah 💋