summaryrefslogtreecommitdiff
path: root/docs/postprocess.rst
blob: 276f3863756383e733c3d5cdf5a67f9280e5027b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
Gallium Post-processing
=======================

The Gallium drivers support user-defined image post-processing. At the
end of drawing a frame a post-processing filter can be applied to the
rendered image. Example filters include morphological antialiasing and
cell shading.

The filters can be toggled per-app via driconf, or per-session via the
corresponding environment variables.

Multiple filters can be used together.

PP environment variables
------------------------

-  PP_DEBUG - If defined debug information will be printed to stderr.

Current filters
---------------

-  pp_nored, pp_nogreen, pp_noblue - set to 1 to remove the
   corresponding color channel. These are basic filters for easy testing
   of the PP queue.
-  pp_jimenezmlaa, pp_jimenezmlaa_color - `Jimenez's
   MLAA <https://www.iryokufx.com/mlaa/>`__ is a morphological
   antialiasing filter. The two versions use depth and color data,
   respectively. Which works better depends on the app - depth will not
   blur text, but it will miss transparent textures for example. Set to
   a number from 2 to 32, roughly corresponding to quality. Numbers
   higher than 8 see minimizing gains.
-  pp_celshade - set to 1 to enable cell shading (a more complex color
   filter).