docs/RELNOTES-3.1

   1
   2                          Mesa 3.1 release notes
   3
   4                              PLEASE READ!!!!
   5
   6
   7 New copyright
   8 -------------
   9
  10 Mesa 3.1 will be distributed under an XFree86-style copyright instead
  11 of the GNU LGPL.
  12
  13
  14 New directories
  15 ---------------
  16
  17 All documentation files are now in the docs/ directory.
  18 All shell scripts are now in the bin/ directory.
  19
  20
  21 New library names
  22 -----------------
  23
  24 Formerly, the main Mesa library was named libMesaGL.so (or libMesaGL.a)
  25 and the GLU library was named libMesaGLU.so (or libMesaGLU.a).
  26
  27 Now, the main library is named libGL.so (or libGL.a) and the GLU library
  28 is named libGLU.so (or libGLU.a).
  29
  30 The change allows Mesa to be more easily substituted for OpenGL.
  31 Specifically, the linker/loader on some Unix-like systems won't
  32 allow libMesaGL.so to be used instead of libGL.so if the application
  33 was linked with the former.
  34
  35 Warning: if you have another OpenGL implementation installed on your
  36 system (i.e. you have another OpenGL libGL.so) you'll have to be
  37 carefull about which library (OpenGL or Mesa) you link against.  Be
  38 aware of -L linker flags and the value of the LD_LIBRARY_PATH environment
  39 variable.
  40
  41
  42 New library versioning
  43 ----------------------
  44
  45 Previously, the Mesa GL library was named libMesaGL.so.3.0
  46 To better support Linux/OpenGL standards, the Mesa GL library is now
  47 named libGL.so.1.2.030100  This indicates version 1.2 of the OpenGL spec
  48 and Mesa implementation 3.1.0
  49
  50 In the long term this will allow better interoperability with other
  51 OpenGL implementations, especially on Linux.  In the short term,
  52 OpenGL apps may have to be relinked to use the new library naming.
  53
  54
  55
  56 New makefiles
  57 -------------
  58
  59 The old Makefiles found in the various directories have been renamed
  60 to Makefile.X11 in order to prevent filename collisions with autoconfig-
  61 generated Makefiles.
  62
  63 The top-level Makefile simply includes Makefile.X11
  64 If your top-level Makefile get's overwritten/destroyed you can restore
  65 it by copying Makefile.X11 to Makefile
  66
  67
  68 New extensions
  69 --------------
  70
  71 GL_EXT_stencil_wrap
  72         Implements two new stencil operations: GL_INCR_WRAP_EXT and
  73         GL_DECR_WRAP_EXT which allow stencil increment and decrement
  74         without clamping.
  75
  76 GL_INGR_blend_func_separate
  77         Allows specification of blend factors for RGB and Alpha independently.
  78         (INGR = Intergraph)
  79
  80 GL_ARB_multitexture
  81         Multiple simultaneous textures.  (ARB = Architecture Review Board)
  82
  83 GL_NV_texgen_reflection
  84         nVidia texgen extension for better reflection mapping.
  85
  86 GL_PGI_misc_hints
  87         Assorted transformation hints.
  88
  89 GL_EXT_compiled_vertex_array
  90         Compiled vertex arrays.
  91
  92 GL_EXT_clip_volume_hint
  93         Allows one to disable clip volume (frustum) testing.
  94
  95
  96
  97 Extensions removed
  98 ------------------
  99
 100 GL_EXT_multitexture - obsolete in favor of GL_ARB_multitexture
 101
 102
 103
 104 Config file
 105 -----------
 106
 107 By default, /etc/mesa.conf will be read when Mesa starts.  This
 108 file controls default hints, enable/disable of extensions, and
 109 more.  See the CONFIG file for documentation.
 110
 111
 112
 113 Optimizations
 114 -------------
 115
 116 Keith Whitwell has contributed significant optimizations to Mesa's
 117 vertex transformation code.  Basically, the whole transformation
 118 stage of Mesa has been rewritten.
 119
 120 It's impossible to give a speedup factor.  You'll just have to
 121 try your app and see how it performs.
 122
 123
 124
 125 Device Driver changes
 126 ---------------------
 127
 128 A bunch of new device driver functions have been added.  See src/dd.h
 129 Keith Harrison contributed many of them.  I've been planning on adding
 130 a bunch of functions like these to make writing hardware drivers easier.
 131 More such function will probably be added in the near future.
 132
 133
 134
 135 Miscellaneous
 136 -------------
 137
 138 util/glstate.c has some handy functions for debugging.  Basically, it
 139 offers a simple function for printing GL state variables.  It's not
 140 finished yet.  There's a LOT more GLenum records to be added (see the
 141 code).  Anyone want to help?
 142
 143
 144
 145 ----------------------------------------------------------------------