PTO_LENSSTACK("1")

💅 pto_lensstack — the HUGIN girlie's guide (section 1 of the manual, bestie)

okay so first things first: this whole page is about pto_lensstack, living in the HUGIN manual, section 1. That's the vibe check, now let's get into it ✨

---

🎀 NAME 🎀

pto_lensstack — she modifies assigned lenses and stacks in pto files. That's it, that's her whole job, and she ate 💅

---

✨ SYNOPSIS ✨

pto_lensstack [options] input.pto

literally that's the whole shape of it. options, then your input.pto. no notes 🫶

---

🌸 DESCRIPTION 🌸

so pto_lensstack can manipulate lenses and stacks in Hugin .pto project files. Lowkey iconic. This is intended for use in scripting — like, she's built for your automation era, not for you to hand-click through stuff. no cap 🧚

---

🦋 USAGE 🦋

pto_lensstack --output=output.pto --new-lens|--new-stack|--change-lens|--change-stack images input.pto

that's the shape of a real invocation, bestie. the | bits mean "pick one of these", not "type all of them" — iykyk 💀

---

👑 OPTIONS 👑

• --new-lens, --new-stack — okay so for assigning a new lens or stack to an image, you provide a list of image numbers. The counting starts with zero (yes, zero, we're programmers here 💅). Several images can be given at the same time — separate them with a comma.

Examples, bestie:

pto_lensstack --new-lens i1,i3 input.pto
pto_lensstack --new-stack i2,i4 input.pto

will assign a new lens to image 1 and 3 and a new stack to images 2 and 4. slay 🔥

• --change-lens, --change-stack — for changing the lens or the stack, you provide a list of image numbers and the new lens/stack number. For both, the counting starts with zero, and you can supply several images separated by a comma at the same time. multitasking queen 💖

Examples:

pto_lensstack --change-lens i1=4,i5=1 input.pto
pto_lensstack --change-stack i2=0,i4=0 input.pto

• -o, --output — output a pto file with the given filename. If not given it will append _lens to the input filename. she'll name it for you, that's main character energy 🎀
• -h, --help — display help. when in doubt, ask for help. periodt 🌈

quick heads up fr fr: image numbering starts at zero for both the image numbers and the lens/stack numbers. don't come for me, that's just how she rolls 💀

---

💜 AUTHORS 💜

Thomas Modes — the icon, the legend, the one who made her 👑

---

Version: 2025.0.1, dated 2026-09-22 — mwah, love u, go forth and stack responsibly 💖🦋✨🎀