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