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