Convert libGL and DRI drivers to require libdrm.
[mesa-demos.git] / docs / RELNOTES-3.1
blob4d6e3c2f44b75b23e661949c3e64ffe7a412fc80
2                          Mesa 3.1 release notes
4                              PLEASE READ!!!!
7 New copyright
8 -------------
10 Mesa 3.1 will be distributed under an XFree86-style copyright instead
11 of the GNU LGPL.
14 New directories
15 ---------------
17 All documentation files are now in the docs/ directory.
18 All shell scripts are now in the bin/ directory.
21 New library names
22 -----------------
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).
27 Now, the main library is named libGL.so (or libGL.a) and the GLU library
28 is named libGLU.so (or libGLU.a).
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.
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.
42 New library versioning
43 ----------------------
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
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.
56 New makefiles
57 -------------
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.
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
68 New extensions
69 --------------
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.
76 GL_INGR_blend_func_separate
77         Allows specification of blend factors for RGB and Alpha independently.
78         (INGR = Intergraph)
80 GL_ARB_multitexture
81         Multiple simultaneous textures.  (ARB = Architecture Review Board)
83 GL_NV_texgen_reflection
84         nVidia texgen extension for better reflection mapping.
86 GL_PGI_misc_hints
87         Assorted transformation hints.
89 GL_EXT_compiled_vertex_array
90         Compiled vertex arrays.
92 GL_EXT_clip_volume_hint
93         Allows one to disable clip volume (frustum) testing.
97 Extensions removed
98 ------------------
100 GL_EXT_multitexture - obsolete in favor of GL_ARB_multitexture
104 Config file
105 -----------
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.
113 Optimizations
114 -------------
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.
120 It's impossible to give a speedup factor.  You'll just have to
121 try your app and see how it performs.
125 Device Driver changes
126 ---------------------
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.
135 Miscellaneous
136 -------------
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?
145 ----------------------------------------------------------------------
146 $Id: RELNOTES-3.1,v 1.2 2000/04/07 17:08:06 brianp Exp $