summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorAdam Jackson <ajax@redhat.com>2021-12-08 10:12:11 -0500
committerAdam Jackson <ajax@redhat.com>2021-12-09 15:08:17 -0500
commit231ccb6100e3559782834d1c290e6439a37a7ca8 (patch)
treec3639de7af14c872e9b5d9107cb8e64e2badaf34 /docs
parentc5d731ac5cc0e2a85544ff7a73142dcb80768335 (diff)
downloadmesa-231ccb6100e3559782834d1c290e6439a37a7ca8.tar.gz
mesa-231ccb6100e3559782834d1c290e6439a37a7ca8.tar.bz2
mesa-231ccb6100e3559782834d1c290e6439a37a7ca8.zip
docs: Remove no-longer-accurate text about the xlib driver
Mesa hasn't supported color-index rendering in a long time, and gallium's xlib target doesn't respect MESA_GAMMA. Reviewed-by: Emma Anholt <emma@anholt.net> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/14125>
Diffstat (limited to 'docs')
-rw-r--r--docs/envvars.rst4
-rw-r--r--docs/xlibdriver.rst47
2 files changed, 4 insertions, 47 deletions
diff --git a/docs/envvars.rst b/docs/envvars.rst
index f397c41dcd7..5afdc519f22 100644
--- a/docs/envvars.rst
+++ b/docs/envvars.rst
@@ -224,12 +224,8 @@ the :doc:`Xlib software driver page <xlibdriver>` for details.
:envvar:`MESA_BACK_BUFFER`
specifies how to implement the back color buffer, either ``pixmap``
or ``ximage``
-:envvar:`MESA_GAMMA`
- gamma correction coefficients for red, green, blue channels
:envvar:`MESA_XSYNC`
enable synchronous X behavior (for debugging only)
-:envvar:`MESA_GLX_FORCE_CI`
- if set, force GLX to treat 8 BPP visuals as CI visuals
:envvar:`MESA_GLX_FORCE_ALPHA`
if set, forces RGB windows to have an alpha channel.
:envvar:`MESA_GLX_DEPTH_BITS`
diff --git a/docs/xlibdriver.rst b/docs/xlibdriver.rst
index 11e89ae6b0e..8a7a58bc5f5 100644
--- a/docs/xlibdriver.rst
+++ b/docs/xlibdriver.rst
@@ -18,7 +18,8 @@ The unique features of the Xlib driver follows.
X Visual Selection
------------------
-Mesa supports RGB(A) rendering into almost any X visual type and depth.
+Mesa supports RGB(A) rendering into TrueColor and DirectColor visuals, for
+any depth with a corresponding renderable OpenGL texture format.
The glXChooseVisual function tries to choose the best X visual for the
given attribute list. However, if this doesn't suit your needs you can
@@ -36,11 +37,11 @@ Here are some examples:
using csh:
% setenv MESA_RGB_VISUAL "TrueColor 8" // 8-bit TrueColor
- % setenv MESA_RGB_VISUAL "PseudoColor 8" // 8-bit PseudoColor
+ % setenv MESA_RGB_VISUAL "DirectColor 30" // 30-bit DirectColor
using bash:
$ export MESA_RGB_VISUAL="TrueColor 8"
- $ export MESA_RGB_VISUAL="PseudoColor 8"
+ $ export MESA_RGB_VISUAL="DirectColor 30"
Double Buffering
----------------
@@ -77,46 +78,6 @@ When sharing the root colormap, Mesa may be unable to allocate the
colors it needs, resulting in poor color quality. This can happen when a
large number of colorcells in the root colormap are already allocated.
-Gamma Correction
-----------------
-
-To compensate for the nonlinear relationship between pixel values and
-displayed intensities, there is a gamma correction feature in Mesa. Some
-systems, such as Silicon Graphics, support gamma correction in hardware
-(man gamma) so you won't need to use Mesa's gamma facility. Other
-systems, however, may need gamma adjustment to produce images which look
-correct. If you believe that Mesa's images are too dim, read on.
-
-Gamma correction is controlled with the **MESA_GAMMA** environment
-variable. Its value is of the form **Gr Gg Gb** or just **G** where Gr
-is the red gamma value, Gg is the green gamma value, Gb is the blue
-gamma value and G is one gamma value to use for all three channels. Each
-value is a positive real number typically in the range 1.0 to 2.5. The
-defaults are all 1.0, effectively disabling gamma correction. Examples:
-
-.. code-block:: console
-
- % export MESA_GAMMA="2.3 2.2 2.4" # separate R,G,B values
- % export MESA_GAMMA="2.0" # same gamma for R,G,B
-
-The ``demos/gamma.c`` program in mesa/demos repository may help you to
-determine reasonable gamma value for your display. With correct gamma
-values, the color intensities displayed in the top row (drawn by
-dithering) should nearly match those in the bottom row (drawn as grays).
-
-Alex De Bruyn reports that gamma values of 1.6, 1.6 and 1.9 work well on
-HP displays using the HP-ColorRecovery technology.
-
-Mesa implements gamma correction with a lookup table which translates a
-"linear" pixel value to a gamma-corrected pixel value. There is a small
-performance penalty. Gamma correction only works in RGB mode. Also be
-aware that pixel values read back from the frame buffer will not be
-"un-corrected" so glReadPixels may not return the same data drawn with
-glDrawPixels.
-
-For more information about gamma correction, see the `Wikipedia
-article <https://en.wikipedia.org/wiki/Gamma_correction>`__
-
Overlay Planes
--------------