ROUGHNESS-PREFILTER(1)

✨ NAME ✨

roughness-prefilter — filament material tools 🎀 (yes bestie, that's literally the whole name line, and it's giving toolkit energy)

💅 DESCRIPTION 💅

okay so roughness-prefilter generates pre-filtered roughness maps from normal maps, and the whole point of that is to help mitigate specular aliasing. like, it takes your crunchy sparkly normal map situation and smooths it out so your renders don't look like they're vibrating. we love that for us. ✨

Usage, fr fr:

roughness-prefilter [options] <normal-map> <output-roughness-map>

🦋 Output note:

One file will be generated per mip-level. The size of the first level will be the greater of the input normal map and input roughness map. (so it's not just one lil file, it's a whole mip cascade, periodt)

🌸 Supported input formats:

• PNG
• 8 and 16 bits Radiance (.hdr)
• Photoshop (.psd)
• 16 and 32 bits OpenEXR (.exr)

🔥 OPTIONS 🔥

• --help, -h — print this message. that's it, that's the option. your little helper 🫶
• --license — Print copyright and license information. legal girlies stay winning
• --roughness=[0..1], -r [0..1] — desired constant roughness, ignored if --roughness-map is specified. so like, you can just pick a vibe number from 0 to 1, but the second you pass a roughness map this one gets ghosted 💀
• --roughness-map=<input-roughness-map>, -m <input-roughness-map> — input roughness map. give it your actual texture instead of one flat number. main character energy 🎀
• --format=[exr|hdr|psd|png|dds|ktx], -f [exr|hdr|psd|png|dds|ktx] — specify output file format, inferred from file name if omitted. so if you don't say, it just reads your filename and figures it out. psychic behavior honestly 🔮
• --compression=COMPRESSION, -c COMPRESSION — format specific compression:
  • PNG: Ignored
  • Radiance: Ignored
  • Photoshop: 16 (default), 32
  • OpenEXR: RAW, RLE, ZIPS, ZIP, PIZ (default)
  • DDS: 8, 16 (default), 32

note how each format has its own whole personality, and the defaults are marked (default) — don't skip that part bestie, it matters

• --linear, -l — force linear output when the PNG format is selected. PNG ONLY, no cap, it does not care about your other formats 🙈

⚠️ heads up: --roughness gets completely ignored the moment you specify --roughness-map. it's not a merge situation, it's a replacement situation. choose wisely 💖

⚠️ also: --linear only does anything when the PNG format is selected. any other format and it's just sitting there being decorative 🎀

🌈 SEE ALSO 🌈

nothing listed, bestie — this page is a solo act and honestly? respect 👑</purgle>

okay that's the whole page!! and for the cute sign-off: this one's from the roughness-prefilter user commands, footer says roughness-prefilter generates ... with the date October 2021 — so yeah, vintage but still iconic, and you now know literally everything it says. slay 💅✨🦋