9d8083ccc88c66cacf5022a3860375bd35e6a438
[reactos.git] / reactos / dll / opengl / mesa / src / mesa / main / extensions.c
1 /*
2 * Mesa 3-D graphics library
3 * Version: 7.6
4 *
5 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
6 * Copyright (C) 2009 VMware, Inc. All Rights Reserved.
7 *
8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the "Software"),
10 * to deal in the Software without restriction, including without limitation
11 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
12 * and/or sell copies of the Software, and to permit persons to whom the
13 * Software is furnished to do so, subject to the following conditions:
14 *
15 * The above copyright notice and this permission notice shall be included
16 * in all copies or substantial portions of the Software.
17 *
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
21 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
22 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
23 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
24 */
25
26
27 /**
28 * \file
29 * \brief Extension handling
30 */
31
32
33 #include "glheader.h"
34 #include "imports.h"
35 #include "context.h"
36 #include "extensions.h"
37 #include "mfeatures.h"
38 #include "mtypes.h"
39
40 #define ALIGN(value, alignment) (((value) + alignment - 1) & ~(alignment - 1))
41
42 enum {
43 DISABLE = 0,
44 GL = 1 << API_OPENGL,
45 ES1 = 1 << API_OPENGLES,
46 ES2 = 1 << API_OPENGLES2,
47 };
48
49 /**
50 * \brief An element of the \c extension_table.
51 */
52 struct extension {
53 /** Name of extension, such as "GL_ARB_depth_clamp". */
54 const char *name;
55
56 /** Offset (in bytes) of the corresponding member in struct gl_extensions. */
57 size_t offset;
58
59 /** Set of API's in which the extension exists, as a bitset. */
60 uint8_t api_set;
61
62 /** Year the extension was proposed or approved. Used to sort the
63 * extension string chronologically. */
64 uint16_t year;
65 };
66
67
68 /**
69 * Given a member \c x of struct gl_extensions, return offset of
70 * \c x in bytes.
71 */
72 #define o(x) offsetof(struct gl_extensions, x)
73
74
75 /**
76 * \brief Table of supported OpenGL extensions for all API's.
77 */
78 static const struct extension extension_table[] = {
79 /* ARB Extensions */
80 { "GL_ARB_ES2_compatibility", o(ARB_ES2_compatibility), GL, 2009 },
81 { "GL_ARB_blend_func_extended", o(ARB_blend_func_extended), GL, 2009 },
82 { "GL_ARB_color_buffer_float", o(ARB_color_buffer_float), GL, 2004 },
83 { "GL_ARB_copy_buffer", o(ARB_copy_buffer), GL, 2008 },
84 { "GL_ARB_conservative_depth", o(ARB_conservative_depth), GL, 2011 },
85 { "GL_ARB_depth_buffer_float", o(ARB_depth_buffer_float), GL, 2008 },
86 { "GL_ARB_depth_clamp", o(ARB_depth_clamp), GL, 2003 },
87 { "GL_ARB_draw_buffers", o(dummy_true), GL, 2002 },
88 { "GL_ARB_draw_buffers_blend", o(ARB_draw_buffers_blend), GL, 2009 },
89 { "GL_ARB_draw_elements_base_vertex", o(ARB_draw_elements_base_vertex), GL, 2009 },
90 { "GL_ARB_draw_instanced", o(ARB_draw_instanced), GL, 2008 },
91 { "GL_ARB_explicit_attrib_location", o(ARB_explicit_attrib_location), GL, 2009 },
92 { "GL_ARB_fragment_coord_conventions", o(ARB_fragment_coord_conventions), GL, 2009 },
93 { "GL_ARB_fragment_program", o(ARB_fragment_program), GL, 2002 },
94 { "GL_ARB_fragment_program_shadow", o(ARB_fragment_program_shadow), GL, 2003 },
95 { "GL_ARB_fragment_shader", o(ARB_fragment_shader), GL, 2002 },
96 { "GL_ARB_framebuffer_object", o(ARB_framebuffer_object), GL, 2005 },
97 { "GL_ARB_framebuffer_sRGB", o(EXT_framebuffer_sRGB), GL, 1998 },
98 { "GL_ARB_half_float_pixel", o(ARB_half_float_pixel), GL, 2003 },
99 { "GL_ARB_half_float_vertex", o(ARB_half_float_vertex), GL, 2008 },
100 { "GL_ARB_instanced_arrays", o(ARB_instanced_arrays), GL, 2008 },
101 { "GL_ARB_map_buffer_range", o(ARB_map_buffer_range), GL, 2008 },
102 { "GL_ARB_multisample", o(dummy_true), GL, 1994 },
103 { "GL_ARB_multitexture", o(dummy_true), GL, 1998 },
104 { "GL_ARB_pixel_buffer_object", o(EXT_pixel_buffer_object), GL, 2004 },
105 { "GL_ARB_point_parameters", o(EXT_point_parameters), GL, 1997 },
106 { "GL_ARB_point_sprite", o(ARB_point_sprite), GL, 2003 },
107 { "GL_ARB_provoking_vertex", o(EXT_provoking_vertex), GL, 2009 },
108 { "GL_ARB_robustness", o(dummy_true), GL, 2010 },
109 { "GL_ARB_seamless_cube_map", o(ARB_seamless_cube_map), GL, 2009 },
110 { "GL_ARB_shader_objects", o(ARB_shader_objects), GL, 2002 },
111 { "GL_ARB_shader_stencil_export", o(ARB_shader_stencil_export), GL, 2009 },
112 { "GL_ARB_shader_texture_lod", o(ARB_shader_texture_lod), GL, 2009 },
113 { "GL_ARB_shading_language_100", o(ARB_shading_language_100), GL, 2003 },
114 { "GL_ARB_texture_border_clamp", o(ARB_texture_border_clamp), GL, 2000 },
115 { "GL_ARB_texture_buffer_object", o(ARB_texture_buffer_object), GL, 2008 },
116 { "GL_ARB_texture_compression", o(dummy_true), GL, 2000 },
117 { "GL_ARB_texture_compression_rgtc", o(ARB_texture_compression_rgtc), GL, 2004 },
118 { "GL_ARB_texture_cube_map", o(ARB_texture_cube_map), GL, 1999 },
119 { "GL_ARB_texture_env_add", o(dummy_true), GL, 1999 },
120 { "GL_ARB_texture_env_combine", o(ARB_texture_env_combine), GL, 2001 },
121 { "GL_ARB_texture_env_crossbar", o(ARB_texture_env_crossbar), GL, 2001 },
122 { "GL_ARB_texture_env_dot3", o(ARB_texture_env_dot3), GL, 2001 },
123 { "GL_ARB_texture_float", o(ARB_texture_float), GL, 2004 },
124 { "GL_ARB_texture_mirrored_repeat", o(dummy_true), GL, 2001 },
125 { "GL_ARB_texture_multisample", o(ARB_texture_multisample), GL, 2009 },
126 { "GL_ARB_texture_non_power_of_two", o(ARB_texture_non_power_of_two), GL, 2003 },
127 { "GL_ARB_texture_rectangle", o(NV_texture_rectangle), GL, 2004 },
128 { "GL_ARB_texture_rg", o(ARB_texture_rg), GL, 2008 },
129 { "GL_ARB_texture_storage", o(ARB_texture_storage), GL, 2011 },
130 { "GL_ARB_transpose_matrix", o(ARB_transpose_matrix), GL, 1999 },
131 { "GL_ARB_uniform_buffer_object", o(ARB_uniform_buffer_object), GL, 2002 },
132 { "GL_ARB_vertex_array_bgra", o(EXT_vertex_array_bgra), GL, 2008 },
133 { "GL_ARB_vertex_array_object", o(ARB_vertex_array_object), GL, 2006 },
134 { "GL_ARB_vertex_buffer_object", o(dummy_true), GL, 2003 },
135 { "GL_ARB_vertex_program", o(ARB_vertex_program), GL, 2002 },
136 { "GL_ARB_vertex_shader", o(ARB_vertex_shader), GL, 2002 },
137 { "GL_ARB_window_pos", o(ARB_window_pos), GL, 2001 },
138 /* EXT extensions */
139 { "GL_EXT_abgr", o(dummy_true), GL, 1995 },
140 { "GL_EXT_bgra", o(dummy_true), GL, 1995 },
141 { "GL_EXT_blend_color", o(EXT_blend_color), GL, 1995 },
142 { "GL_EXT_blend_equation_separate", o(EXT_blend_equation_separate), GL, 2003 },
143 { "GL_EXT_blend_func_separate", o(EXT_blend_func_separate), GL, 1999 },
144 { "GL_EXT_blend_minmax", o(EXT_blend_minmax), GL | ES1 | ES2, 1995 },
145 { "GL_EXT_blend_subtract", o(dummy_true), GL, 1995 },
146 { "GL_EXT_clip_volume_hint", o(EXT_clip_volume_hint), GL, 1996 },
147 { "GL_EXT_compiled_vertex_array", o(EXT_compiled_vertex_array), GL, 1996 },
148 { "GL_EXT_copy_texture", o(dummy_true), GL, 1995 },
149 { "GL_EXT_depth_bounds_test", o(EXT_depth_bounds_test), GL, 2002 },
150 { "GL_EXT_draw_instanced", o(ARB_draw_instanced), GL, 2006 },
151 { "GL_EXT_draw_range_elements", o(EXT_draw_range_elements), GL, 1997 },
152 { "GL_EXT_fog_coord", o(EXT_fog_coord), GL, 1999 },
153 { "GL_EXT_framebuffer_blit", o(EXT_framebuffer_blit), GL, 2005 },
154 { "GL_EXT_framebuffer_multisample", o(EXT_framebuffer_multisample), GL, 2005 },
155 { "GL_EXT_framebuffer_object", o(EXT_framebuffer_object), GL, 2000 },
156 { "GL_EXT_framebuffer_sRGB", o(EXT_framebuffer_sRGB), GL, 1998 },
157 { "GL_EXT_gpu_program_parameters", o(EXT_gpu_program_parameters), GL, 2006 },
158 { "GL_EXT_gpu_shader4", o(EXT_gpu_shader4), GL, 2006 },
159 { "GL_EXT_multi_draw_arrays", o(dummy_true), GL | ES1 | ES2, 1999 },
160 { "GL_EXT_packed_depth_stencil", o(EXT_packed_depth_stencil), GL, 2005 },
161 { "GL_EXT_packed_pixels", o(EXT_packed_pixels), GL, 1997 },
162 { "GL_EXT_pixel_buffer_object", o(EXT_pixel_buffer_object), GL, 2004 },
163 { "GL_EXT_point_parameters", o(EXT_point_parameters), GL, 1997 },
164 { "GL_EXT_polygon_offset", o(dummy_true), GL, 1995 },
165 { "GL_EXT_provoking_vertex", o(EXT_provoking_vertex), GL, 2009 },
166 { "GL_EXT_rescale_normal", o(EXT_rescale_normal), GL, 1997 },
167 { "GL_EXT_secondary_color", o(EXT_secondary_color), GL, 1999 },
168 { "GL_EXT_separate_shader_objects", o(EXT_separate_shader_objects), GL, 2008 },
169 { "GL_EXT_separate_specular_color", o(EXT_separate_specular_color), GL, 1997 },
170 { "GL_EXT_shadow_funcs", o(EXT_shadow_funcs), GL, 2002 },
171 { "GL_EXT_stencil_two_side", o(EXT_stencil_two_side), GL, 2001 },
172 { "GL_EXT_stencil_wrap", o(dummy_true), GL, 2002 },
173 { "GL_EXT_subtexture", o(dummy_true), GL, 1995 },
174 { "GL_EXT_texture3D", o(EXT_texture3D), GL, 1996 },
175 { "GL_EXT_texture_array", o(EXT_texture_array), GL, 2006 },
176 { "GL_EXT_texture_compression_dxt1", o(EXT_texture_compression_s3tc), GL | ES1 | ES2, 2004 },
177 { "GL_EXT_texture_compression_latc", o(EXT_texture_compression_latc), GL, 2006 },
178 { "GL_EXT_texture_compression_rgtc", o(ARB_texture_compression_rgtc), GL, 2004 },
179 { "GL_EXT_texture_compression_s3tc", o(EXT_texture_compression_s3tc), GL, 2000 },
180 { "GL_EXT_texture_cube_map", o(ARB_texture_cube_map), GL, 2001 },
181 { "GL_EXT_texture_edge_clamp", o(dummy_true), GL, 1997 },
182 { "GL_EXT_texture_env_add", o(dummy_true), GL, 1999 },
183 { "GL_EXT_texture_env_combine", o(dummy_true), GL, 2000 },
184 { "GL_EXT_texture_env_dot3", o(EXT_texture_env_dot3), GL, 2000 },
185 { "GL_EXT_texture_filter_anisotropic", o(EXT_texture_filter_anisotropic), GL | ES1 | ES2, 1999 },
186 { "GL_EXT_texture_format_BGRA8888", o(dummy_true), ES1 | ES2, 2005 },
187 { "GL_EXT_texture_integer", o(EXT_texture_integer), GL, 2006 },
188 { "GL_EXT_texture_lod_bias", o(dummy_true), GL | ES1, 1999 },
189 { "GL_EXT_texture_mirror_clamp", o(EXT_texture_mirror_clamp), GL, 2004 },
190 { "GL_EXT_texture_object", o(dummy_true), GL, 1995 },
191 { "GL_EXT_texture", o(dummy_true), GL, 1996 },
192 { "GL_EXT_texture_rectangle", o(NV_texture_rectangle), GL, 2004 },
193 { "GL_EXT_texture_snorm", o(EXT_texture_snorm), GL, 2009 },
194 { "GL_EXT_texture_sRGB", o(EXT_texture_sRGB), GL, 2004 },
195 { "GL_EXT_texture_type_2_10_10_10_REV", o(dummy_true), ES2, 2008 },
196 { "GL_EXT_vertex_array_bgra", o(EXT_vertex_array_bgra), GL, 2008 },
197 { "GL_EXT_vertex_array", o(dummy_true), GL, 1995 },
198
199 /* OES extensions */
200 { "GL_OES_blend_equation_separate", o(EXT_blend_equation_separate), ES1, 2009 },
201 { "GL_OES_blend_func_separate", o(EXT_blend_func_separate), ES1, 2009 },
202 { "GL_OES_blend_subtract", o(dummy_true), ES1, 2009 },
203 { "GL_OES_byte_coordinates", o(dummy_true), ES1, 2002 },
204 { "GL_OES_compressed_paletted_texture", o(dummy_true), ES1, 2003 },
205 { "GL_OES_depth24", o(EXT_framebuffer_object), ES1 | ES2, 2005 },
206 { "GL_OES_depth32", o(dummy_false), DISABLE, 2005 },
207 #if FEATURE_OES_draw_texture
208 { "GL_OES_draw_texture", o(OES_draw_texture), ES1 | ES2, 2004 },
209 #endif
210 #if FEATURE_OES_EGL_image
211 /* FIXME: Mesa expects GL_OES_EGL_image to be available in OpenGL contexts. */
212 { "GL_OES_EGL_image", o(OES_EGL_image), GL | ES1 | ES2, 2006 },
213 { "GL_OES_EGL_image_external", o(OES_EGL_image_external), ES1 | ES2, 2010 },
214 #endif
215 { "GL_OES_element_index_uint", o(dummy_true), ES1 | ES2, 2005 },
216 { "GL_OES_fbo_render_mipmap", o(EXT_framebuffer_object), ES1 | ES2, 2005 },
217 { "GL_OES_fixed_point", o(dummy_true), ES1, 2002 },
218 { "GL_OES_framebuffer_object", o(EXT_framebuffer_object), ES1, 2005 },
219 { "GL_OES_mapbuffer", o(dummy_true), ES1 | ES2, 2005 },
220 { "GL_OES_matrix_get", o(dummy_true), ES1, 2004 },
221 { "GL_OES_packed_depth_stencil", o(EXT_packed_depth_stencil), ES1 | ES2, 2007 },
222 { "GL_OES_point_size_array", o(dummy_true), ES1, 2004 },
223 { "GL_OES_point_sprite", o(ARB_point_sprite), ES1, 2004 },
224 { "GL_OES_query_matrix", o(dummy_true), ES1, 2003 },
225 { "GL_OES_read_format", o(dummy_true), GL | ES1, 2003 },
226 { "GL_OES_rgb8_rgba8", o(EXT_framebuffer_object), ES1 | ES2, 2005 },
227 { "GL_OES_single_precision", o(dummy_true), ES1, 2003 },
228 { "GL_OES_standard_derivatives", o(OES_standard_derivatives), ES2, 2005 },
229 { "GL_OES_stencil1", o(dummy_false), DISABLE, 2005 },
230 { "GL_OES_stencil4", o(dummy_false), DISABLE, 2005 },
231 { "GL_OES_stencil8", o(EXT_framebuffer_object), ES1 | ES2, 2005 },
232 { "GL_OES_stencil_wrap", o(dummy_true), ES1, 2002 },
233 { "GL_OES_texture_3D", o(EXT_texture3D), ES2, 2005 },
234 { "GL_OES_texture_cube_map", o(ARB_texture_cube_map), ES1, 2007 },
235 { "GL_OES_texture_env_crossbar", o(ARB_texture_env_crossbar), ES1, 2005 },
236 { "GL_OES_texture_mirrored_repeat", o(dummy_true), ES1, 2005 },
237 { "GL_OES_texture_npot", o(ARB_texture_non_power_of_two), ES2, 2005 },
238
239 /* Vendor extensions */
240 { "GL_3DFX_texture_compression_FXT1", o(TDFX_texture_compression_FXT1), GL, 1999 },
241 { "GL_AMD_conservative_depth", o(ARB_conservative_depth), GL, 2009 },
242 { "GL_AMD_draw_buffers_blend", o(ARB_draw_buffers_blend), GL, 2009 },
243 { "GL_AMD_seamless_cubemap_per_texture", o(AMD_seamless_cubemap_per_texture), GL, 2009 },
244 { "GL_AMD_shader_stencil_export", o(ARB_shader_stencil_export), GL, 2009 },
245 { "GL_APPLE_object_purgeable", o(APPLE_object_purgeable), GL, 2006 },
246 { "GL_APPLE_packed_pixels", o(APPLE_packed_pixels), GL, 2002 },
247 { "GL_APPLE_vertex_array_object", o(APPLE_vertex_array_object), GL, 2002 },
248 { "GL_ATI_blend_equation_separate", o(EXT_blend_equation_separate), GL, 2003 },
249 { "GL_ATI_draw_buffers", o(dummy_true), GL, 2002 },
250 { "GL_ATI_envmap_bumpmap", o(ATI_envmap_bumpmap), GL, 2001 },
251 { "GL_ATI_separate_stencil", o(ATI_separate_stencil), GL, 2006 },
252 { "GL_ATI_texture_compression_3dc", o(ATI_texture_compression_3dc), GL, 2004 },
253 { "GL_ATI_texture_env_combine3", o(ATI_texture_env_combine3), GL, 2002 },
254 { "GL_ATI_texture_float", o(ARB_texture_float), GL, 2002 },
255 { "GL_ATI_texture_mirror_once", o(ATI_texture_mirror_once), GL, 2006 },
256 { "GL_IBM_multimode_draw_arrays", o(IBM_multimode_draw_arrays), GL, 1998 },
257 { "GL_IBM_rasterpos_clip", o(IBM_rasterpos_clip), GL, 1996 },
258 { "GL_IBM_texture_mirrored_repeat", o(dummy_true), GL, 1998 },
259 { "GL_INGR_blend_func_separate", o(EXT_blend_func_separate), GL, 1999 },
260 { "GL_MESA_pack_invert", o(MESA_pack_invert), GL, 2002 },
261 { "GL_MESA_resize_buffers", o(MESA_resize_buffers), GL, 1999 },
262 { "GL_MESA_texture_array", o(MESA_texture_array), GL, 2007 },
263 { "GL_MESA_texture_signed_rgba", o(EXT_texture_snorm), GL, 2009 },
264 { "GL_MESA_window_pos", o(ARB_window_pos), GL, 2000 },
265 { "GL_MESA_ycbcr_texture", o(MESA_ycbcr_texture), GL, 2002 },
266 { "GL_NV_blend_square", o(NV_blend_square), GL, 1999 },
267 { "GL_NV_depth_clamp", o(ARB_depth_clamp), GL, 2001 },
268 { "GL_NV_draw_buffers", o(dummy_true), ES2, 2011 },
269 { "GL_NV_fbo_color_attachments", o(EXT_framebuffer_object), ES2, 2010 },
270 { "GL_NV_fog_distance", o(NV_fog_distance), GL, 2001 },
271 { "GL_NV_fragment_program", o(NV_fragment_program), GL, 2001 },
272 { "GL_NV_fragment_program_option", o(NV_fragment_program_option), GL, 2005 },
273 { "GL_NV_light_max_exponent", o(NV_light_max_exponent), GL, 1999 },
274 { "GL_NV_packed_depth_stencil", o(EXT_packed_depth_stencil), GL, 2000 },
275 { "GL_NV_point_sprite", o(NV_point_sprite), GL, 2001 },
276 { "GL_NV_primitive_restart", o(NV_primitive_restart), GL, 2002 },
277 { "GL_NV_texgen_reflection", o(NV_texgen_reflection), GL, 1999 },
278 { "GL_NV_texture_barrier", o(NV_texture_barrier), GL, 2009 },
279 { "GL_NV_texture_env_combine4", o(NV_texture_env_combine4), GL, 1999 },
280 { "GL_NV_texture_rectangle", o(NV_texture_rectangle), GL, 2000 },
281 { "GL_NV_vertex_program1_1", o(NV_vertex_program1_1), GL, 2001 },
282 { "GL_NV_vertex_program", o(NV_vertex_program), GL, 2000 },
283 { "GL_S3_s3tc", o(S3_s3tc), GL, 1999 },
284 { "GL_SGIS_generate_mipmap", o(dummy_true), GL, 1997 },
285 { "GL_SGIS_texture_border_clamp", o(ARB_texture_border_clamp), GL, 1997 },
286 { "GL_SGIS_texture_edge_clamp", o(dummy_true), GL, 1997 },
287 { "GL_SGIS_texture_lod", o(SGIS_texture_lod), GL, 1997 },
288 { "GL_SUN_multi_draw_arrays", o(dummy_true), GL, 1999 },
289
290 { 0, 0, 0, 0 },
291 };
292
293
294 /**
295 * Given an extension name, lookup up the corresponding member of struct
296 * gl_extensions and return that member's offset (in bytes). If the name is
297 * not found in the \c extension_table, return 0.
298 *
299 * \param name Name of extension.
300 * \return Offset of member in struct gl_extensions.
301 */
302 static size_t
303 name_to_offset(const char* name)
304 {
305 const struct extension *i;
306
307 if (name == 0)
308 return 0;
309
310 for (i = extension_table; i->name != 0; ++i) {
311 if (strcmp(name, i->name) == 0)
312 return i->offset;
313 }
314
315 return 0;
316 }
317
318
319 /**
320 * \brief Extensions enabled by default.
321 *
322 * These extensions are enabled by _mesa_init_extensions().
323 *
324 * XXX: Should these defaults also apply to GLES?
325 */
326 static const size_t default_extensions[] = {
327 o(ARB_copy_buffer),
328 o(ARB_transpose_matrix),
329 o(ARB_window_pos),
330
331 o(EXT_compiled_vertex_array),
332 o(EXT_draw_range_elements),
333 o(EXT_packed_pixels),
334 o(EXT_rescale_normal),
335 o(EXT_separate_specular_color),
336 o(EXT_texture3D),
337
338 o(OES_standard_derivatives),
339
340 /* Vendor Extensions */
341 o(APPLE_packed_pixels),
342 o(IBM_multimode_draw_arrays),
343 o(IBM_rasterpos_clip),
344 o(NV_light_max_exponent),
345 o(NV_texgen_reflection),
346 o(SGIS_texture_lod),
347
348 0,
349 };
350
351
352 /**
353 * Enable all extensions suitable for a software-only renderer.
354 * This is a convenience function used by the XMesa, OSMesa, GGI drivers, etc.
355 */
356 void
357 _mesa_enable_sw_extensions(struct gl_context *ctx)
358 {
359 /*ctx->Extensions.ARB_copy_buffer = GL_TRUE;*/
360 ctx->Extensions.ARB_depth_clamp = GL_TRUE;
361 ctx->Extensions.ARB_draw_elements_base_vertex = GL_TRUE;
362 ctx->Extensions.ARB_draw_instanced = GL_TRUE;
363 ctx->Extensions.ARB_explicit_attrib_location = GL_TRUE;
364 ctx->Extensions.ARB_fragment_coord_conventions = GL_TRUE;
365 #if FEATURE_ARB_fragment_program
366 ctx->Extensions.ARB_fragment_program = GL_TRUE;
367 ctx->Extensions.ARB_fragment_program_shadow = GL_TRUE;
368 #endif
369 #if FEATURE_ARB_fragment_shader
370 ctx->Extensions.ARB_fragment_shader = GL_TRUE;
371 #endif
372 #if FEATURE_ARB_framebuffer_object
373 ctx->Extensions.ARB_framebuffer_object = GL_TRUE;
374 #endif
375 #if FEATURE_ARB_geometry_shader4 && 0
376 /* XXX re-enable when GLSL compiler again supports geometry shaders */
377 ctx->Extensions.ARB_geometry_shader4 = GL_TRUE;
378 #endif
379 ctx->Extensions.ARB_half_float_pixel = GL_TRUE;
380 ctx->Extensions.ARB_half_float_vertex = GL_TRUE;
381 ctx->Extensions.ARB_map_buffer_range = GL_TRUE;
382 ctx->Extensions.ARB_point_sprite = GL_TRUE;
383 #if FEATURE_ARB_shader_objects
384 ctx->Extensions.ARB_shader_objects = GL_TRUE;
385 ctx->Extensions.EXT_separate_shader_objects = GL_TRUE;
386 #endif
387 #if FEATURE_ARB_shading_language_100
388 ctx->Extensions.ARB_shading_language_100 = GL_TRUE;
389 #endif
390 ctx->Extensions.ARB_texture_border_clamp = GL_TRUE;
391 ctx->Extensions.ARB_texture_cube_map = GL_TRUE;
392 ctx->Extensions.ARB_texture_env_combine = GL_TRUE;
393 ctx->Extensions.ARB_texture_env_crossbar = GL_TRUE;
394 ctx->Extensions.ARB_texture_env_dot3 = GL_TRUE;
395 /*ctx->Extensions.ARB_texture_float = GL_TRUE;*/
396 ctx->Extensions.ARB_texture_non_power_of_two = GL_TRUE;
397 ctx->Extensions.ARB_texture_rg = GL_TRUE;
398 ctx->Extensions.ARB_texture_compression_rgtc = GL_TRUE;
399 ctx->Extensions.ARB_texture_storage = GL_TRUE;
400 ctx->Extensions.ARB_vertex_array_object = GL_TRUE;
401 #if FEATURE_ARB_vertex_program
402 ctx->Extensions.ARB_vertex_program = GL_TRUE;
403 #endif
404 #if FEATURE_ARB_vertex_shader
405 ctx->Extensions.ARB_vertex_shader = GL_TRUE;
406 #endif
407 ctx->Extensions.APPLE_vertex_array_object = GL_TRUE;
408 #if FEATURE_APPLE_object_purgeable
409 ctx->Extensions.APPLE_object_purgeable = GL_TRUE;
410 #endif
411 ctx->Extensions.ATI_envmap_bumpmap = GL_TRUE;
412 ctx->Extensions.ATI_texture_compression_3dc = GL_TRUE;
413 ctx->Extensions.ATI_texture_env_combine3 = GL_TRUE;
414 ctx->Extensions.ATI_texture_mirror_once = GL_TRUE;
415 ctx->Extensions.ATI_separate_stencil = GL_TRUE;
416 ctx->Extensions.EXT_blend_color = GL_TRUE;
417 ctx->Extensions.EXT_blend_equation_separate = GL_TRUE;
418 ctx->Extensions.EXT_blend_func_separate = GL_TRUE;
419 ctx->Extensions.EXT_blend_minmax = GL_TRUE;
420 ctx->Extensions.EXT_depth_bounds_test = GL_TRUE;
421 ctx->Extensions.EXT_fog_coord = GL_TRUE;
422 #if FEATURE_EXT_framebuffer_object
423 ctx->Extensions.EXT_framebuffer_object = GL_TRUE;
424 #endif
425 #if FEATURE_EXT_framebuffer_blit
426 ctx->Extensions.EXT_framebuffer_blit = GL_TRUE;
427 #endif
428 #if FEATURE_ARB_framebuffer_object
429 ctx->Extensions.EXT_framebuffer_multisample = GL_TRUE;
430 #endif
431 ctx->Extensions.EXT_packed_depth_stencil = GL_TRUE;
432 #if FEATURE_EXT_pixel_buffer_object
433 ctx->Extensions.EXT_pixel_buffer_object = GL_TRUE;
434 #endif
435 ctx->Extensions.EXT_point_parameters = GL_TRUE;
436 ctx->Extensions.EXT_provoking_vertex = GL_TRUE;
437 ctx->Extensions.EXT_shadow_funcs = GL_TRUE;
438 ctx->Extensions.EXT_secondary_color = GL_TRUE;
439 ctx->Extensions.EXT_stencil_two_side = GL_TRUE;
440 ctx->Extensions.EXT_texture_array = GL_TRUE;
441 ctx->Extensions.EXT_texture_compression_latc = GL_TRUE;
442 ctx->Extensions.EXT_texture_env_dot3 = GL_TRUE;
443 ctx->Extensions.EXT_texture_filter_anisotropic = GL_TRUE;
444 ctx->Extensions.EXT_texture_mirror_clamp = GL_TRUE;
445 #if FEATURE_EXT_texture_sRGB
446 ctx->Extensions.EXT_texture_sRGB = GL_TRUE;
447 #endif
448 ctx->Extensions.EXT_vertex_array_bgra = GL_TRUE;
449 /*ctx->Extensions.IBM_multimode_draw_arrays = GL_TRUE;*/
450 ctx->Extensions.MESA_pack_invert = GL_TRUE;
451 ctx->Extensions.MESA_resize_buffers = GL_TRUE;
452 ctx->Extensions.MESA_texture_array = GL_TRUE;
453 ctx->Extensions.MESA_ycbcr_texture = GL_TRUE;
454 ctx->Extensions.NV_blend_square = GL_TRUE;
455 /*ctx->Extensions.NV_light_max_exponent = GL_TRUE;*/
456 ctx->Extensions.NV_point_sprite = GL_TRUE;
457 ctx->Extensions.NV_texture_env_combine4 = GL_TRUE;
458 ctx->Extensions.NV_texture_rectangle = GL_TRUE;
459 /*ctx->Extensions.NV_texgen_reflection = GL_TRUE;*/
460 #if FEATURE_NV_vertex_program
461 ctx->Extensions.NV_vertex_program = GL_TRUE;
462 ctx->Extensions.NV_vertex_program1_1 = GL_TRUE;
463 #endif
464 #if FEATURE_NV_fragment_program
465 ctx->Extensions.NV_fragment_program = GL_TRUE;
466 #endif
467 #if FEATURE_NV_fragment_program && FEATURE_ARB_fragment_program
468 ctx->Extensions.NV_fragment_program_option = GL_TRUE;
469 #endif
470 #if FEATURE_ARB_vertex_program || FEATURE_ARB_fragment_program
471 ctx->Extensions.EXT_gpu_program_parameters = GL_TRUE;
472 #endif
473 #if FEATURE_texture_fxt1
474 _mesa_enable_extension(ctx, "GL_3DFX_texture_compression_FXT1");
475 #endif
476 #if FEATURE_texture_s3tc
477 if (ctx->Mesa_DXTn) {
478 _mesa_enable_extension(ctx, "GL_EXT_texture_compression_s3tc");
479 _mesa_enable_extension(ctx, "GL_S3_s3tc");
480 }
481 #endif
482 }
483
484
485 /**
486 * Enable all OpenGL 1.3 features and extensions.
487 * A convenience function to be called by drivers.
488 */
489 void
490 _mesa_enable_1_3_extensions(struct gl_context *ctx)
491 {
492 ctx->Extensions.ARB_texture_border_clamp = GL_TRUE;
493 ctx->Extensions.ARB_texture_cube_map = GL_TRUE;
494 ctx->Extensions.ARB_texture_env_combine = GL_TRUE;
495 ctx->Extensions.ARB_texture_env_dot3 = GL_TRUE;
496 /*ctx->Extensions.ARB_transpose_matrix = GL_TRUE;*/
497 }
498
499
500
501 /**
502 * Enable all OpenGL 1.4 features and extensions.
503 * A convenience function to be called by drivers.
504 */
505 void
506 _mesa_enable_1_4_extensions(struct gl_context *ctx)
507 {
508 ctx->Extensions.ARB_texture_env_crossbar = GL_TRUE;
509 ctx->Extensions.ARB_window_pos = GL_TRUE;
510 ctx->Extensions.EXT_blend_color = GL_TRUE;
511 ctx->Extensions.EXT_blend_func_separate = GL_TRUE;
512 ctx->Extensions.EXT_blend_minmax = GL_TRUE;
513 ctx->Extensions.EXT_fog_coord = GL_TRUE;
514 ctx->Extensions.EXT_point_parameters = GL_TRUE;
515 ctx->Extensions.EXT_secondary_color = GL_TRUE;
516 }
517
518
519 /**
520 * Enable all OpenGL 1.5 features and extensions.
521 * A convenience function to be called by drivers.
522 */
523 void
524 _mesa_enable_1_5_extensions(struct gl_context *ctx)
525 {
526 ctx->Extensions.EXT_shadow_funcs = GL_TRUE;
527 }
528
529
530 /**
531 * Enable all OpenGL 2.0 features and extensions.
532 * A convenience function to be called by drivers.
533 */
534 void
535 _mesa_enable_2_0_extensions(struct gl_context *ctx)
536 {
537 #if FEATURE_ARB_fragment_shader
538 ctx->Extensions.ARB_fragment_shader = GL_TRUE;
539 #endif
540 ctx->Extensions.ARB_point_sprite = GL_TRUE;
541 ctx->Extensions.EXT_blend_equation_separate = GL_TRUE;
542 ctx->Extensions.ARB_texture_non_power_of_two = GL_TRUE;
543 #if FEATURE_ARB_shader_objects
544 ctx->Extensions.ARB_shader_objects = GL_TRUE;
545 #endif
546 #if FEATURE_ARB_shading_language_100
547 ctx->Extensions.ARB_shading_language_100 = GL_TRUE;
548 #endif
549 ctx->Extensions.EXT_stencil_two_side = GL_TRUE;
550 #if FEATURE_ARB_vertex_shader
551 ctx->Extensions.ARB_vertex_shader = GL_TRUE;
552 #endif
553 }
554
555
556 /**
557 * Enable all OpenGL 2.1 features and extensions.
558 * A convenience function to be called by drivers.
559 */
560 void
561 _mesa_enable_2_1_extensions(struct gl_context *ctx)
562 {
563 #if FEATURE_EXT_pixel_buffer_object
564 ctx->Extensions.EXT_pixel_buffer_object = GL_TRUE;
565 #endif
566 #if FEATURE_EXT_texture_sRGB
567 ctx->Extensions.EXT_texture_sRGB = GL_TRUE;
568 #endif
569 }
570
571
572 /**
573 * Either enable or disable the named extension.
574 * \return GL_TRUE for success, GL_FALSE if invalid extension name
575 */
576 static GLboolean
577 set_extension( struct gl_context *ctx, const char *name, GLboolean state )
578 {
579 size_t offset;
580
581 if (ctx->Extensions.String) {
582 /* The string was already queried - can't change it now! */
583 _mesa_problem(ctx, "Trying to enable/disable extension after glGetString(GL_EXTENSIONS): %s", name);
584 return GL_FALSE;
585 }
586
587 offset = name_to_offset(name);
588 if (offset == 0) {
589 _mesa_problem(ctx, "Trying to enable/disable unknown extension %s",
590 name);
591 return GL_FALSE;
592 } else if (offset == o(dummy_true) && state == GL_FALSE) {
593 _mesa_problem(ctx, "Trying to disable a permanently enabled extension: "
594 "%s", name);
595 return GL_FALSE;
596 } else {
597 GLboolean *base = (GLboolean *) &ctx->Extensions;
598 base[offset] = state;
599 return GL_TRUE;
600 }
601 }
602
603
604 /**
605 * Enable the named extension.
606 * Typically called by drivers.
607 */
608 void
609 _mesa_enable_extension( struct gl_context *ctx, const char *name )
610 {
611 if (!set_extension(ctx, name, GL_TRUE))
612 _mesa_problem(ctx, "Trying to enable unknown extension: %s", name);
613 }
614
615
616 /**
617 * Disable the named extension.
618 * XXX is this really needed???
619 */
620 void
621 _mesa_disable_extension( struct gl_context *ctx, const char *name )
622 {
623 if (!set_extension(ctx, name, GL_FALSE))
624 _mesa_problem(ctx, "Trying to disable unknown extension: %s", name);
625 }
626
627
628 /**
629 * Test if the named extension is enabled in this context.
630 */
631 GLboolean
632 _mesa_extension_is_enabled( struct gl_context *ctx, const char *name )
633 {
634 size_t offset;
635 GLboolean *base;
636
637 if (name == 0)
638 return GL_FALSE;
639
640 offset = name_to_offset(name);
641 if (offset == 0)
642 return GL_FALSE;
643 base = (GLboolean *) &ctx->Extensions;
644 return base[offset];
645 }
646
647
648 /**
649 * \brief Apply the \c MESA_EXTENSION_OVERRIDE environment variable.
650 *
651 * \c MESA_EXTENSION_OVERRIDE is a space-separated list of extensions to
652 * enable or disable. The list is processed thus:
653 * - Enable recognized extension names that are prefixed with '+'.
654 * - Disable recognized extension names that are prefixed with '-'.
655 * - Enable recognized extension names that are not prefixed.
656 * - Collect unrecognized extension names in a new string.
657 *
658 * \return Space-separated list of unrecognized extension names (which must
659 * be freed). Does not return \c NULL.
660 */
661 static char *
662 get_extension_override( struct gl_context *ctx )
663 {
664 const char *env_const = _mesa_getenv("MESA_EXTENSION_OVERRIDE");
665 char *env;
666 char *ext;
667 char *extra_exts;
668 int len;
669
670 if (env_const == NULL) {
671 /* Return the empty string rather than NULL. This simplifies the logic
672 * of client functions. */
673 return calloc(4, sizeof(char));
674 }
675
676 /* extra_exts: List of unrecognized extensions. */
677 extra_exts = calloc(ALIGN(strlen(env_const) + 2, 4), sizeof(char));
678
679 /* Copy env_const because strtok() is destructive. */
680 env = strdup(env_const);
681 for (ext = strtok(env, " "); ext != NULL; ext = strtok(NULL, " ")) {
682 int enable;
683 int recognized;
684 switch (ext[0]) {
685 case '+':
686 enable = 1;
687 ++ext;
688 break;
689 case '-':
690 enable = 0;
691 ++ext;
692 break;
693 default:
694 enable = 1;
695 break;
696 }
697 recognized = set_extension(ctx, ext, enable);
698 if (!recognized) {
699 strcat(extra_exts, ext);
700 strcat(extra_exts, " ");
701 }
702 }
703
704 free(env);
705
706 /* Remove trailing space. */
707 len = strlen(extra_exts);
708 if (extra_exts[len - 1] == ' ')
709 extra_exts[len - 1] = '\0';
710
711 return extra_exts;
712 }
713
714
715 /**
716 * \brief Initialize extension tables and enable default extensions.
717 *
718 * This should be called during context initialization.
719 * Note: Sets gl_extensions.dummy_true to true.
720 */
721 void
722 _mesa_init_extensions( struct gl_context *ctx )
723 {
724 GLboolean *base = (GLboolean *) &ctx->Extensions;
725 GLboolean *sentinel = base + o(extension_sentinel);
726 GLboolean *i;
727 const size_t *j;
728
729 /* First, turn all extensions off. */
730 for (i = base; i != sentinel; ++i)
731 *i = GL_FALSE;
732
733 /* Then, selectively turn default extensions on. */
734 ctx->Extensions.dummy_true = GL_TRUE;
735 for (j = default_extensions; *j != 0; ++j)
736 base[*j] = GL_TRUE;
737 }
738
739
740 typedef unsigned short extension_index;
741
742
743 /**
744 * Compare two entries of the extensions table. Sorts first by year,
745 * then by name.
746 *
747 * Arguments are indices into extension_table.
748 */
749 static int
750 extension_compare(const void *p1, const void *p2)
751 {
752 extension_index i1 = * (const extension_index *) p1;
753 extension_index i2 = * (const extension_index *) p2;
754 const struct extension *e1 = &extension_table[i1];
755 const struct extension *e2 = &extension_table[i2];
756 int res;
757
758 res = (int)e1->year - (int)e2->year;
759
760 if (res == 0) {
761 res = strcmp(e1->name, e2->name);
762 }
763
764 return res;
765 }
766
767
768 /**
769 * Construct the GL_EXTENSIONS string. Called the first time that
770 * glGetString(GL_EXTENSIONS) is called.
771 */
772 GLubyte*
773 _mesa_make_extension_string(struct gl_context *ctx)
774 {
775 /* The extension string. */
776 char *exts = 0;
777 /* Length of extension string. */
778 size_t length = 0;
779 /* Number of extensions */
780 unsigned count;
781 /* Indices of the extensions sorted by year */
782 extension_index *extension_indices;
783 /* String of extra extensions. */
784 char *extra_extensions = get_extension_override(ctx);
785 GLboolean *base = (GLboolean *) &ctx->Extensions;
786 const struct extension *i;
787 unsigned j;
788 unsigned maxYear = ~0;
789
790 /* Check if the MESA_EXTENSION_MAX_YEAR env var is set */
791 {
792 const char *env = getenv("MESA_EXTENSION_MAX_YEAR");
793 if (env) {
794 maxYear = atoi(env);
795 _mesa_debug(ctx, "Note: limiting GL extensions to %u or earlier\n",
796 maxYear);
797 }
798 }
799
800 /* Compute length of the extension string. */
801 count = 0;
802 for (i = extension_table; i->name != 0; ++i) {
803 if (base[i->offset] &&
804 i->year <= maxYear &&
805 (i->api_set & (1 << ctx->API))) {
806 length += strlen(i->name) + 1; /* +1 for space */
807 ++count;
808 }
809 }
810 if (extra_extensions != NULL)
811 length += 1 + strlen(extra_extensions); /* +1 for space */
812
813 exts = (char *) calloc(ALIGN(length + 1, 4), sizeof(char));
814 if (exts == NULL) {
815 free(extra_extensions);
816 return NULL;
817 }
818
819 extension_indices = malloc(count * sizeof(extension_index));
820 if (extension_indices == NULL) {
821 free(exts);
822 free(extra_extensions);
823 return NULL;
824 }
825
826 /* Sort extensions in chronological order because certain old applications (e.g.,
827 * Quake3 demo) store the extension list in a static size buffer so chronologically
828 * order ensure that the extensions that such applications expect will fit into
829 * that buffer.
830 */
831 j = 0;
832 for (i = extension_table; i->name != 0; ++i) {
833 if (base[i->offset] &&
834 i->year <= maxYear &&
835 (i->api_set & (1 << ctx->API))) {
836 extension_indices[j++] = i - extension_table;
837 }
838 }
839 assert(j == count);
840 qsort(extension_indices, count, sizeof *extension_indices, extension_compare);
841
842 /* Build the extension string.*/
843 for (j = 0; j < count; ++j) {
844 i = &extension_table[extension_indices[j]];
845 assert(base[i->offset] && (i->api_set & (1 << ctx->API)));
846 strcat(exts, i->name);
847 strcat(exts, " ");
848 }
849 free(extension_indices);
850 if (extra_extensions != 0) {
851 strcat(exts, extra_extensions);
852 free(extra_extensions);
853 }
854
855 return (GLubyte *) exts;
856 }
857
858 /**
859 * Return number of enabled extensions.
860 */
861 GLuint
862 _mesa_get_extension_count(struct gl_context *ctx)
863 {
864 GLboolean *base;
865 const struct extension *i;
866
867 /* only count once */
868 if (ctx->Extensions.Count != 0)
869 return ctx->Extensions.Count;
870
871 base = (GLboolean *) &ctx->Extensions;
872 for (i = extension_table; i->name != 0; ++i) {
873 if (base[i->offset]) {
874 ctx->Extensions.Count++;
875 }
876 }
877 return ctx->Extensions.Count;
878 }
879
880 /**
881 * Return name of i-th enabled extension
882 */
883 const GLubyte *
884 _mesa_get_enabled_extension(struct gl_context *ctx, GLuint index)
885 {
886 const GLboolean *base;
887 size_t n;
888 const struct extension *i;
889
890 if (index < 0)
891 return NULL;
892
893 base = (GLboolean*) &ctx->Extensions;
894 n = 0;
895 for (i = extension_table; i->name != 0; ++i) {
896 if (n == index && base[i->offset]) {
897 return (GLubyte*) i->name;
898 } else if (base[i->offset]) {
899 ++n;
900 }
901 }
902
903 return NULL;
904 }