docs/postprocess.rst

   1 Gallium Post-processing
   2 =======================
   3
   4 The Gallium drivers support user-defined image post-processing. At the
   5 end of drawing a frame a post-processing filter can be applied to the
   6 rendered image. Example filters include morphological antialiasing and
   7 cell shading.
   8
   9 The filters can be toggled per-app via driconf, or per-session via the
  10 corresponding environment variables.
  11
  12 Multiple filters can be used together.
  13
  14 PP environment variables
  15 ------------------------
  16
  17 -  PP_DEBUG - If defined debug information will be printed to stderr.
  18
  19 Current filters
  20 ---------------
  21
  22 -  pp_nored, pp_nogreen, pp_noblue - set to 1 to remove the
  23    corresponding color channel. These are basic filters for easy testing
  24    of the PP queue.
  25 -  pp_jimenezmlaa, pp_jimenezmlaa_color - `Jimenez's
  26    MLAA <https://www.iryokufx.com/mlaa/>`__ is a morphological
  27    antialiasing filter. The two versions use depth and color data,
  28    respectively. Which works better depends on the app - depth will not
  29    blur text, but it will miss transparent textures for example. Set to
  30    a number from 2 to 32, roughly corresponding to quality. Numbers
  31    higher than 8 see minimizing gains.
  32 -  pp_celshade - set to 1 to enable cell shading (a more complex color
  33    filter).