PTO_GEN("1")

📦
version 2025.0.1 · 11 versions
, in arch rolling

🌸 pto_gen — the HUGIN girlies' project-file maker 💅

okay so bestie, welcome to pto_gen, straight out of the HUGIN manual section 1 🎀. This is the little tool that takes your pile of photos and turns it into a whole project — no cap.

✨ NAME ✨

pto_gen — generates a Hugin project file from a list of images. that's literally the whole job. iconic behavior honestly 🫶

🦋 SYNOPSIS 🦋

pto_gen [options] image [...]

so you give it some options (or don't, she's flexible 💅) and then a bunch of images. slay.

💖 DESCRIPTION 💖

okay so here's the tea ☕ — pto_gen assembles a Hugin .pto project file, and that file is chef's kiss suitable as input for further tools, like the cpfind control-point generator, or for opening right up with the Hugin panorama GUI itself. she's ready for her main character moment the second she's born ✨

and function-wise? functionality is similar to match-n-shift. iykyk 💜

🌈 USAGE 🌈

pto_gen *.jpg

ok so this one line does A LOT bestie — it creates a project file from all the jpg images 🍓 and the file lands in the same folder as the first photo 🎀

and the name? it's named first_file-last_file.pto, using the same convention as the Hugin GUI. so cute, so consistent, we love a naming scheme that just works 💅

👑 OPTIONS 👑

  • -o, --output file — output Hugin PTO file. this is your "where do i want her to live" option 💖
  • -p, --projection num — projection type (default: 0) 🌸
  • -f, --fov float — horizontal field of view of images (default: 50) 🦋
  • -c, --crop= left,right,top,bottom — sets the crop of input images (especially for fisheye lenses 🐟) — yes she takes all four numbers, in that exact order, no shuffling 🙈
  • -s, --stacklength num — number of images in stack (default: automatic detection) — she'll figure it out herself, lowkey genius 🧚
  • -l, --linkstacks — link image positions in stacks 🔗
  • --distortion — try to load distortion information from lens database 👀
  • --vignetting — try to load vignetting information from lens database 👀✨
  • -h, --help — shows help 🫶 (she's helpful like that)
heads up bestie: --distortion and --vignetting both say "try to" load from the lens database — that's not me being cute, that's the actual wording, so don't come for me if the database doesn't have your lens 💀

💜 AUTHORS 💜

Thomas Modes — the legend, the moment, the author 👑✨

and that's the whole vibe check, bestie 💅 Version 2025.0.1, dated 2026-09-22 — go make some panoramas, you've got this 🎀🦋💖

📦 where this page comes from