2 * Mesa 3-D graphics library
5 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
6 * Copyright (C) 2009 VMware, Inc. All Rights Reserved.
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:
15 * The above copyright notice and this permission notice shall be included
16 * in all copies or substantial portions of the Software.
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.
29 * \brief Extension handling
36 #include "extensions.h"
37 #include "mfeatures.h"
40 #define ALIGN(value, alignment) (((value) + alignment - 1) & ~(alignment - 1))
44 GLL
= 1 << API_OPENGL
, /* GL Legacy / Compatibility */
45 GLC
= 1 << API_OPENGL_CORE
, /* GL Core */
46 GL
= (1 << API_OPENGL
) | (1 << API_OPENGL_CORE
),
47 ES1
= 1 << API_OPENGLES
,
48 ES2
= 1 << API_OPENGLES2
,
52 * \brief An element of the \c extension_table.
55 /** Name of extension, such as "GL_ARB_depth_clamp". */
58 /** Offset (in bytes) of the corresponding member in struct gl_extensions. */
61 /** Set of API's in which the extension exists, as a bitset. */
64 /** Year the extension was proposed or approved. Used to sort the
65 * extension string chronologically. */
71 * Given a member \c x of struct gl_extensions, return offset of
74 #define o(x) offsetof(struct gl_extensions, x)
78 * \brief Table of supported OpenGL extensions for all API's.
80 static const struct extension extension_table
[] = {
82 { "GL_ARB_ES2_compatibility", o(ARB_ES2_compatibility
), GL
, 2009 },
83 { "GL_ARB_base_instance", o(ARB_base_instance
), GL
, 2011 },
84 { "GL_ARB_blend_func_extended", o(ARB_blend_func_extended
), GL
, 2009 },
85 { "GL_ARB_color_buffer_float", o(ARB_color_buffer_float
), GL
, 2004 },
86 { "GL_ARB_copy_buffer", o(dummy_true
), GL
, 2008 },
87 { "GL_ARB_conservative_depth", o(ARB_conservative_depth
), GL
, 2011 },
88 { "GL_ARB_debug_output", o(dummy_true
), GL
, 2009 },
89 { "GL_ARB_depth_buffer_float", o(ARB_depth_buffer_float
), GL
, 2008 },
90 { "GL_ARB_depth_clamp", o(ARB_depth_clamp
), GL
, 2003 },
91 { "GL_ARB_depth_texture", o(ARB_depth_texture
), GLL
, 2001 },
92 { "GL_ARB_draw_buffers", o(dummy_true
), GL
, 2002 },
93 { "GL_ARB_draw_buffers_blend", o(ARB_draw_buffers_blend
), GL
, 2009 },
94 { "GL_ARB_draw_elements_base_vertex", o(ARB_draw_elements_base_vertex
), GL
, 2009 },
95 { "GL_ARB_draw_instanced", o(ARB_draw_instanced
), GL
, 2008 },
96 { "GL_ARB_explicit_attrib_location", o(ARB_explicit_attrib_location
), GL
, 2009 },
97 { "GL_ARB_fragment_coord_conventions", o(ARB_fragment_coord_conventions
), GL
, 2009 },
98 { "GL_ARB_fragment_program", o(ARB_fragment_program
), GLL
, 2002 },
99 { "GL_ARB_fragment_program_shadow", o(ARB_fragment_program_shadow
), GLL
, 2003 },
100 { "GL_ARB_fragment_shader", o(ARB_fragment_shader
), GL
, 2002 },
101 { "GL_ARB_framebuffer_object", o(ARB_framebuffer_object
), GL
, 2005 },
102 { "GL_ARB_framebuffer_sRGB", o(EXT_framebuffer_sRGB
), GL
, 1998 },
103 { "GL_ARB_half_float_pixel", o(ARB_half_float_pixel
), GL
, 2003 },
104 { "GL_ARB_half_float_vertex", o(ARB_half_float_vertex
), GL
, 2008 },
105 { "GL_ARB_instanced_arrays", o(ARB_instanced_arrays
), GL
, 2008 },
106 { "GL_ARB_invalidate_subdata", o(dummy_true
), GL
, 2012 },
107 { "GL_ARB_map_buffer_alignment", o(ARB_map_buffer_alignment
), GL
, 2011 },
108 { "GL_ARB_map_buffer_range", o(ARB_map_buffer_range
), GL
, 2008 },
109 { "GL_ARB_multisample", o(dummy_true
), GLL
, 1994 },
110 { "GL_ARB_multitexture", o(dummy_true
), GLL
, 1998 },
111 { "GL_ARB_occlusion_query2", o(ARB_occlusion_query2
), GL
, 2003 },
112 { "GL_ARB_occlusion_query", o(ARB_occlusion_query
), GLL
, 2001 },
113 { "GL_ARB_pixel_buffer_object", o(EXT_pixel_buffer_object
), GL
, 2004 },
114 { "GL_ARB_point_parameters", o(EXT_point_parameters
), GLL
, 1997 },
115 { "GL_ARB_point_sprite", o(ARB_point_sprite
), GL
, 2003 },
116 { "GL_ARB_provoking_vertex", o(EXT_provoking_vertex
), GL
, 2009 },
117 { "GL_ARB_robustness", o(dummy_true
), GL
, 2010 },
118 { "GL_ARB_sampler_objects", o(dummy_true
), GL
, 2009 },
119 { "GL_ARB_seamless_cube_map", o(ARB_seamless_cube_map
), GL
, 2009 },
120 { "GL_ARB_shader_bit_encoding", o(ARB_shader_bit_encoding
), GL
, 2010 },
121 { "GL_ARB_shader_objects", o(ARB_shader_objects
), GL
, 2002 },
122 { "GL_ARB_shader_stencil_export", o(ARB_shader_stencil_export
), GL
, 2009 },
123 { "GL_ARB_shader_texture_lod", o(ARB_shader_texture_lod
), GL
, 2009 },
124 { "GL_ARB_shading_language_100", o(ARB_shading_language_100
), GLL
, 2003 },
125 { "GL_ARB_shadow", o(ARB_shadow
), GLL
, 2001 },
126 { "GL_ARB_sync", o(ARB_sync
), GL
, 2003 },
127 { "GL_ARB_texture_border_clamp", o(ARB_texture_border_clamp
), GLL
, 2000 },
128 { "GL_ARB_texture_buffer_object", o(ARB_texture_buffer_object
), GL
, 2008 },
129 { "GL_ARB_texture_compression", o(dummy_true
), GLL
, 2000 },
130 { "GL_ARB_texture_compression_rgtc", o(ARB_texture_compression_rgtc
), GL
, 2004 },
131 { "GL_ARB_texture_cube_map", o(ARB_texture_cube_map
), GLL
, 1999 },
132 { "GL_ARB_texture_env_add", o(dummy_true
), GLL
, 1999 },
133 { "GL_ARB_texture_env_combine", o(ARB_texture_env_combine
), GLL
, 2001 },
134 { "GL_ARB_texture_env_crossbar", o(ARB_texture_env_crossbar
), GLL
, 2001 },
135 { "GL_ARB_texture_env_dot3", o(ARB_texture_env_dot3
), GLL
, 2001 },
136 { "GL_ARB_texture_float", o(ARB_texture_float
), GL
, 2004 },
137 { "GL_ARB_texture_mirrored_repeat", o(dummy_true
), GLL
, 2001 },
138 { "GL_ARB_texture_multisample", o(ARB_texture_multisample
), GL
, 2009 },
139 { "GL_ARB_texture_non_power_of_two", o(ARB_texture_non_power_of_two
), GL
, 2003 },
140 { "GL_ARB_texture_rectangle", o(NV_texture_rectangle
), GL
, 2004 },
141 { "GL_ARB_texture_rgb10_a2ui", o(ARB_texture_rgb10_a2ui
), GL
, 2009 },
142 { "GL_ARB_texture_rg", o(ARB_texture_rg
), GL
, 2008 },
143 { "GL_ARB_texture_storage", o(ARB_texture_storage
), GL
, 2011 },
144 { "GL_ARB_texture_swizzle", o(EXT_texture_swizzle
), GL
, 2008 },
145 { "GL_ARB_timer_query", o(ARB_timer_query
), GL
, 2010 },
146 { "GL_ARB_transform_feedback2", o(ARB_transform_feedback2
), GL
, 2010 },
147 { "GL_ARB_transform_feedback3", o(ARB_transform_feedback3
), GL
, 2010 },
148 { "GL_ARB_transform_feedback_instanced", o(ARB_transform_feedback_instanced
), GL
, 2011 },
149 { "GL_ARB_transpose_matrix", o(dummy_true
), GLL
, 1999 },
150 { "GL_ARB_uniform_buffer_object", o(ARB_uniform_buffer_object
), GL
, 2009 },
151 { "GL_ARB_vertex_array_bgra", o(EXT_vertex_array_bgra
), GL
, 2008 },
152 { "GL_ARB_vertex_array_object", o(dummy_true
), GL
, 2006 },
153 { "GL_ARB_vertex_buffer_object", o(dummy_true
), GLL
, 2003 },
154 { "GL_ARB_vertex_program", o(ARB_vertex_program
), GLL
, 2002 },
155 { "GL_ARB_vertex_shader", o(ARB_vertex_shader
), GL
, 2002 },
156 { "GL_ARB_vertex_type_2_10_10_10_rev", o(ARB_vertex_type_2_10_10_10_rev
), GL
, 2009 },
157 { "GL_ARB_window_pos", o(dummy_true
), GLL
, 2001 },
159 { "GL_EXT_abgr", o(dummy_true
), GL
, 1995 },
160 { "GL_EXT_bgra", o(dummy_true
), GLL
, 1995 },
161 { "GL_EXT_blend_color", o(EXT_blend_color
), GLL
, 1995 },
162 { "GL_EXT_blend_equation_separate", o(EXT_blend_equation_separate
), GL
, 2003 },
163 { "GL_EXT_blend_func_separate", o(EXT_blend_func_separate
), GLL
, 1999 },
164 { "GL_EXT_blend_minmax", o(EXT_blend_minmax
), GLL
| ES1
| ES2
, 1995 },
165 { "GL_EXT_blend_subtract", o(dummy_true
), GLL
, 1995 },
166 { "GL_EXT_clip_volume_hint", o(EXT_clip_volume_hint
), GL
, 1996 },
167 { "GL_EXT_compiled_vertex_array", o(dummy_true
), GLL
, 1996 },
168 { "GL_EXT_copy_texture", o(dummy_true
), GLL
, 1995 },
169 { "GL_EXT_depth_bounds_test", o(EXT_depth_bounds_test
), GL
, 2002 },
170 { "GL_EXT_draw_buffers2", o(EXT_draw_buffers2
), GL
, 2006 },
171 { "GL_EXT_draw_instanced", o(ARB_draw_instanced
), GL
, 2006 },
172 { "GL_EXT_draw_range_elements", o(dummy_true
), GLL
, 1997 },
173 { "GL_EXT_fog_coord", o(EXT_fog_coord
), GLL
, 1999 },
174 { "GL_EXT_framebuffer_blit", o(EXT_framebuffer_blit
), GL
, 2005 },
175 { "GL_EXT_framebuffer_multisample", o(EXT_framebuffer_multisample
), GL
, 2005 },
176 { "GL_EXT_framebuffer_object", o(EXT_framebuffer_object
), GL
, 2000 },
177 { "GL_EXT_framebuffer_sRGB", o(EXT_framebuffer_sRGB
), GL
, 1998 },
178 { "GL_EXT_gpu_program_parameters", o(EXT_gpu_program_parameters
), GLL
, 2006 },
179 { "GL_EXT_gpu_shader4", o(EXT_gpu_shader4
), GL
, 2006 },
180 { "GL_EXT_map_buffer_range", o(ARB_map_buffer_range
), ES1
| ES2
, 2012 },
181 { "GL_EXT_multi_draw_arrays", o(dummy_true
), GLL
| ES1
| ES2
, 1999 },
182 { "GL_EXT_packed_depth_stencil", o(EXT_packed_depth_stencil
), GL
, 2005 },
183 { "GL_EXT_packed_float", o(EXT_packed_float
), GL
, 2004 },
184 { "GL_EXT_packed_pixels", o(dummy_true
), GLL
, 1997 },
185 { "GL_EXT_pixel_buffer_object", o(EXT_pixel_buffer_object
), GL
, 2004 },
186 { "GL_EXT_point_parameters", o(EXT_point_parameters
), GLL
, 1997 },
187 { "GL_EXT_polygon_offset", o(dummy_true
), GLL
, 1995 },
188 { "GL_EXT_provoking_vertex", o(EXT_provoking_vertex
), GL
, 2009 },
189 { "GL_EXT_rescale_normal", o(EXT_rescale_normal
), GLL
, 1997 },
190 { "GL_EXT_secondary_color", o(EXT_secondary_color
), GLL
, 1999 },
191 { "GL_EXT_separate_shader_objects", o(EXT_separate_shader_objects
), GLL
, 2008 },
192 { "GL_EXT_separate_specular_color", o(EXT_separate_specular_color
), GLL
, 1997 },
193 { "GL_EXT_shadow_funcs", o(EXT_shadow_funcs
), GLL
, 2002 },
194 { "GL_EXT_stencil_two_side", o(EXT_stencil_two_side
), GLL
, 2001 },
195 { "GL_EXT_stencil_wrap", o(dummy_true
), GLL
, 2002 },
196 { "GL_EXT_subtexture", o(dummy_true
), GLL
, 1995 },
197 { "GL_EXT_texture3D", o(EXT_texture3D
), GLL
, 1996 },
198 { "GL_EXT_texture_array", o(EXT_texture_array
), GL
, 2006 },
199 { "GL_EXT_texture_compression_dxt1", o(EXT_texture_compression_s3tc
), GL
| ES1
| ES2
, 2004 },
200 { "GL_ANGLE_texture_compression_dxt3", o(ANGLE_texture_compression_dxt
), ES2
, 2011 },
201 { "GL_ANGLE_texture_compression_dxt5", o(ANGLE_texture_compression_dxt
), ES2
, 2011 },
202 { "GL_EXT_texture_compression_latc", o(EXT_texture_compression_latc
), GL
, 2006 },
203 { "GL_EXT_texture_compression_rgtc", o(ARB_texture_compression_rgtc
), GL
, 2004 },
204 { "GL_EXT_texture_compression_s3tc", o(EXT_texture_compression_s3tc
), GL
, 2000 },
205 { "GL_EXT_texture_cube_map", o(ARB_texture_cube_map
), GLL
, 2001 },
206 { "GL_EXT_texture_edge_clamp", o(dummy_true
), GLL
, 1997 },
207 { "GL_EXT_texture_env_add", o(dummy_true
), GLL
, 1999 },
208 { "GL_EXT_texture_env_combine", o(dummy_true
), GLL
, 2000 },
209 { "GL_EXT_texture_env_dot3", o(EXT_texture_env_dot3
), GLL
, 2000 },
210 { "GL_EXT_texture_filter_anisotropic", o(EXT_texture_filter_anisotropic
), GL
| ES1
| ES2
, 1999 },
211 { "GL_EXT_texture_format_BGRA8888", o(dummy_true
), ES1
| ES2
, 2005 },
212 { "GL_EXT_texture_rg", o(ARB_texture_rg
), ES2
, 2011 },
213 { "GL_EXT_read_format_bgra", o(dummy_true
), ES1
| ES2
, 2009 },
214 { "GL_EXT_texture_integer", o(EXT_texture_integer
), GL
, 2006 },
215 { "GL_EXT_texture_lod_bias", o(dummy_true
), GLL
| ES1
, 1999 },
216 { "GL_EXT_texture_mirror_clamp", o(EXT_texture_mirror_clamp
), GL
, 2004 },
217 { "GL_EXT_texture_object", o(dummy_true
), GLL
, 1995 },
218 { "GL_EXT_texture", o(dummy_true
), GLL
, 1996 },
219 { "GL_EXT_texture_rectangle", o(NV_texture_rectangle
), GLL
, 2004 },
220 { "GL_EXT_texture_shared_exponent", o(EXT_texture_shared_exponent
), GL
, 2004 },
221 { "GL_EXT_texture_snorm", o(EXT_texture_snorm
), GL
, 2009 },
222 { "GL_EXT_texture_sRGB", o(EXT_texture_sRGB
), GL
, 2004 },
223 { "GL_EXT_texture_sRGB_decode", o(EXT_texture_sRGB_decode
), GL
, 2006 },
224 { "GL_EXT_texture_swizzle", o(EXT_texture_swizzle
), GL
, 2008 },
225 { "GL_EXT_texture_type_2_10_10_10_REV", o(dummy_true
), ES2
, 2008 },
226 { "GL_EXT_timer_query", o(EXT_timer_query
), GL
, 2006 },
227 { "GL_EXT_transform_feedback", o(EXT_transform_feedback
), GL
, 2011 },
228 { "GL_EXT_unpack_subimage", o(dummy_true
), ES2
, 2011 },
229 { "GL_EXT_vertex_array_bgra", o(EXT_vertex_array_bgra
), GL
, 2008 },
230 { "GL_EXT_vertex_array", o(dummy_true
), GLL
, 1995 },
233 { "GL_OES_blend_equation_separate", o(EXT_blend_equation_separate
), ES1
, 2009 },
234 { "GL_OES_blend_func_separate", o(EXT_blend_func_separate
), ES1
, 2009 },
235 { "GL_OES_blend_subtract", o(dummy_true
), ES1
, 2009 },
236 { "GL_OES_byte_coordinates", o(dummy_true
), ES1
, 2002 },
237 { "GL_OES_compressed_ETC1_RGB8_texture", o(OES_compressed_ETC1_RGB8_texture
), ES1
| ES2
, 2005 },
238 { "GL_OES_compressed_paletted_texture", o(dummy_true
), ES1
, 2003 },
239 { "GL_OES_depth24", o(EXT_framebuffer_object
), ES1
| ES2
, 2005 },
240 { "GL_OES_depth32", o(dummy_false
), DISABLE
, 2005 },
241 { "GL_OES_depth_texture", o(ARB_depth_texture
), ES2
, 2006 },
242 { "GL_OES_draw_texture", o(OES_draw_texture
), ES1
, 2004 },
243 /* FIXME: Mesa expects GL_OES_EGL_image to be available in OpenGL contexts. */
244 { "GL_OES_EGL_image", o(OES_EGL_image
), GL
| ES1
| ES2
, 2006 },
245 { "GL_OES_EGL_image_external", o(OES_EGL_image_external
), ES1
| ES2
, 2010 },
246 { "GL_OES_element_index_uint", o(dummy_true
), ES1
| ES2
, 2005 },
247 { "GL_OES_fbo_render_mipmap", o(EXT_framebuffer_object
), ES1
| ES2
, 2005 },
248 { "GL_OES_fixed_point", o(dummy_true
), ES1
, 2002 },
249 { "GL_OES_framebuffer_object", o(EXT_framebuffer_object
), ES1
, 2005 },
250 { "GL_OES_mapbuffer", o(dummy_true
), ES1
| ES2
, 2005 },
251 { "GL_OES_matrix_get", o(dummy_true
), ES1
, 2004 },
252 { "GL_OES_packed_depth_stencil", o(EXT_packed_depth_stencil
), ES1
| ES2
, 2007 },
253 { "GL_OES_point_size_array", o(dummy_true
), ES1
, 2004 },
254 { "GL_OES_point_sprite", o(ARB_point_sprite
), ES1
, 2004 },
255 { "GL_OES_query_matrix", o(dummy_true
), ES1
, 2003 },
256 { "GL_OES_read_format", o(dummy_true
), GL
| ES1
, 2003 },
257 { "GL_OES_rgb8_rgba8", o(EXT_framebuffer_object
), ES1
| ES2
, 2005 },
258 { "GL_OES_single_precision", o(dummy_true
), ES1
, 2003 },
259 { "GL_OES_standard_derivatives", o(OES_standard_derivatives
), ES2
, 2005 },
260 { "GL_OES_stencil1", o(dummy_false
), DISABLE
, 2005 },
261 { "GL_OES_stencil4", o(dummy_false
), DISABLE
, 2005 },
262 { "GL_OES_stencil8", o(EXT_framebuffer_object
), ES1
| ES2
, 2005 },
263 { "GL_OES_stencil_wrap", o(dummy_true
), ES1
, 2002 },
264 { "GL_OES_texture_3D", o(EXT_texture3D
), ES2
, 2005 },
265 { "GL_OES_texture_cube_map", o(ARB_texture_cube_map
), ES1
, 2007 },
266 { "GL_OES_texture_env_crossbar", o(ARB_texture_env_crossbar
), ES1
, 2005 },
267 { "GL_OES_texture_mirrored_repeat", o(dummy_true
), ES1
, 2005 },
268 { "GL_OES_texture_npot", o(ARB_texture_non_power_of_two
), ES2
, 2005 },
269 { "GL_OES_vertex_array_object", o(dummy_true
), ES1
| ES2
, 2010 },
271 /* Vendor extensions */
272 { "GL_3DFX_texture_compression_FXT1", o(TDFX_texture_compression_FXT1
), GL
, 1999 },
273 { "GL_AMD_conservative_depth", o(ARB_conservative_depth
), GL
, 2009 },
274 { "GL_AMD_draw_buffers_blend", o(ARB_draw_buffers_blend
), GL
, 2009 },
275 { "GL_AMD_seamless_cubemap_per_texture", o(AMD_seamless_cubemap_per_texture
), GL
, 2009 },
276 { "GL_AMD_shader_stencil_export", o(ARB_shader_stencil_export
), GL
, 2009 },
277 { "GL_APPLE_object_purgeable", o(APPLE_object_purgeable
), GL
, 2006 },
278 { "GL_APPLE_packed_pixels", o(APPLE_packed_pixels
), GLL
, 2002 },
279 { "GL_APPLE_texture_max_level", o(dummy_true
), ES1
| ES2
, 2009 },
280 { "GL_APPLE_vertex_array_object", o(dummy_true
), GLL
, 2002 },
281 { "GL_ATI_blend_equation_separate", o(EXT_blend_equation_separate
), GL
, 2003 },
282 { "GL_ATI_draw_buffers", o(dummy_true
), GLL
, 2002 },
283 { "GL_ATI_envmap_bumpmap", o(ATI_envmap_bumpmap
), GLL
, 2001 },
284 { "GL_ATI_fragment_shader", o(ATI_fragment_shader
), GLL
, 2001 },
285 { "GL_ATI_separate_stencil", o(ATI_separate_stencil
), GLL
, 2006 },
286 { "GL_ATI_texture_compression_3dc", o(ATI_texture_compression_3dc
), GL
, 2004 },
287 { "GL_ATI_texture_env_combine3", o(ATI_texture_env_combine3
), GLL
, 2002 },
288 { "GL_ATI_texture_float", o(ARB_texture_float
), GL
, 2002 },
289 { "GL_ATI_texture_mirror_once", o(ATI_texture_mirror_once
), GL
, 2006 },
290 { "GL_IBM_multimode_draw_arrays", o(IBM_multimode_draw_arrays
), GL
, 1998 },
291 { "GL_IBM_rasterpos_clip", o(IBM_rasterpos_clip
), GL
, 1996 },
292 { "GL_IBM_texture_mirrored_repeat", o(dummy_true
), GLL
, 1998 },
293 { "GL_INGR_blend_func_separate", o(EXT_blend_func_separate
), GLL
, 1999 },
294 { "GL_MESA_pack_invert", o(MESA_pack_invert
), GL
, 2002 },
295 { "GL_MESA_resize_buffers", o(MESA_resize_buffers
), GL
, 1999 },
296 { "GL_MESA_texture_array", o(MESA_texture_array
), GLL
, 2007 },
297 { "GL_MESA_texture_signed_rgba", o(EXT_texture_snorm
), GL
, 2009 },
298 { "GL_MESA_window_pos", o(dummy_true
), GLL
, 2000 },
299 { "GL_MESA_ycbcr_texture", o(MESA_ycbcr_texture
), GL
, 2002 },
300 { "GL_NV_blend_square", o(NV_blend_square
), GLL
, 1999 },
301 { "GL_NV_conditional_render", o(NV_conditional_render
), GL
, 2008 },
302 { "GL_NV_depth_clamp", o(ARB_depth_clamp
), GL
, 2001 },
303 { "GL_NV_draw_buffers", o(dummy_true
), ES2
, 2011 },
304 { "GL_NV_fbo_color_attachments", o(EXT_framebuffer_object
), ES2
, 2010 },
305 { "GL_NV_fog_distance", o(NV_fog_distance
), GLL
, 2001 },
306 { "GL_NV_fragment_program_option", o(NV_fragment_program_option
), GLL
, 2005 },
307 { "GL_NV_light_max_exponent", o(NV_light_max_exponent
), GLL
, 1999 },
308 { "GL_NV_packed_depth_stencil", o(EXT_packed_depth_stencil
), GL
, 2000 },
309 { "GL_NV_point_sprite", o(NV_point_sprite
), GL
, 2001 },
310 { "GL_NV_primitive_restart", o(NV_primitive_restart
), GL
, 2002 },
311 { "GL_NV_read_buffer", o(dummy_true
), ES2
, 2011 },
312 { "GL_NV_texgen_reflection", o(NV_texgen_reflection
), GLL
, 1999 },
313 { "GL_NV_texture_barrier", o(NV_texture_barrier
), GL
, 2009 },
314 { "GL_NV_texture_env_combine4", o(NV_texture_env_combine4
), GLL
, 1999 },
315 { "GL_NV_texture_rectangle", o(NV_texture_rectangle
), GLL
, 2000 },
316 { "GL_S3_s3tc", o(S3_s3tc
), GL
, 1999 },
317 { "GL_SGIS_generate_mipmap", o(dummy_true
), GLL
, 1997 },
318 { "GL_SGIS_texture_border_clamp", o(ARB_texture_border_clamp
), GLL
, 1997 },
319 { "GL_SGIS_texture_edge_clamp", o(dummy_true
), GLL
, 1997 },
320 { "GL_SGIS_texture_lod", o(SGIS_texture_lod
), GLL
, 1997 },
321 { "GL_SUN_multi_draw_arrays", o(dummy_true
), GLL
, 1999 },
328 * Given an extension name, lookup up the corresponding member of struct
329 * gl_extensions and return that member's offset (in bytes). If the name is
330 * not found in the \c extension_table, return 0.
332 * \param name Name of extension.
333 * \return Offset of member in struct gl_extensions.
336 name_to_offset(const char* name
)
338 const struct extension
*i
;
343 for (i
= extension_table
; i
->name
!= 0; ++i
) {
344 if (strcmp(name
, i
->name
) == 0)
353 * \brief Extensions enabled by default.
355 * These extensions are enabled by _mesa_init_extensions().
357 * XXX: Should these defaults also apply to GLES?
359 static const size_t default_extensions
[] = {
360 o(EXT_rescale_normal
),
361 o(EXT_separate_specular_color
),
364 o(OES_standard_derivatives
),
366 /* Vendor Extensions */
367 o(APPLE_packed_pixels
),
368 o(IBM_multimode_draw_arrays
),
369 o(IBM_rasterpos_clip
),
370 o(NV_light_max_exponent
),
371 o(NV_texgen_reflection
),
379 * Enable all extensions suitable for a software-only renderer.
380 * This is a convenience function used by the XMesa, OSMesa, GGI drivers, etc.
383 _mesa_enable_sw_extensions(struct gl_context
*ctx
)
385 ctx
->Extensions
.ARB_depth_clamp
= GL_TRUE
;
386 ctx
->Extensions
.ARB_depth_texture
= GL_TRUE
;
387 ctx
->Extensions
.ARB_draw_elements_base_vertex
= GL_TRUE
;
388 ctx
->Extensions
.ARB_draw_instanced
= GL_TRUE
;
389 ctx
->Extensions
.ARB_explicit_attrib_location
= GL_TRUE
;
390 ctx
->Extensions
.ARB_fragment_coord_conventions
= GL_TRUE
;
391 ctx
->Extensions
.ARB_fragment_program
= GL_TRUE
;
392 ctx
->Extensions
.ARB_fragment_program_shadow
= GL_TRUE
;
393 ctx
->Extensions
.ARB_fragment_shader
= GL_TRUE
;
394 ctx
->Extensions
.ARB_framebuffer_object
= GL_TRUE
;
395 /* XXX re-enable when GLSL compiler again supports geometry shaders */
397 ctx
->Extensions
.ARB_geometry_shader4
= GL_TRUE
;
399 ctx
->Extensions
.ARB_half_float_pixel
= GL_TRUE
;
400 ctx
->Extensions
.ARB_half_float_vertex
= GL_TRUE
;
401 ctx
->Extensions
.ARB_map_buffer_range
= GL_TRUE
;
402 ctx
->Extensions
.ARB_occlusion_query
= GL_TRUE
;
403 ctx
->Extensions
.ARB_occlusion_query2
= GL_TRUE
;
404 ctx
->Extensions
.ARB_point_sprite
= GL_TRUE
;
405 ctx
->Extensions
.ARB_shader_objects
= GL_TRUE
;
406 ctx
->Extensions
.EXT_separate_shader_objects
= GL_TRUE
;
407 ctx
->Extensions
.ARB_shading_language_100
= GL_TRUE
;
408 ctx
->Extensions
.ARB_shadow
= GL_TRUE
;
409 ctx
->Extensions
.ARB_texture_border_clamp
= GL_TRUE
;
410 ctx
->Extensions
.ARB_texture_cube_map
= GL_TRUE
;
411 ctx
->Extensions
.ARB_texture_env_combine
= GL_TRUE
;
412 ctx
->Extensions
.ARB_texture_env_crossbar
= GL_TRUE
;
413 ctx
->Extensions
.ARB_texture_env_dot3
= GL_TRUE
;
414 /*ctx->Extensions.ARB_texture_float = GL_TRUE;*/
415 ctx
->Extensions
.ARB_texture_non_power_of_two
= GL_TRUE
;
416 ctx
->Extensions
.ARB_texture_rg
= GL_TRUE
;
417 ctx
->Extensions
.ARB_texture_compression_rgtc
= GL_TRUE
;
418 ctx
->Extensions
.ARB_texture_storage
= GL_TRUE
;
419 ctx
->Extensions
.ARB_vertex_program
= GL_TRUE
;
420 ctx
->Extensions
.ARB_vertex_shader
= GL_TRUE
;
421 ctx
->Extensions
.ARB_sync
= GL_TRUE
;
422 ctx
->Extensions
.APPLE_object_purgeable
= GL_TRUE
;
423 ctx
->Extensions
.ATI_envmap_bumpmap
= GL_TRUE
;
424 ctx
->Extensions
.ATI_fragment_shader
= GL_TRUE
;
425 ctx
->Extensions
.ATI_texture_compression_3dc
= GL_TRUE
;
426 ctx
->Extensions
.ATI_texture_env_combine3
= GL_TRUE
;
427 ctx
->Extensions
.ATI_texture_mirror_once
= GL_TRUE
;
428 ctx
->Extensions
.ATI_separate_stencil
= GL_TRUE
;
429 ctx
->Extensions
.EXT_blend_color
= GL_TRUE
;
430 ctx
->Extensions
.EXT_blend_equation_separate
= GL_TRUE
;
431 ctx
->Extensions
.EXT_blend_func_separate
= GL_TRUE
;
432 ctx
->Extensions
.EXT_blend_minmax
= GL_TRUE
;
433 ctx
->Extensions
.EXT_depth_bounds_test
= GL_TRUE
;
434 ctx
->Extensions
.EXT_draw_buffers2
= GL_TRUE
;
435 ctx
->Extensions
.EXT_fog_coord
= GL_TRUE
;
436 ctx
->Extensions
.EXT_framebuffer_object
= GL_TRUE
;
437 ctx
->Extensions
.EXT_framebuffer_blit
= GL_TRUE
;
438 ctx
->Extensions
.EXT_framebuffer_multisample
= GL_TRUE
;
439 ctx
->Extensions
.EXT_packed_depth_stencil
= GL_TRUE
;
440 ctx
->Extensions
.EXT_pixel_buffer_object
= GL_TRUE
;
441 ctx
->Extensions
.EXT_point_parameters
= GL_TRUE
;
442 ctx
->Extensions
.EXT_provoking_vertex
= GL_TRUE
;
443 ctx
->Extensions
.EXT_shadow_funcs
= GL_TRUE
;
444 ctx
->Extensions
.EXT_secondary_color
= GL_TRUE
;
445 ctx
->Extensions
.EXT_stencil_two_side
= GL_TRUE
;
446 ctx
->Extensions
.EXT_texture_array
= GL_TRUE
;
447 ctx
->Extensions
.EXT_texture_compression_latc
= GL_TRUE
;
448 ctx
->Extensions
.EXT_texture_env_dot3
= GL_TRUE
;
449 ctx
->Extensions
.EXT_texture_filter_anisotropic
= GL_TRUE
;
450 ctx
->Extensions
.EXT_texture_mirror_clamp
= GL_TRUE
;
451 ctx
->Extensions
.EXT_texture_shared_exponent
= GL_TRUE
;
452 ctx
->Extensions
.EXT_texture_sRGB
= GL_TRUE
;
453 ctx
->Extensions
.EXT_texture_sRGB_decode
= GL_TRUE
;
454 ctx
->Extensions
.EXT_texture_swizzle
= GL_TRUE
;
455 /*ctx->Extensions.EXT_transform_feedback = GL_TRUE;*/
456 ctx
->Extensions
.EXT_vertex_array_bgra
= GL_TRUE
;
457 /*ctx->Extensions.IBM_multimode_draw_arrays = GL_TRUE;*/
458 ctx
->Extensions
.MESA_pack_invert
= GL_TRUE
;
459 ctx
->Extensions
.MESA_resize_buffers
= GL_TRUE
;
460 ctx
->Extensions
.MESA_texture_array
= GL_TRUE
;
461 ctx
->Extensions
.MESA_ycbcr_texture
= GL_TRUE
;
462 ctx
->Extensions
.NV_blend_square
= GL_TRUE
;
463 ctx
->Extensions
.NV_conditional_render
= GL_TRUE
;
464 /*ctx->Extensions.NV_light_max_exponent = GL_TRUE;*/
465 ctx
->Extensions
.NV_point_sprite
= GL_TRUE
;
466 ctx
->Extensions
.NV_texture_env_combine4
= GL_TRUE
;
467 ctx
->Extensions
.NV_texture_rectangle
= GL_TRUE
;
468 /*ctx->Extensions.NV_texgen_reflection = GL_TRUE;*/
469 ctx
->Extensions
.NV_fragment_program_option
= GL_TRUE
;
470 ctx
->Extensions
.EXT_gpu_program_parameters
= GL_TRUE
;
471 _mesa_enable_extension(ctx
, "GL_3DFX_texture_compression_FXT1");
472 if (ctx
->Mesa_DXTn
) {
473 ctx
->Extensions
.ANGLE_texture_compression_dxt
= GL_TRUE
;
474 _mesa_enable_extension(ctx
, "GL_EXT_texture_compression_s3tc");
475 _mesa_enable_extension(ctx
, "GL_S3_s3tc");
481 * Enable all OpenGL 1.3 features and extensions.
482 * A convenience function to be called by drivers.
485 _mesa_enable_1_3_extensions(struct gl_context
*ctx
)
487 ctx
->Extensions
.ARB_texture_border_clamp
= GL_TRUE
;
488 ctx
->Extensions
.ARB_texture_cube_map
= GL_TRUE
;
489 ctx
->Extensions
.ARB_texture_env_combine
= GL_TRUE
;
490 ctx
->Extensions
.ARB_texture_env_dot3
= GL_TRUE
;
496 * Enable all OpenGL 1.4 features and extensions.
497 * A convenience function to be called by drivers.
500 _mesa_enable_1_4_extensions(struct gl_context
*ctx
)
502 ctx
->Extensions
.ARB_depth_texture
= GL_TRUE
;
503 ctx
->Extensions
.ARB_shadow
= GL_TRUE
;
504 ctx
->Extensions
.ARB_texture_env_crossbar
= GL_TRUE
;
505 ctx
->Extensions
.EXT_blend_color
= GL_TRUE
;
506 ctx
->Extensions
.EXT_blend_func_separate
= GL_TRUE
;
507 ctx
->Extensions
.EXT_blend_minmax
= GL_TRUE
;
508 ctx
->Extensions
.EXT_fog_coord
= GL_TRUE
;
509 ctx
->Extensions
.EXT_point_parameters
= GL_TRUE
;
510 ctx
->Extensions
.EXT_secondary_color
= GL_TRUE
;
515 * Enable all OpenGL 1.5 features and extensions.
516 * A convenience function to be called by drivers.
519 _mesa_enable_1_5_extensions(struct gl_context
*ctx
)
521 ctx
->Extensions
.ARB_occlusion_query
= GL_TRUE
;
522 ctx
->Extensions
.EXT_shadow_funcs
= GL_TRUE
;
527 * Enable all OpenGL 2.0 features and extensions.
528 * A convenience function to be called by drivers.
531 _mesa_enable_2_0_extensions(struct gl_context
*ctx
)
533 ctx
->Extensions
.ARB_fragment_shader
= GL_TRUE
;
534 ctx
->Extensions
.ARB_point_sprite
= GL_TRUE
;
535 ctx
->Extensions
.EXT_blend_equation_separate
= GL_TRUE
;
536 ctx
->Extensions
.ARB_texture_non_power_of_two
= GL_TRUE
;
537 ctx
->Extensions
.ARB_shader_objects
= GL_TRUE
;
538 ctx
->Extensions
.ARB_shading_language_100
= GL_TRUE
;
539 ctx
->Extensions
.EXT_stencil_two_side
= GL_TRUE
;
540 ctx
->Extensions
.ARB_vertex_shader
= GL_TRUE
;
545 * Enable all OpenGL 2.1 features and extensions.
546 * A convenience function to be called by drivers.
549 _mesa_enable_2_1_extensions(struct gl_context
*ctx
)
551 ctx
->Extensions
.EXT_pixel_buffer_object
= GL_TRUE
;
552 ctx
->Extensions
.EXT_texture_sRGB
= GL_TRUE
;
557 * Either enable or disable the named extension.
558 * \return GL_TRUE for success, GL_FALSE if invalid extension name
561 set_extension( struct gl_context
*ctx
, const char *name
, GLboolean state
)
565 if (ctx
->Extensions
.String
) {
566 /* The string was already queried - can't change it now! */
567 _mesa_problem(ctx
, "Trying to enable/disable extension after glGetString(GL_EXTENSIONS): %s", name
);
571 offset
= name_to_offset(name
);
573 _mesa_problem(ctx
, "Trying to enable/disable unknown extension %s",
576 } else if (offset
== o(dummy_true
) && state
== GL_FALSE
) {
577 _mesa_problem(ctx
, "Trying to disable a permanently enabled extension: "
581 GLboolean
*base
= (GLboolean
*) &ctx
->Extensions
;
582 base
[offset
] = state
;
589 * Enable the named extension.
590 * Typically called by drivers.
593 _mesa_enable_extension( struct gl_context
*ctx
, const char *name
)
595 if (!set_extension(ctx
, name
, GL_TRUE
))
596 _mesa_problem(ctx
, "Trying to enable unknown extension: %s", name
);
601 * Disable the named extension.
602 * XXX is this really needed???
605 _mesa_disable_extension( struct gl_context
*ctx
, const char *name
)
607 if (!set_extension(ctx
, name
, GL_FALSE
))
608 _mesa_problem(ctx
, "Trying to disable unknown extension: %s", name
);
613 * Test if the named extension is enabled in this context.
616 _mesa_extension_is_enabled( struct gl_context
*ctx
, const char *name
)
624 offset
= name_to_offset(name
);
627 base
= (GLboolean
*) &ctx
->Extensions
;
633 * \brief Apply the \c MESA_EXTENSION_OVERRIDE environment variable.
635 * \c MESA_EXTENSION_OVERRIDE is a space-separated list of extensions to
636 * enable or disable. The list is processed thus:
637 * - Enable recognized extension names that are prefixed with '+'.
638 * - Disable recognized extension names that are prefixed with '-'.
639 * - Enable recognized extension names that are not prefixed.
640 * - Collect unrecognized extension names in a new string.
642 * \return Space-separated list of unrecognized extension names (which must
643 * be freed). Does not return \c NULL.
646 get_extension_override( struct gl_context
*ctx
)
648 const char *env_const
= _mesa_getenv("MESA_EXTENSION_OVERRIDE");
654 if (env_const
== NULL
) {
655 /* Return the empty string rather than NULL. This simplifies the logic
656 * of client functions. */
657 return calloc(4, sizeof(char));
660 /* extra_exts: List of unrecognized extensions. */
661 extra_exts
= calloc(ALIGN(strlen(env_const
) + 2, 4), sizeof(char));
663 /* Copy env_const because strtok() is destructive. */
664 env
= strdup(env_const
);
665 for (ext
= strtok(env
, " "); ext
!= NULL
; ext
= strtok(NULL
, " ")) {
681 recognized
= set_extension(ctx
, ext
, enable
);
683 strcat(extra_exts
, ext
);
684 strcat(extra_exts
, " ");
690 /* Remove trailing space. */
691 len
= strlen(extra_exts
);
692 if (len
> 0 && extra_exts
[len
- 1] == ' ')
693 extra_exts
[len
- 1] = '\0';
700 * \brief Initialize extension tables and enable default extensions.
702 * This should be called during context initialization.
703 * Note: Sets gl_extensions.dummy_true to true.
706 _mesa_init_extensions( struct gl_context
*ctx
)
708 GLboolean
*base
= (GLboolean
*) &ctx
->Extensions
;
709 GLboolean
*sentinel
= base
+ o(extension_sentinel
);
713 /* First, turn all extensions off. */
714 for (i
= base
; i
!= sentinel
; ++i
)
717 /* Then, selectively turn default extensions on. */
718 ctx
->Extensions
.dummy_true
= GL_TRUE
;
719 for (j
= default_extensions
; *j
!= 0; ++j
)
724 typedef unsigned short extension_index
;
728 * Compare two entries of the extensions table. Sorts first by year,
731 * Arguments are indices into extension_table.
734 extension_compare(const void *p1
, const void *p2
)
736 extension_index i1
= * (const extension_index
*) p1
;
737 extension_index i2
= * (const extension_index
*) p2
;
738 const struct extension
*e1
= &extension_table
[i1
];
739 const struct extension
*e2
= &extension_table
[i2
];
742 res
= (int)e1
->year
- (int)e2
->year
;
745 res
= strcmp(e1
->name
, e2
->name
);
753 * Construct the GL_EXTENSIONS string. Called the first time that
754 * glGetString(GL_EXTENSIONS) is called.
757 _mesa_make_extension_string(struct gl_context
*ctx
)
759 /* The extension string. */
761 /* Length of extension string. */
763 /* Number of extensions */
765 /* Indices of the extensions sorted by year */
766 extension_index
*extension_indices
;
767 /* String of extra extensions. */
768 char *extra_extensions
= get_extension_override(ctx
);
769 GLboolean
*base
= (GLboolean
*) &ctx
->Extensions
;
770 const struct extension
*i
;
772 unsigned maxYear
= ~0;
774 /* Check if the MESA_EXTENSION_MAX_YEAR env var is set */
776 const char *env
= getenv("MESA_EXTENSION_MAX_YEAR");
779 _mesa_debug(ctx
, "Note: limiting GL extensions to %u or earlier\n",
784 /* Compute length of the extension string. */
786 for (i
= extension_table
; i
->name
!= 0; ++i
) {
787 if (base
[i
->offset
] &&
788 i
->year
<= maxYear
&&
789 (i
->api_set
& (1 << ctx
->API
))) {
790 length
+= strlen(i
->name
) + 1; /* +1 for space */
794 if (extra_extensions
!= NULL
)
795 length
+= 1 + strlen(extra_extensions
); /* +1 for space */
797 exts
= calloc(ALIGN(length
+ 1, 4), sizeof(char));
799 free(extra_extensions
);
803 extension_indices
= malloc(count
* sizeof(extension_index
));
804 if (extension_indices
== NULL
) {
806 free(extra_extensions
);
810 /* Sort extensions in chronological order because certain old applications (e.g.,
811 * Quake3 demo) store the extension list in a static size buffer so chronologically
812 * order ensure that the extensions that such applications expect will fit into
816 for (i
= extension_table
; i
->name
!= 0; ++i
) {
817 if (base
[i
->offset
] &&
818 i
->year
<= maxYear
&&
819 (i
->api_set
& (1 << ctx
->API
))) {
820 extension_indices
[j
++] = i
- extension_table
;
824 qsort(extension_indices
, count
, sizeof *extension_indices
, extension_compare
);
826 /* Build the extension string.*/
827 for (j
= 0; j
< count
; ++j
) {
828 i
= &extension_table
[extension_indices
[j
]];
829 assert(base
[i
->offset
] && (i
->api_set
& (1 << ctx
->API
)));
830 strcat(exts
, i
->name
);
833 free(extension_indices
);
834 if (extra_extensions
!= 0) {
835 strcat(exts
, extra_extensions
);
836 free(extra_extensions
);
839 return (GLubyte
*) exts
;
843 * Return number of enabled extensions.
846 _mesa_get_extension_count(struct gl_context
*ctx
)
849 const struct extension
*i
;
851 /* only count once */
852 if (ctx
->Extensions
.Count
!= 0)
853 return ctx
->Extensions
.Count
;
855 base
= (GLboolean
*) &ctx
->Extensions
;
856 for (i
= extension_table
; i
->name
!= 0; ++i
) {
857 if (base
[i
->offset
] && (i
->api_set
& (1 << ctx
->API
))) {
858 ctx
->Extensions
.Count
++;
861 return ctx
->Extensions
.Count
;
865 * Return name of i-th enabled extension
868 _mesa_get_enabled_extension(struct gl_context
*ctx
, GLuint index
)
870 const GLboolean
*base
;
872 const struct extension
*i
;
874 base
= (GLboolean
*) &ctx
->Extensions
;
876 for (i
= extension_table
; i
->name
!= 0; ++i
) {
877 if (base
[i
->offset
] && (i
->api_set
& (1 << ctx
->API
))) {
879 return (const GLubyte
*) i
->name
;