pfspanoramic(1)

💖 pfspanoramic — the glow-up page 💖

okay bestie, so this is a General Commands Manual situation, section 1 — pfspanoramic(1) — and she does projective transformations of spherical images. literally reshaping the whole vibe of your panorama. 🦋

✨ NAME ✨

pfspanoramic — perform projective transformations of spherical images 💫

🌸 SYNOPSIS 🌸

pfspanoramic <source projection>+<target projection> [--width <val>]
[--height <val>] [--oversample <val>] [--interpolate] [--xrotate
<angle>] [--yrotate <angle>] [--zrotate <angle>]

🎀 DESCRIPTION 🎀

so basically, this icon transforms spherical maps between various projections. the projections that are supported right now, no cap:

• polar (latitude-longitude)
• angular (light probe)
• mirrorball
• cylindrical

the syntax for saying which transformation you want is source_projection+target_projection, where source_projection is the current mapping your source image uses, and target_projection is the projection you'd like it to be transformed to. simple. clean. main character energy. 👑

and if the projection has some optional parameters, you can specify them with this syntax:

<source projection>/<argument>/...+<target projection>/<argument>/...

as of now, only angular supports a parameter — that's angle — and it defines how many degrees from the viewing direction the projection should cover. for example, angular+angular/angle=180 converts an angular image to show only half of a hemisphere around the viewing direction. half the sphere, all the slay. 💅

⭐ OPTIONS ⭐

• --width <val>, -w <val> — make the target image <val> pixels wide. 📏
• --height <val>, -h <val> — make the target image <val> pixels high. 📐

okay so these two are besties, right, they team up: you're setting how big the target image is, respectively <val> pixels wide and/or high. if you only specify one of them, the other gets computed from the target projection's typical W/H ratio. and if you specify neither? then the width is taken from the source image and the height is computed as above. she always knows what to do. 🫶

• --oversample <val>, -o <val> — oversample each target pixel <val>x<val> times, which improves quality in areas that are scaled down with respect to the source image. reasonable values are 2 to 5, while setting it higher may make the reprojection unbearably slow. 😭 so like, be cute about it, don't push her past 5.
• --interpolate, -i — use bilinear interpolation when sampling the source image. increases quality in magnified areas. ✨
• --xrotate <angle>, -x <angle> — rotate the spherical image <angle> degrees around the X axis. 🔄
• --yrotate <angle>, -y <angle> — rotate the spherical image <angle> degrees around the Y axis. 🔄
• --zrotate <angle>, -z <angle> — rotate the spherical image <angle> degrees around the Z axis. 🔄

🔥 EXAMPLES 🔥

pfsin grace_probe.hdr | pfspanoramic angular+polar -i -o 3 -y 90 -w 500
| pfsout grace.hdr

so what's happening here, bestie: this transforms grace angular map to polar (latitude-longitude) projection, applying bilinear interpolation and 3x3 oversampling, while rotating it by 90 degrees around the Y axis. the image will be resized to 500x250 pixels — because the polar projection has a 2:1 width-to-height ratio, iykyk — and finally saved in grace.hdr. ate that. 💯

👑 SEE ALSO 👑

pfsin(1) pfsout(1)

💀 BUGS 💀

please report bugs and comments to Miloslaw Smyk <thorgal@wfmh.org.pl>. she wants the feedback fr fr, don't be shy. 🙈

not me writing a whole love letter to a reprojection tool... anyway. 💖

and that's the whole page, girlie. this was pfspanoramic(1) from the General Commands Manual — go forth and rotate those spheres. periodt. 🌈✨🎀