pfsinexr(1)

💖 pfsinexr — bestie edition 💖

okay so real talk, pfsinexr is the glow-up tool from the General Commands Manual, and it's here to load images or frames in OpenEXR format. she's iconic, she's specific, and she knows exactly what she's doing. 🎀

✨ SYNOPSIS ✨

pfsinexr [--keep-rgb] (<file> [--frames <range>] [--skip-missing])
[<file>...]

🌸 DESCRIPTION 🌸

So like, use this command when you wanna read frames in OpenEXR format, bestie. The frames get converted into a pfs stream and then sent straight to the standard output. 💅 She can read arbitrary channels from OpenEXR files, no big deal — but the color channels XYZ get special treatment, and if you wanna know what that's about, go look at the --keep-rgb option below, iykyk.

pfsinexr also reads all the string attributes from the OpenEXR file and writes them out as tags in the pfs stream. Attributes of other types? Not invited to the party, they get ignored, sorry. 🙈 And here's a lil detail that matters: if an attribute name contains a colon (:), then the part before the colon is treated as a channel name, and the attribute gets assigned to that channel — same notation as the command line argument of the pfstag program. periodt.

Now, pfsinexr recognizes the OpenEXR standard attribute WhiteLuminance and multiplies the data by that value to get absolute luminance values (also peep the --fix-halfmax switch in pfsoutexr, they're giving linked-energy 💞). On top of that, the tag LUMINANCE is set to ABSOLUTE unless the OpenEXR file contains an attribute LUMINANCE set to something else. Which is basically saying: channel Y is assumed to represent absolute luminance levels in cd/m^2. no cap. ⭐

If an OpenEXR file contains a 'Z' channel, it gets renamed to 'DEPTH' — because otherwise it would beef with the Z color channel for the XYZ color space, and we do not do conflict here. 🚫

Wanna know the deets on the format of the pattern file names, the ones used for reading multiple frames? Those live in the manual page of pfsinppm. 🦋

And if you want a file format to be auto-recognized from the extension, use the pfsin command instead — she's the main character for that job. 👑

the one option in here 👇

• --keep-rgb — by default, the color channels R, G and B from an OpenEXR file get converted to XYZ color space, which is the suggested format for color data in pfs. But when you specify the keep-rgb option, the color channels RGB are stored as they are, with zero conversion. not a single transformation. 🫶

🎀 EXAMPLES 🎀

pfsin memorial.exr | pfsout memorial.hdr

Converts from one HDR format to another. slay. 🔥

💀 BUGS 💀

pfsinexr and pfsoutexr can not take stdin / stdout as an input/output (so like, the dash '-' instead of a file name). it's giving limitation, and we respect it. 😭

Please report bugs and comments on implementation to the discussion group http://groups.google.com/group/pfstools — they wanna hear from you fr fr. 💜

🌈 SEE ALSO 🌈

pfsin(1) pfsinppm(1) pfsoutexr(1)

and that's the whole page, bestie — this was pfsinexr(1) hanging out in the General Commands Manual, brought to you by pfstools. go read an EXR file about it. 🧚✨