1 2 Mesa 3.5 release notes 3 4 June 21, 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.5) designate new developmental releases. 15 Even numbered versions (such as 3.4) designate stable releases. 16 17 The biggest change in Mesa 3.5 is a complete overhaul of the source 18 code in order to make it more modular. This was driven by the DRI 19 hardware drivers. It simplifies the DRI drivers and opens the door 20 to hardware transform/clip/lighting (TCL). Keith Whitwell can take 21 the credit for that. 22 23 24 25 Driver Support 26 -------------- 27 28 The device driver interface in Mesa 3.5 has changed a lot since Mesa 3.4 29 Not all of the older Mesa drivers have been updated. Here's the status: 30 31 Driver Status 32 ---------------------- ----------- 33 XMesa (Xlib) updated 34 OSMesa (off-screen) updated 35 FX (3dfx Voodoo1/2) updated 36 SVGA updated 37 GGI not updated 38 Windows/Win32 not updated 39 DOS/DJGPP not updated 40 BeOS not updated 41 Allegro not updated 42 D3D not updated 43 DOS not updated 44 45 We're looking for volunteers to update the remaining drivers. Please 46 post to the Mesa3d-dev mailing list if you can help. 47 48 49 50 GLU 1.3 51 ------- 52 53 Mesa 3.5 includes the SGI Sample Implementation (SI) GLU library. 54 This version of GLU supports the GLU 1.3 specification. The old 55 Mesa GLU library implemented the 1.1 specification. The SI GLU 56 library should work much better. 57 58 You'll need a C++ compiler to compile the SI GLU library. This may 59 be a problem on some systems. 60 61 62 63 New Extensions 64 -------------- 65 66 GL_EXT_convolution 67 Adds image convolution to glRead/Copy/DrawPixels/TexImage. 68 69 GL_ARB_imaging 70 This is the optional imaging subset of OpenGL 1.2. 71 It's the GL_EXT_convolution, GL_HP_convolution_border_modes, 72 GL_EXT_histogram, GL_EXT_color_table, GL_EXT_color_subtable 73 GL_EXT_blend_color, GL_EXT_blend_minmax, GL_EXT_blend_subtract 74 and GL_SGI_color_matrix extensions all rolled together. 75 This is supported in all software renderers but not in all 76 hardware drivers (3dfx for example). 77 78 GL_ARB_texture_compression 79 This is supported in Mesa but only used by the 3dfx DRI drivers 80 for Voodoo4 and later. 81 82 GL_ARB_texture_env_add 83 This is identical to GL_EXT_texture_env_add. 84 85 GL_NV_blend_square 86 Adds extra blend source and dest factors which allow squaring 87 of color values. 88 89 GL_EXT_fog_coord 90 Allows specification of a per-vertex fog coordinate instead of 91 having fog always computed from the eye distance. 92 93 GL_EXT_secondary_color 94 Allows specifying the secondary (specular) color for each vertex 95 instead of getting it only from lighting in GL_SEPARATE_SPECULAR_COLOR 96 mode. 97 98 GL_ARB_texture_env_combine 99 Basically the same as GL_EXT_texture_env_combine 100 101 GL_ARB_texture_env_add extension 102 Texture addition mode. 103 104 GL_ARB_texture_env_dot3 extension 105 Dot product texture environment. 106 107 GL_ARB_texture_border_clamp 108 Adds GL_CLAMP_TO_BORDER_ARB texture wrap mode 109 110 GL_SGIX_depth_texture, GL_SGIX_shadow and GL_SGIX_shadow_ambient 111 Implements a shadow casting algorithm based on depth map textures 112 113 GL_SGIS_generate_mipmap 114 Automatically generate lower mipmap images whenever the base mipmap 115 image is changed with glTexImage, glCopyTexImage, etc. 116 117 118 119 libOSMesa.so 120 ------------ 121 122 libOSMesa.so is a new library which contains the OSMesa interface for 123 off-screen rendering. Apps which need the OSMesa interface should link 124 with both -lOSMesa and -lGL. This change was made so that stand-alone 125 Mesa works the same way as XFree86/DRI's libGL. 126 127 128 129 Device Driver Changes / Core Mesa Changes 130 ----------------------------------------- 131 132 The ctx->Driver.LogicOp() function has been removed. It used to 133 be called during state update in order to determine if the driver 134 could do glLogicOp() operations, and if not, set the SWLogicOpEnabled 135 flag. Drivers should instead examine the LogicOp state themselves 136 and choose specialized point, line, and triangle functions appropriately, 137 or fall back to software rendering. The Xlib driver was the only driver 138 to use this function. And since the Xlib driver no longer draws 139 points, lines or triangles using Xlib, the LogicOp function isn't needed. 140 141 The ctx->Driver.Dither() function has been removed. Drivers should 142 detect dither enable/disable via ctx->Driver.Enable() instead. 143 144 The ctx->Driver.IndexMask() and ctx->Driver.ColorMask() functions 145 are now just called from glIndexMask and glColorMask like the other 146 GL state-changing functions. They are no longer called from inside 147 gl_update_state(). Also, they now return void. The change was made 148 mostly for sake of uniformity. 149 150 The NEW_DRVSTATE[0123] flags have been removed. They weren't being used 151 and are obsolete w.r.t. the way state updates are done in DRI drivers. 152 153 154 Removed obsolete gl_create_visual() and gl_destroy_visual(). 155 156 Renamed functions (new namespace): 157 158 old new 159 gl_create_framebuffer _mesa_create_framebuffer 160 gl_destroy_framebuffer _mesa_destroy_framebuffer 161 gl_create_context _mesa_create_context 162 gl_destroy_context _mesa_destroy_context 163 gl_context_initialize _mesa_context_initialize 164 gl_copy_context _mesa_copy_context 165 gl_make_current _mesa_make_current 166 gl_make_current2 _mesa_make_current2 167 gl_get_current_context _mesa_get_current_context 168 gl_flush_vb _mesa_flush_vb 169 gl_warning _mesa_warning 170 gl_compile_error _mesa_compile_error 171 172 173 All the drivers have been updated, but not all of them have been 174 tested since I can't test some platforms (DOS, Windows, Allegro, etc). 175 176 177 X/Mesa Driver 178 ------------- 179 180 The source files for the X/Mesa driver in src/X have been renamed. 181 The xmesa[1234].c files are gone. The new files are xm_api.c, 182 xm_dd.c, xm_line.c, xm_span.c and xm_tri.c. 183 184 185 186 Multitexture 187 ------------ 188 189 Eight texture units are now supported by default. 190 191 192 193 OpenGL SI related changes 194 ------------------------- 195 196 In an effort to make Mesa's internal interfaces more like the OpenGL 197 SI interfaces, a number of changes have been made: 198 199 1. Importing the SI's glcore.h file which defines a number of 200 interface structures like __GLimports and __GLexports. 201 202 2. Renamed "struct gl_context" to "struct __GLcontextRec". 203 204 3. Added __glCoreCreateContext() and __glCoreNopDispatch() functions. 205 206 4. The GLcontext member Visual is no longer a pointer. 207 208 5. New file: imports.c to setup default import functions for Mesa. 209 210 211 212 213 16-bit color channels 214 --------------------- 215 216 There's experimental support for 16-bit color channels (64-bit pixels) 217 in Mesa 3.5. Only the OSMesa interface can be used for 16-bit rendering. 218 Type "make linux-osmesa16" in the top-level directory to build the 219 special libOSMesa16.so library. 220 221 This hasn't been tested very thoroughly yet so please file bug reports 222 if you have trouble. 223 224 In the future I hope to implement support for 32-bit, floating point 225 color channels. 226 227 ---------------------------------------------------------------------- 228
