eglmesaext: add forward declaration for struct wl_buffers
[mesa.git] / docs / xlibdriver.html
index 8ae668843f14f9293a11b32c5b6da4bf6a992631..b4de10e36f12ab86b073dc8fabe19a816c3d2e8d 100644 (file)
@@ -7,6 +7,13 @@
 </head>
 <body>
 
+<div class="header">
+  <h1>The Mesa 3D Graphics Library</h1>
+</div>
+
+<iframe src="contents.html"></iframe>
+<div class="content">
+
 <h1>Xlib Software Driver</h1>
 
 <p>
@@ -32,7 +39,7 @@ The unique features of the Xlib driver follows.
 </p>
 
 
-<H2>X Visual Selection</H2>
+<h2>X Visual Selection</h2>
 <p>
 Mesa supports RGB(A) rendering into almost any X visual type and depth.
 </p>
@@ -69,7 +76,7 @@ Here are some examples:
 </pre>
 
 
-<H2>Double Buffering</H2>
+<h2>Double Buffering</h2>
 <p>
 Mesa can use either an X Pixmap or XImage as the back color buffer when in
 double-buffer mode.
@@ -96,11 +103,11 @@ for your application.
 </p>
 
 
-<H2>Colormaps</H2>
+<h2>Colormaps</h2>
 <p>
 When using Mesa directly or with GLX, it's up to the application
 writer to create a window with an appropriate colormap.  The GLUT
-toolkit tris to minimize colormap <em>flashing</em> by sharing
+toolkit tries to minimize colormap <em>flashing</em> by sharing
 colormaps when possible.  Specifically, if the visual and depth of the
 window matches that of the root window, the root window's colormap
 will be shared by the Mesa window.  Otherwise, a new, private colormap
@@ -117,7 +124,7 @@ significant.
 </p>
 
 
-<H2>Gamma Correction</H2>
+<h2>Gamma Correction</h2>
 <p>
 To compensate for the nonlinear relationship between pixel values
 and displayed intensities, there is a gamma correction feature in
@@ -143,10 +150,10 @@ Examples:
        % export MESA_GAMMA="2.0"               // same gamma for R,G,B
 </pre>
 <p>
-The progs/demos/gamma.c program 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).
+The <code>demos/gamma.c</code> 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).
 </p>
 
 <p>
@@ -164,13 +171,12 @@ drawn with glDrawPixels.
 </p>
 
 <p>
-For more information about gamma correction see:
-<a href="http://www.inforamp.net/~poynton/notes/colour_and_gamma/GammaFAQ.html">
-the Gamma FAQ</a>
+For more information about gamma correction, see the
+<a href="https://en.wikipedia.org/wiki/Gamma_correction">Wikipedia article</a>
 </p>
 
 
-<H2>Overlay Planes</H2>
+<h2>Overlay Planes</h2>
 <p>
 Hardware overlay planes are supported by the Xlib driver.  To
 determine if your X server has overlay support you can test for the
@@ -181,7 +187,7 @@ SERVER_OVERLAY_VISUALS property:
 </pre>
 
 
-<H2>HPCR Dithering</H2>
+<h2>HPCR Dithering</h2>
 <p>
 If you set the <b>MESA_HPCR_CLEAR</b> environment variable then dithering
 will be used when clearing the color buffer.  This is only applicable
@@ -190,9 +196,9 @@ This incurs a small performance penalty.
 </p>
 
 
-<H2>Extensions</H2>
+<h2>Extensions</h2>
 <p>
-The following MESA-specific extensions are implemented in the Xlib driver.
+The following Mesa-specific extensions are implemented in the Xlib driver.
 </p>
 
 <h3>GLX_MESA_pixmap_colormap</h3>
@@ -214,7 +220,7 @@ See the xdemos/glxpixmap.c file for an example of how to use this
 extension.
 </p>
 <p>
-<a href="MESA_pixmap_colormap.spec">GLX_MESA_pixmap_colormap specification</a>
+<a href="specs/MESA_pixmap_colormap.spec">GLX_MESA_pixmap_colormap specification</a>
 </p>
 
 
@@ -243,26 +249,26 @@ just before an X window is destroyed.  For example:
          XDestroyWindow( dpy, window );
 </pre>
 <p>
-<a href="MESA_release_buffers.spec">GLX_MESA_release_buffers specification</a>
+<a href="specs/MESA_release_buffers.spec">GLX_MESA_release_buffers specification</a>
 </p>
 <p>
 This extension was added in Mesa 2.0.
 </p>
 
-<H3>GLX_MESA_copy_sub_buffer</H3>
+<h3>GLX_MESA_copy_sub_buffer</h3>
 <p>
 This extension adds the glXCopySubBufferMESA() function.  It works
 like glXSwapBuffers() but only copies a sub-region of the window
 instead of the whole window.
 </p>
 <p>
-<a href="MESA_copy_sub_buffer.spec">GLX_MESA_copy_sub_buffer specification</a>
+<a href="specs/MESA_copy_sub_buffer.spec">GLX_MESA_copy_sub_buffer specification</a>
 </p>
 <p>
 This extension was added in Mesa 2.6
 </p>
 
-<h2>Summary of X-related environment variables</H2>
+<h2>Summary of X-related environment variables</h2>
 <pre>
    MESA_RGB_VISUAL - specifies the X visual and depth for RGB mode (X only)
    MESA_CI_VISUAL - specifies the X visual and depth for CI mode (X only)
@@ -271,6 +277,6 @@ This extension was added in Mesa 2.6
    MESA_GAMMA - gamma correction coefficients (X only)
 </pre>
 
-
+</div>
 </body>
 </html>