Merge remote branch 'origin/master' into pipe-video
[mesa.git] / docs / RELNOTES-3.3
index 128ec641d4f817b8af54d6ac871a46bd67b2d0e0..3850767bb1df47207ad63cd9cccdb3ecde805964 100644 (file)
@@ -1,10 +1,28 @@
 
                          Mesa 3.3 release notes
 
+                             July 21, 2000
+
                              PLEASE READ!!!!
 
 
 
+Introduction
+------------
+
+Mesa uses an even/odd version number scheme like the Linux kernel.
+Odd numbered versions (such as 3.3) designate new developmental releases.
+Even numbered versions (such as 3.2.1) designate stable releases.
+
+Mesa 3.3 has a undergone many internal changes since version 3.2
+and features a lot of new extensions.  3.3 is expected to be pretty
+stable, but perhaps not as stable as 3.2 which has been used by
+thousands of users over the past months.
+
+Everyone is encouraged to try Mesa 3.3.  Bugs should be reported to
+the Mesa bug database on www.sourceforge.net.
+
+
 
 Header file / GLenum changes
 ----------------------------
@@ -28,6 +46,11 @@ templatized code defined in glapitemp.h and included by glapi.c
 The glapitemp.h template should be reusable for all sorts of OpenGL
 projects.
 
+The new dispatch code has also optimized with x86 assembly code.
+This optimization eliminates copying the function arguments during
+dispatch.
+
+
 
 New thread support
 ------------------
@@ -38,6 +61,10 @@ which support threads, that is).  There is virtually no performance
 penalty for typical single-thread applications.  See the glapi.c
 file for details.
 
+The Xlib driver (XMesa) is now thread-safe as well.  Be sure to
+call XInitThreads() in your app first.  See the xdemos/glthreads.c
+demo for an example.
+
 
 
 Make configuration changes
@@ -59,9 +86,12 @@ that several of the configuration names have changed:
 New extensions
 --------------
 
-GL_EXT_transpose_matrix
-       Adds glLoadTransposeMatrix() and glMultTransposeMatrix() functions.
-       See http://reality.sgi.com/opengl/arb/extensions/ext_text/GL_EXT_transpose_matrix.txt
+GL_ARB_transpose_matrix
+       Adds glLoadTransposeMatrixARB() and glMultTransposeMatrixARB()
+        functions.
+
+GL_ARB_texture_cube_map
+       For cube-based reflection mapping.
 
 GL_EXT_texture_add_env
        Adds GL_ADD texture environment mode.
@@ -89,6 +119,19 @@ GL_SGI_color_table
 GL_EXT_histogram
        Compute histograms for glDraw/Read/CopyPixels.
 
+GL_EXT_blend_func_separate
+       This is the same as GL_INGR_blend_func_separate.
+
+GL_ARB_texture_cube_mapping
+       6-face cube mapping, nicer than sphere mapping
+
+GL_EXT_texture_env_combine
+       For advanced texture environment effects.
+
+
+Documentation for all these functions can be found at
+http://oss.sgi.com/projects/ogl-sample/registry/
+
 
 
 GLX_SGI_make_current_read functionality
@@ -205,6 +248,23 @@ Also added constants for NumAuxBuffers and SubPixelBits.
 
 
 
+OpenGL Conformance
+------------------
+
+Mesa now passes all the OpenGL 1.1 conformance tests, except for
+antialiased lines.  AA lines fail on some, but not all, the tests.
+In order to fix the remaining failures, a new AA line algorithm will
+be needed (which computes coverage values for end-point fragments).
+This will be done for Mesa 3.5/3.6.
+
+
+
+OpenGL 1.2 GL_ARB_imaging subset
+--------------------------------
+
+Mesa 3.3 implements all the features of GL_ARB_imaging except for
+image convolution.  This will (hopefully) be done for Mesa 3.5/3.6.
+
+
 
 ----------------------------------------------------------------------
-$Id: RELNOTES-3.3,v 1.4 2000/05/04 13:50:33 brianp Exp $