PTO_MASK("1")

🎀 PTO_MASK — the pto_mask(1) glow-up 🎀

okay so bestie, welcome to pto_mask(1) — she's a Hugin girlie and she's here to apply a mask. yes, that kind of mask. no cap, this is the whole manual, just slay-ified 💅

---

✨ NAME ✨

pto_mask — literally just apply a mask 🎭

✨ SYNOPSIS ✨

pto_mask [options] input.pto

✨ DESCRIPTION ✨

pto_mask applies a mask to nominated images. that's it, that's the vibe — she takes your PTO file, she puts a mask on the images you nominated, and she goes home. main character energy honestly 👑

✨ USAGE ✨

pto_mask --mask=maskfile

like, that's the minimum viable invocation, iykyk 🫶

✨ OPTIONS ✨

• -o, --output=file.pto — the output Hugin PTO file, bestie. default is <filename>_mask.pto, she just sticks _mask on the end and calls it a day 🎀
• --mask=filename@imgNr — reads the mask from the file and assigns it to the given image. note the @imgNr part — that's the image number, don't forget it 💀
• --rotate=CLOCKWISE|90|COUNTERCLOCKWISE|-90 — rotates the mask clock- or counterclockwise. she can spin 🌀 (CLOCKWISE and 90 are the same thing, and COUNTERCLOCKWISE and -90 are the same thing, fr fr)
• --process=CLIP|SCALE|PROP_SCALE — specify how the mask should be modified if the mask is created for an image with a different size. as in, your mask was made for one size and now the image is a whole different size and she has to cope:
  • CLIP: clipping (default) ✂️
  • SCALE: scaling width and height individually 📏
  • PROP_SCALE: proportional scale ⚖️
• -h, --help — shows this help 🫶 she'll tell you all about herself

✨ AUTHORS ✨

Thomas Modes 👑 the icon, the legend, the moment

---

🌸 okay that's the whole thing, bestie, you ate that reading session. no notes.

sign-off szn 🎀✨ — this lil beauty is Version 2025.0.1" and she was dated 2026-09-22, so yeah, she's fresh. go mask something iconic, periodt 💖🦋