pfscat(1)

💖 pfscat — the stitch ur frames together era 💖

okay bestie, real talk: this is pfscat, and it lives in the General Commands Manual section of the manual pages (so when u see pfscat(1) that (1) is just its section badge 🎀). It concatenates frames in a PFS stream. Like, it takes a bunch of frames and glues them into one big frame. Slay.

✨ NAME ✨

pfscat — concatenate frames in a PFS stream 🧩

🌈 SYNOPSIS 🌈

pfscat [--horizontal] [--vertical] [-j <type>] [-R <val>] [-G <val>] [-B
<val>] [-Y <val>] [--help] image1.pfs image2.pfs ...

💅 DESCRIPTION 💅

So here's the vibe: pfscat reads a whole bunch of frames as input, stitches them either horizontally or vertically, and spits out a single frame as output. Main character energy fr fr.

But here's the plot twist 😭 — if the frames aren't all the same size, they get justified against each other. By default they're centered (cute, balanced, symmetric 💖), but u can also flush them up against a specified edge. iykyk.

🎀 OPTIONS 🎀

• --horizontal, -H — Stitch those frames horizontally. Side by side, bestie to bestie 🫶
• --vertical, -V — Stitch those frames vertically. Stacked like a lil frame tower 🏗️
• -j <type> — Specify the justification of the input frames. The predefined types are: min, max, center. That's it, that's the list 🎯
• -R <val>, -G <val>, -B <val> — The color of an extra space in the resulting image (u know, the lil gaps when ur frames don't line up perfectly). Default color is black, and if some of the components isn't specified, its value gets set to 0.0. no cap.
• -Y <val> — The color of an extra space in luminance mode. For when u live in grayscale ✨
• --help, -h — Print a list of commandline options. ur lil cheat sheet, periodt 📋

🦋 EXAMPLES 🦋

pfsinmulti anim1_%04d.hdr anim2_%04d.hdr -- pfscat @1 @2 --vertical

So this one is iconic actually. It stitches two hdr animations in vertical alignment. But watch out — pfscat is being taken as an argument by pfsinmulti, so it must be preceded with --. That's the little handshake 🤝. Also: the number of @1 @2 ... @n arguments must be the same as the number of animations u want to combine. Match them up or it's giving chaos 💀

🌸 NOTES 🌸

heads up bestie: either the --horizontal or the --vertical option must be specified. u gotta pick a lane, fr fr. 🙈

⭐ SEE ALSO ⭐

pfsin(1) pfsout(1)

💀 BUGS 💀

Found a bug? Got comments? Please report bugs and comments to Dorota Zdrojewska <dzdrojewska@wi.ps.pl> 📧 she's the one to tell, not me!!

✨ ok that's the whole page, bestie ✨ this lil slice of the General Commands Manual was brought to u by pfscat(1) — go forth and stitch, u absolute legend 👑💖