pfstmo_pattanaik00(1)

πŸ’– pfstmo_pattanaik00(1) β€” the Time-dependent Visual Adaptation Model, bestie edition πŸ’–

okay so. gather round. this is pfstmo_pattanaik00, a lil command from the General Commands Manual, and it is genuinely one of the coolest tone mappers out there. it's giving science + vibes. let's get into it πŸ¦‹


✨ NAME ✨

pfstmo_pattanaik00 β€” Time-dependent Visual Adaptation Model. that's the whole name, no notes, she ate.


🌸 SYNOPSIS 🌸

pfstmo_pattanaik00 [--time-dependence] [--fps <val>] [--mul
<multiplier>] [--local] [--cone <val>] [--rod <val>] [--verbose]
[--help]

πŸ‘‘ DESCRIPTION πŸ‘‘

this command implements a tone mapping operator as described in:

Time-Dependent Visual Adaptation for Realistic Image Display. S.N. Pattanaik, J. Tumblin, H. Yee, and D.P. Greenberg. In Proceedings of ACM SIGGRAPH 2000.

🚨 real talk: this operator requires properly calibrated image data (in cd/m2) and its results should be gamma corrected. don't skip that part bestie, i'm begging 😭

the local version of this operator is based on the following paper:

Adaptive Gain Control For High Dynamic Range Image Display. S.N. Pattanaik, H. Yee. In proceedings of SCCG 2002.


πŸ’… OPTIONS πŸ’…

  • --time-dependence, -t β€” use the time dependent model of adaptation. this is the one you want for tone mapping an animation. heads up tho: it has no influence on single-frame input. switched off by default. ⭐ Note: it is important to correctly set the speed of the input animation (--fps). like, important important.
  • --fps <val>, -f <val> β€” the speed of the input animation, in frames per second. used when time-dependence is switched on (-t). default value: 16.0. πŸŽ€
  • --mul <multiplier>, -m <multiplier> β€” multiply input values by a multiplier value. super useful if your input data is not calibrated. default value: 1.0.
  • --local, -l β€” use the local version of the tone mapping. lowkey a plot twist: time-dependent effects are cancelled while using the local version, and the global version is used by default.
  • --cone <val>, -c <val> β€” set the adaptation level for cones. and if you don't use the --rod parameter, this will also set the adaptation level for rods. by default, the adaptation level is calculated as a logarithmic average of luminance in the input image. 🧚
  • --rod <val>, -r <val> β€” set the adaptation level for rods. by default, the adaptation level is calculated as a logarithmic average of luminance in the input image.
  • --verbose β€” print additional information during program execution. she's chatty and we love her for it πŸ’¬
  • --help β€” print list of command line options. classic. iconic. always there for you 🫢

🌈 EXAMPLES 🌈

tone map image, apply gamma correction, and save it in png format:

pfsin memorial.hdr | pfstmo_pattanaik00 -m 650 | pfsgamma -g 2.2 | pfsout memorial.png

look at that pipeline. no cap, that's a whole glow-up in one line. πŸ”₯


πŸ¦‹ SEE ALSO πŸ¦‹

pfsgamma(1) pfsin(1) pfsout(1) pfsview(1)


πŸ’€ BUGS πŸ’€

please report bugs and comments on implementation to Grzegorz Krawczyk <krawczyk@mpi-sb.mpg.de>. be nice, be specific, include the details. periodt. πŸ™ˆ


that's the whole page, bestie πŸ’– this was pfstmo_pattanaik00(1) from the General Commands Manual β€” go forth, tone map responsibly, and remember to gamma correct. mwah πŸ’…βœ¨