| 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.iryoku.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).
|
|---|
