test/graw: add vp-test
[mesa.git] / docs / RELNOTES-4.1
index 78870e67f88fbcf54d033d6d91b005c12abc74ba..24e9299eb2a234a7c95d26b5ae0b418388cfd7ea 100644 (file)
@@ -1,9 +1,9 @@
 
                             Mesa 4.1 release notes
 
-                            <month>, <day>, 2002
+                               October 29, 2002
 
-                               PLEASE READ!!!!
+                                PLEASE READ!!!!
 
 
 
@@ -65,7 +65,7 @@ GL_NV_point_sprite
 
     For rendering points as textured quads.  Useful for particle effects.
 
-GL_NV_texture_rectangle
+GL_NV_texture_rectangle  (new in 4.0.4 actually)
 
     Allows one to use textures with sizes that are not powers of two.
     Note that mipmapping and several texture wrap modes are not allowed.
@@ -74,6 +74,19 @@ GL_EXT_multi_draw_arrays
 
     Allows arrays of vertex arrays to be rendered with one call.
 
+GL_EXT_stencil_two_side
+
+   Separate stencil modes for front and back-facing polygons.
+
+GLX_SGIX_fbconfig & GLX_SGIX_pbuffer
+
+   Off-screen rendering support.
+
+GL_ATI_texture_mirror_once
+
+   Adds two new texture wrap modes: GL_MIRROR_CLAMP_ATI and
+   GL_MIRROR_CLAMP_TO_EDGE_ATI.
+
 
 
 Device Driver Status
@@ -101,17 +114,43 @@ DOS                       needs updating
 
 
 
-XXX Things To Do Yet XXXX
--------------------------
+New features in GLUT
+--------------------
 
-Verify x86 code for normal transformation works with new 4-element normal
-vector arrays.  Pretty sure the SSE code is wrong.
+1. Frames per second printing
 
-Allow multiple points to be rendered into one sw_span.
+   GLUT now looks for an environment variable called "GLUT_FPS".  If it's
+   set, GLUT will print out a frames/second statistic to stderr when
+   glutSwapBuffers() is called.  By default, frames/second is computed
+   and displayed once every 5 seconds.  You can specify a different
+   interval (in milliseconds) when you set the env var.  For example
+   'export GLUT_FPS=1000' or 'setenv GLUT_FPS 1000' will set the interval
+   to one second.
 
-improve point/line rendering speed.
+   NOTE: the demo or application must call the glutInit() function for
+   this to work.  Otherwise, the env var will be ignored.
 
-glVertexAttrib*NV(index>15) should cause an error.
+   Finally, this feature may not be reliable in multi-window programs.
+
+
+2. glutGetProcAddress() function
+
+   The new function:
+
+        void *glutGetProcAddress(const char *procName)
+
+   is a wrapper for glXGetProcAddressARB() and wglGetProcAddress().  It
+   lets you dynamically get the address of an OpenGL function at runtime.
+   The GLUT_API_VERSION has been bumped to 5, but I haven't bumped the
+   GLUT version number from 3.7 since that's probably Mark Kilgard's role.
+
+   This function should probably also be able to return the address of
+   GLUT functions themselves, but it doesn't do that yet.
+
+
+
+XXX Things To Do Yet XXXX
+-------------------------
 
 isosurf with vertex program exhibits some missing triangles (probably
 when recycling the vertex buffer for long prims).
@@ -185,24 +224,32 @@ are some things to change:
 
    Here are the changes:
 
-   - Rename ctx->Color.DrawDestMask to ctx->Color._DrawDestMask
-   - Rename ctx->Color.DriverDrawBuffer to ctx->Color._DriverDrawBuffer
-   - Rename ctx->Pixel.DriverReadBuffer to ctx->Pixel._DriverReadBuffer
+   - Renamed ctx->Color.DrawDestMask to ctx->Color._DrawDestMask
+   - Removed ctx->Color.DriverDrawBuffer
+   - Removed ctx->Pixel.DriverReadBuffer
    - Removed ctx->Color.MultiDrawBuffer
