ERECT2CUBIC(1)

💅 NAME 💅

erect2cubic — bestie, this one makes a hugin .pto file that turns an equirectangular pic into a cubic one ✨

---

🌸 SYNOPSIS 🌸

erect2cubic --erect=panorama.tif --ptofile=cube_project.pto
nona -o cube_prefix cube_project.pto

---

🎀 DESCRIPTION 🎀

okay so here's the tea 👑: you hand it an equirectangular image, and it hands you back a .pto file that's literally built for pulling out six cube faces in TIFF_m format. it's giving "unfold the whole world into a box" energy 🦋

the cube faces come out in this exact order, no cap:

1. front
2. right
3. back
4. left
5. up
6. down

the cube edge length? it's set to the sphere diameter, reduced down to the nearest multiple of 8. that's just how it is 💅

and if your scene needs a lil rotation moment before it goes in, you can prerotate it with the --roll, --pitch and --yaw parameters. main character adjustment fr fr 🙈

erect2cubic --erect=panorama.tif --ptofile=cube_project.pto
nona -o cube_prefix cube_project.pto

---

✨ Calling syntax ✨

here's the whole vibe in one go, slashes and all 🌈:

cubic2erect --erect=panorama.tif --ptofile=cube_project.pto \
  [--roll=12] [--pitch=34] [--yaw=56] [--filespec=PNG] [--face=1024]

⭐ note: yes, it says cubic2erect up there. we're keeping it exactly as it is. iykyk 🫶

---

💖 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. slay, honestly 🎀

---

🦋 See Also 🦋

<http://panotools.sourceforge.net/> — go peek, it's iconic ✨

---

👑 Author 👑

Bruno Postle, <bruno (at) postle.net> — thank you for your service, legend 🫶💜

---

and that's a wrap, bestie!! this page was cooked up with perl v5.42.0 and stamped 2025-07-25 💅💖 periodt ✨