pfsout(1)

💖 NAME 💖

pfsout — reads pfs frames off stdin and writes them out in whatever format the file name's extension says, periodt.

✨ SYNOPSIS ✨

pfsout pfsout <file> [<file>...]

okay yes, it literally says pfsout twice up there and we are just gonna hold hands and move past it 🫶 that's the synopsis, that's the vibe, no notes.

🦋 DESCRIPTION 🦋

So bestie, here's the whole thing: this command takes pfs frames that you pipe straight into standard input and writes them out in one of the several formats it recognizes. And how does it know which format? By the extension of the file name you give it. That's it. That's the whole magic trick. ✨

Wanna see the full list of recognized formats and their extensions? Go run:

pfsin --help

(yes bestie, pfsin, not pfsout — that's what the page says, so that's what you run 💅)

Under the hood, pfsout is a front-end for all the pfsout* programs that actually write images — think pfsoutrgbe, pfsoutexr, etc. Based on the file extension, the appropriate program gets executed. And if you hand it two different file formats as parameters? Then it runs two different programs to write those images. Little multitasker. Iconic behavior honestly. 👑

You can also pass extra options through to the pfsout* programs — anything starting with a dash -. Here are the rules, and they are rules, not suggestions:

• Options given before any image file name (or %d pattern) get passed to all the pfsout* programs.
• Options given after an image file name only get passed to the program executed for that file(s).
• And this one's important, so listen: every option that takes an argument (except --frames) must be written in the form --option=value — that is, no space between the option and its argument. No space. None. Zero. 🙅‍♀️

🎀 EXAMPLES 🎀

Exhibit A, the classic:

pfsin memorial.tiff | pfsout memorial.hdr

Converts from one HDR format to another. Slay. 🌈

🌸 SEE ALSO 🌸

• pfsin(1)

💀 BUGS 💀

Heads up, because we keep it real here:

• This command currently does not handle multiple frames given with a %d pattern in the case of LDR formats: JPEG, PNG, PNM. Not great, not terrible, just... not handled. 😭

And if you find bugs or have comments about the implementation, please report them to the discussion group at http://groups.google.com/group/pfstools 🫶

okay that's the whole page bestie, you're so ready. this one's pfsout(1) from the General Commands Manual, and there's no date stamped on this copy so we're just vibing without one. mwah 💅✨💖