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