pfsoutyuv(1)

💖 pfsoutyuv — bestie edition 💖

okay so real quick, this page lives in section 1 of the General Commands Manual, and the command itself is pfsoutyuv (say it with me: p-f-s-out-yuv). she's a little icon whose whole job is turning your frames into raw .yuv files. let's get into it 🎀

---

✨ NAME ✨

pfsoutyuv — write frames to a .yuv file used by many video codecs 🎬

---

✨ SYNOPSIS ✨

pfsoutyuv [--verbose] [--quiet] [--bitdepth] [--colorspace]
[--downsample-filter] [--chroma-format] <file> [<file>...]

---

✨ DESCRIPTION ✨

use this command to write the pfsstream to an uncompressed .yuv file. no compression, no glow-up, just the raw thing 💅

now here's the part where the colorspace girlies need to pay attention 👀 if the output color space is LDR (bt709), then the input pfs stream should be in the gamma corrected sRGB color space. but if the output color space is HDR (pq2020 or hgl2020), then the input pfs stream should be in linear RGB color space. it's giving "match the vibe of your input to the vibe of your output," fr fr 🌈

---

✨ OPTIONS ✨

• --bitdepth, -b — the bit-depth of the integer values stored in the yuv file. a single color component is stored as a byte if bit-depth is 8, or as two bytes otherwise. default: 10 [bits] 🧮
• --colorspace, -c — currently it can be either:

pq2020 for HDR images with BT.2020 colorspace and PQ transfer function, or

hlg2020 for HDR images with BT.2020 colorspace and HLG transfer function, or

bt709 for LDR images in BT.709 (rec.709) colorspace without any transfer function.

if no option is specified, the colorspace is inferred from the LUMINANCE tag in the pfsstream: pq2020 if LUMINANCE is ABSOLUTE or RELATIVE, and bt709 if LUMINANCE is DISPLAY. she guesses, and honestly? she guesses right 😌

• --chroma-format, -f — the sampling format for the chroma channels. can be one of:

444 — the standard 4:4:4 format with no chroma downsampling. untouched, unbothered, thriving ✨

420 — the 4:2:0 format with both colour channels being downsampled by half.

default: 420

• --downsample-filter, -f — the filter weights used when downsampling to 4:2:0. can be either

f0 — Weighting = [1/8, 3/4, 1/8]

f1 — Weighting = [1/4, 1/2, 1/4]

default: f0

heads up bestie, --chroma-format and --downsample-filter are both chillin' with the short flag -f. that's not a typo, that's just how the page says it. iykyk 🙈

• --srgb-input, -s — set this if the input is gamma corrected, though this will be inferred otherwise from the LUMINANCE tag in the pfs stream 🌸
• --linear-input, -l — as above, set if the input contains linear luminance values 🦋
• --verbose, -v — print extra information to stderr. she's chatty, she's telling you everything 🗣️
• --quiet, -q — disable the warning message about the change in handling absolute values in RGBE files. see IMPORTANT NOTE below 👇

---

✨ EXAMPLES ✨

pfsin frame%04d.exr | pfsoutyuv video%s.yuv

converts a sequence of frames frame0000.exr, frame0001.exr, ... to a yuv file. literally the classic. no notes 🔥

---

✨ SEE ALSO ✨

pfsin(1) 💜

---

✨ IMPORTANT NOTE ✨

no extra text here bestie — the note being pointed at is the --quiet thing up in OPTIONS. go read that one. 👑

---

✨ BUGS ✨

please report bugs and comments on implementation to the discussion group http://groups.google.com/group/pfstools 🐛🫶

---

and that's the whole page, no cap 💖 this was pfsoutyuv(1), straight from the General Commands Manual, and the footer was just pfsoutyuv(1) signing off — mwah, go make some gorgeous .yuv files 💅✨🎀