-   - Removed ctx->Driver.SetDrawBuffer
-   - Added ctx->Driver.DrawBuffer and ctx->Driver.ReadBuffer.  These functions
-     exactly correspond to glDrawBuffer and glReadBuffer calls.
+   - Removed ctx->Driver.SetDrawBuffer()
+   - Removed swrast->Driver.SetReadBuffer().
+   - Added ctx->Color._DrawDestMask - a bitmask of FRONT/BACK_LEFT/RIGHT_BIT
+     values to indicate the current draw buffers.
+   - Added ctx->Pixel._ReadSrcMask to indicate the source for pixel reading.
+     The value is _one_ of the FRONT/BACK_LEFT/RIGHT_BIT values.
+   - Added ctx->Driver.DrawBuffer() and ctx->Driver.ReadBuffer().
+     These functions exactly correspond to glDrawBuffer and glReadBuffer calls.
      Many drivers will set ctx->Driver.DrawBuffer = _swrast_DrawBuffer and
      leave ctx->Draw.ReadBuffer NULL.
      DRI drivers should implement their own function for ctx->Driver.DrawBuffer
      and use it to set the current hardware drawing buffer.  You'll probably
      also want to check for GL_FRONT_AND_BACK mode and fall back to software.
      Call _swrast_DrawBuffer() too, to update the swrast state.
-   - Removed swrast->Driver.SetReadBuffer
-   - Added swrast->Driver.SetBuffer.  This function should be implemented by
-     _all_ device drivers.  Mesa will call it to specify the buffer to use
-     for span reading AND writing and point/line/triangle rendering.  There
-     should be no confusion between current read or draw buffer anymore.
+   - Added swrast->Driver.SetBuffer().
+     This function should be implemented by all device drivers that use swrast.
+     Mesa will call it to specify the buffer to use for span reading AND
+     writing and point/line/triangle rendering.
+     There should be no confusion between current read or draw buffer anymore.
+   - Added swrast->CurrentBuffer to indicate which color buffer to read/draw.
+     Will be FRONT_LEFT_BIT, BACK_LEFT_BIT, FRONT_RIGHT_BIT or BACK_RIGHT_BIT.
+     This value is usually passed to swrast->Driver.SetBuffer().
 
 
 4. _mesa_create_context() changes.  This function now takes a pointer to
@@ -213,6 +260,48 @@ are some things to change:
    should use this.
 
 
+5. In tnl's struct vertex_buffer, the field "ProjectedClipCoords"
+   has been replaced by "NdcPtr" to better match the OpenGL spec's
+   terminology.
+
+
+6. Since GL_EXT_stencil_two_side has been implemented, many of the
+   ctx->Stencil fields are now 2-element arrays.  For example,
+   "GLenum Ref" is now "GLenum Ref[2]"  The [0] elements are the front-face
+   values and the [1] elements are the back-face values.
+   ctx->Stencil.ActiveFace is 0 or 1 to indicate the current face for
+   the glStencilOp/Func/Mask() functions.
+   ctx->Stencil.TestTwoSide controls whether or not 1 or 2-sided stenciling
+   is enabled.
+
+
+7. Removed ctx->Polygon._OffsetAny.  Removed ctx->Polygon.OffsetMRD.
+
+
+8. GLfloat / GLchan changes:
+
+   - Changed ctx->Driver.ClearColor() to take GLfloat[4] instead of GLchan[4].
+     ctx->Color.ClearColor is now GLfloat[4] too.
+   - Changed ctx->Driver.AlphaRef() to take GLfloat instead of GLchan.
+   - ctx->Color.AlphaRef is now GLfloat.
+   - texObj->BorderColor is now GLfloat[4].  texObj->_BorderChan is GLchan[4].
+
+   This is part of an effort to remove all GLchan types from core Mesa so
+   that someday we can support 8, 16 and 32-bit color channels dynamically
+   at runtime, instead of at compile-time.
+
+
+9. GLboolean ctx->Tranform.ClipEnabled[MAX_CLIP_PLANES] has been replaced
+   by GLuint ctx->Transform.ClipPlanesEnabled.  The later is a bitfield.
+
+
+10. There's a new matrix_stack type in mtypes.h used for the Modelview,
+   Projection, Color and Texcoord matrix stacks.
+
+
+11. The ctx->Current.* fields have changed a lot.  Now, there's a
+   ctx->Current.Attrib[] array for all vertex attributes which matches
+   the NV vertex program conventions.
+
 
 ----------------------------------------------------------------------
-$Id: RELNOTES-4.1,v 1.14 2002/08/01 15:16:46 brianp Exp $