workbench/libs/mesa/docs/RELNOTES-4.0

   1
   2                            Mesa 4.0 release notes
   3
   4                              October 18, 2001
   5
   6                               PLEASE READ!!!!
   7
   8
   9
  10 Introduction
  11 ------------
  12
  13 Mesa uses an even/odd version number scheme like the Linux kernel.
  14 Odd numbered versions (such as 3.3) designate new developmental releases.
  15 Even numbered versions (such as 3.4) designate stable releases.
  16
  17 Mesa version 4.0 signifies two things:
  18
  19   1. A stabilization of the 3.5 development release
  20   2. Implementation of the OpenGL 1.3 specification
  21
  22
  23 Note that the Mesa major version number is incremented with the OpenGL
  24 minor version number:
  25
  26    Mesa 1.x  ==  OpenGL 1.0
  27    Mesa 2.x  ==  OpenGL 1.1
  28    Mesa 3.x  ==  OpenGL 1.2
  29    Mesa 4.x  ==  OpenGL 1.3
  30
  31
  32
  33 New Features
  34 ------------
  35
  36 Mesa 3.5 already had all the new features of OpenGL 1.3, implemented as
  37 extensions.  These extensions were simply promoted to standard features:
  38
  39    GL_ARB_multisample
  40    GL_ARB_multitexture
  41    GL_ARB_texture_border_clamp
  42    GL_ARB_texture_compression
  43    GL_ARB_texture_cube_map
  44    GL_ARB_texture_env_add
  45    GL_ARB_texture_env_combine
  46    GL_ARB_texture_env_dot3
  47    GL_ARB_transpose_matrix
  48
  49 In Mesa 4.0 the functions defined by these extensions are now available
  50 without the "ARB" suffix.  For example, glLoadTransposeMatrixf() is now
  51 a standard API function.  The new functions in OpenGL 1.3 and Mesa 4.0 are:
  52
  53    glActiveTexture
  54    glClientActiveTexture
  55    glCompressedTexImage1D
  56    glCompressedTexImage2D
  57    glCompressedTexImage3D
  58    glCompressedTexSubImage1D
  59    glCompressedTexSubImage2D
  60    glCompressedTexSubImage3D
  61    glGetCompressedTexImage
  62    glLoadTransposeMatrixd
  63    glLoadTransposeMatrixf
  64    glMultiTexCoord1d
  65    glMultiTexCoord1dv
  66    glMultiTexCoord1f
  67    glMultiTexCoord1fv
  68    glMultiTexCoord1i
  69    glMultiTexCoord1iv
  70    glMultiTexCoord1s
  71    glMultiTexCoord1sv
  72    glMultiTexCoord2d
  73    glMultiTexCoord2dv
  74    glMultiTexCoord2f
  75    glMultiTexCoord2fv
  76    glMultiTexCoord2i
  77    glMultiTexCoord2iv
  78    glMultiTexCoord2s
  79    glMultiTexCoord2sv
  80    glMultiTexCoord3d
  81    glMultiTexCoord3dv
  82    glMultiTexCoord3f
  83    glMultiTexCoord3fv
  84    glMultiTexCoord3i
  85    glMultiTexCoord3iv
  86    glMultiTexCoord3s
  87    glMultiTexCoord3sv
  88    glMultiTexCoord4d
  89    glMultiTexCoord4dv
  90    glMultiTexCoord4f
  91    glMultiTexCoord4fv
  92    glMultiTexCoord4i
  93    glMultiTexCoord4iv
  94    glMultiTexCoord4s
  95    glMultiTexCoord4sv
  96    glMultTransposeMatrixd
  97    glMultTransposeMatrixf
  98    glSampleCoverage
  99    glSamplePass
 100
 101
 102 GLX 1.4 is the companion to OpenGL 1.3.  The only new features in GLX 1.4
 103 are support for multisampling and the GLX_ARB_get_proc_address extension.
 104 glXGetProcAddress() is the only new function in GLX 1.4.
 105
 106
 107
 108 Multisample and Texture Compression
 109 -----------------------------------
 110
 111 The OpenGL 1.3 specification allows the multisample and texture compression
 112 features to essentially be no-ops.  For example, if you query for multisample
 113 support you'll find none, but the API functions work.
 114
 115 Similarly, texture compression is not implemented by any of the software
 116 drivers but you can specify a generic compressed texture format (like
 117 GL_COMPRESSED_RGBA) to glTexImage2D and it'll be accepted.
 118
 119
 120
 121 Device Drivers
 122 --------------
 123
 124 Mesa advertises itself as either OpenGL 1.2 or OpenGL 1.3 depending on the
 125 device driver.  If the driver enables all the ARB extensions which are part
 126 of OpenGL 1.3 then glGetString(GL_VERSION) will return "1.3".  Otherwise,
 127 it'll return "1.2".
 128
 129 A number of Mesa's software drivers haven't been actively maintained for
 130 some time.  We rely on volunteers to maintain many of the drivers.
 131 Here's the current status of all included drivers:
 132
 133
 134 Driver                  Status
 135 ----------------------  ---------------------
 136 XMesa (Xlib)            implements OpenGL 1.3
 137 OSMesa (off-screen)     implements OpenGL 1.3
 138 FX (3dfx Voodoo1/2)     implements OpenGL 1.3
 139 SVGA                    implements OpenGL 1.3
 140 Wind River UGL          implements OpenGL 1.3
 141 Windows/Win32           implements OpenGL 1.3
 142 GGI                     needs updating
 143 DOS/DJGPP               needs updating
 144 BeOS                    needs updating
 145 Allegro                 needs updating
 146 D3D                     needs updating
 147 DOS                     needs updating
 148
 149 Special thanks go to Karl Schultz for updating the Windows driver.
 150
 151 The XFree86/DRI drivers have not yet been updated to use Mesa 4.0 as of
 152 September 2001, but that should happen eventually.
 153
 154
 155
 156 Other Changes
 157 -------------
 158
 159 See the VERSIONS file for more details about bug fixes, etc. in Mesa 4.0.
 160
 161
 162 ----------------------------------------------------------------------