mesa: disable glsl debug output
[mesa.git] / docs / RELNOTES-3.5
index f986560da089be3784e140c7d921fc4604b589b4..b2aa1b852ead2331cae680f521e2aaa0d65608cd 100644 (file)
@@ -1,7 +1,7 @@
 
                          Mesa 3.5 release notes
 
-                             Month ??, 2001
+                             June 21, 2001
 
                              PLEASE READ!!!!
 
@@ -11,14 +11,40 @@ Introduction
 ------------
 
 Mesa uses an even/odd version number scheme like the Linux kernel.
-Odd numbered versions (such as 3.3) designate new developmental releases.
+Odd numbered versions (such as 3.5) designate new developmental releases.
 Even numbered versions (such as 3.4) designate stable releases.
 
-The internal structure of Mesa 3.5 is (will be) changed so that it
-is more modular.  The motivation is better support of 3D hardware
-such as T&L hardware in which much of core Mesa isn't needed.
+The biggest change in Mesa 3.5 is a complete overhaul of the source
+code in order to make it more modular.  This was driven by the DRI
+hardware drivers.  It simplifies the DRI drivers and opens the door
+to hardware transform/clip/lighting (TCL).  Keith Whitwell can take
+the credit for that.
+
+
+
+Driver Support
+--------------
+
+The device driver interface in Mesa 3.5 has changed a lot since Mesa 3.4
+Not all of the older Mesa drivers have been updated.  Here's the status:
+
+Driver                 Status
+---------------------- -----------
+XMesa (Xlib)           updated
+OSMesa (off-screen)    updated
+FX (3dfx Voodoo1/2)    updated
+SVGA                   updated
+GGI                    not updated
+Windows/Win32          not updated
+DOS/DJGPP              not updated
+BeOS                   not updated
+Allegro                        not updated
+D3D                    not updated
+DOS                    not updated
+
+We're looking for volunteers to update the remaining drivers.  Please
+post to the Mesa3d-dev mailing list if you can help.
 
-Details to come...
 
 
 GLU 1.3
@@ -84,6 +110,10 @@ GL_ARB_texture_border_clamp
 GL_SGIX_depth_texture, GL_SGIX_shadow and GL_SGIX_shadow_ambient
        Implements a shadow casting algorithm based on depth map textures
 
+GL_SGIS_generate_mipmap
+       Automatically generate lower mipmap images whenever the base mipmap
+       image is changed with glTexImage, glCopyTexImage, etc.
+
 
 
 libOSMesa.so
@@ -144,23 +174,19 @@ All the drivers have been updated, but not all of them have been
 tested since I can't test some platforms (DOS, Windows, Allegro, etc).
 
 
-Multitexture
-------------
+X/Mesa Driver
+-------------
 
-Three texture units are now supported by default.  We'll allow more
-than three texture units when we fix some bitfield issues.  In at least
-one place we have a 32-bit bitfield which is fully allocated, leaving
-no space for texture unit #3 or higher.
+The source files for the X/Mesa driver in src/X have been renamed.
+The xmesa[1234].c files are gone.  The new files are xm_api.c,
+xm_dd.c, xm_line.c, xm_span.c and xm_tri.c.
 
-The TEXTURE1_1D, TEXTURE1_2D, etc constants may go away in the future.
-Currently, they're only used in the ctx->Texture.ReallyEnabled field.
-This bitfield is just a conglomerate of ctx->Texture.Unit[i].ReallyEnabled
-for all <i> texture units.  ctx->Texture.ReallyEnabled may become a
-GLboolean.  Then, drivers will have to loop over the texture units to
-examine ctx->Texture.Unit[i].ReallyEnabled.
 
 
+Multitexture
+------------
 
+Eight texture units are now supported by default.
 
 
 
@@ -182,5 +208,20 @@ interface structures like __GLimports and __GLexports.
 5. New file: imports.c to setup default import functions for Mesa.
 
 
+
+
+16-bit color channels
+---------------------
+
+There's experimental support for 16-bit color channels (64-bit pixels)
+in Mesa 3.5.  Only the OSMesa interface can be used for 16-bit rendering.
+Type "make linux-osmesa16" in the top-level directory to build the
+special libOSMesa16.so library.
+
+This hasn't been tested very thoroughly yet so please file bug reports
+if you have trouble.
+
+In the future I hope to implement support for 32-bit, floating point
+color channels.
+
 ----------------------------------------------------------------------
-$Id: RELNOTES-3.5,v 1.10 2001/03/26 19:45:08 brianp Exp $