src/mesa/main/extensions.c

   1 /*
   2  * Mesa 3-D graphics library
   3  * Version:  5.1
   4  *
   5  * Copyright (C) 1999-2003  Brian Paul   All Rights Reserved.
   6  *
   7  * Permission is hereby granted, free of charge, to any person obtaining a
   8  * copy of this software and associated documentation files (the "Software"),
   9  * to deal in the Software without restriction, including without limitation
  10  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  11  * and/or sell copies of the Software, and to permit persons to whom the
  12  * Software is furnished to do so, subject to the following conditions:
  13  *
  14  * The above copyright notice and this permission notice shall be included
  15  * in all copies or substantial portions of the Software.
  16  *
  17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  18  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  19  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  20  * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
  21  * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  22  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  23  */
  24
  25
  26 #include "glheader.h"
  27 #include "imports.h"
  28 #include "context.h"
  29 #include "extensions.h"
  30 #include "simple_list.h"
  31 #include "mtypes.h"
  32
  33
  34 #define F(x) (int)&(((struct gl_extensions *)0)->x)
  35 #define ON GL_TRUE
  36 #define OFF GL_FALSE
  37
  38
  39 static const struct {
  40    GLboolean enabled;
  41    const char *name;
  42    int flag_offset;
  43 } default_extensions[] = {
  44    { OFF, "GL_ARB_depth_texture",              F(ARB_depth_texture) },
  45    { OFF, "GL_ARB_fragment_program",           F(ARB_fragment_program) },
  46    { OFF, "GL_ARB_imaging",                    F(ARB_imaging) },
  47    { OFF, "GL_ARB_multisample",                F(ARB_multisample) },
  48    { OFF, "GL_ARB_multitexture",               F(ARB_multitexture) },
  49    { OFF, "GL_ARB_occlusion_query",            F(ARB_occlusion_query) },
  50    { OFF, "GL_ARB_point_parameters",           F(EXT_point_parameters) },
  51    { OFF, "GL_ARB_shadow",                     F(ARB_shadow) },
  52    { OFF, "GL_ARB_shadow_ambient",             F(SGIX_shadow_ambient) },
  53    { OFF, "GL_ARB_texture_border_clamp",       F(ARB_texture_border_clamp) },
  54    { OFF, "GL_ARB_texture_compression",        F(ARB_texture_compression) },
  55    { OFF, "GL_ARB_texture_cube_map",           F(ARB_texture_cube_map) },
  56    { OFF, "GL_ARB_texture_env_add",            F(EXT_texture_env_add) },
  57    { OFF, "GL_ARB_texture_env_combine",        F(ARB_texture_env_combine) },
  58    { OFF, "GL_ARB_texture_env_crossbar",       F(ARB_texture_env_crossbar) },
  59    { OFF, "GL_ARB_texture_env_dot3",           F(ARB_texture_env_dot3) },
  60    { OFF, "GL_ARB_texture_mirrored_repeat",    F(ARB_texture_mirrored_repeat)},
  61    { OFF, "GL_ARB_texture_non_power_of_two",   F(ARB_texture_non_power_of_two)},
  62    { ON,  "GL_ARB_transpose_matrix",           0 },
  63    { OFF, "GL_ARB_vertex_buffer_object",       F(ARB_vertex_buffer_object) },
  64    { OFF, "GL_ARB_vertex_program",             F(ARB_vertex_program) },
  65    { ON,  "GL_ARB_window_pos",                 F(ARB_window_pos) },
  66    { ON,  "GL_EXT_abgr",                       0 },
  67    { ON,  "GL_EXT_bgra",                       0 },
  68    { OFF, "GL_EXT_blend_color",                F(EXT_blend_color) },
  69    { OFF, "GL_EXT_blend_func_separate",        F(EXT_blend_func_separate) },
  70    { OFF, "GL_EXT_blend_logic_op",             F(EXT_blend_logic_op) },
  71    { OFF, "GL_EXT_blend_minmax",               F(EXT_blend_minmax) },
  72    { OFF, "GL_EXT_blend_subtract",             F(EXT_blend_subtract) },
  73    { ON,  "GL_EXT_clip_volume_hint",           0 },
  74    { ON,  "GL_EXT_compiled_vertex_array",      F(EXT_compiled_vertex_array) },
  75    { OFF, "GL_EXT_convolution",                F(EXT_convolution) },
  76    { ON,  "GL_EXT_copy_texture",               0 },
  77    { OFF, "GL_EXT_depth_bounds_test",          F(EXT_depth_bounds_test) },
  78    { ON,  "GL_EXT_draw_range_elements",        0 },
  79    { OFF, "GL_EXT_fog_coord",                  F(EXT_fog_coord) },
  80    { OFF, "GL_EXT_histogram",                  F(EXT_histogram) },
  81    { OFF, "GL_EXT_multi_draw_arrays",          F(EXT_multi_draw_arrays) },
  82    { ON,  "GL_EXT_packed_pixels",              0 },
  83    { OFF, "GL_EXT_paletted_texture",           F(EXT_paletted_texture) },
  84    { OFF, "GL_EXT_point_parameters",           F(EXT_point_parameters) },
  85    { ON,  "GL_EXT_polygon_offset",             0 },
  86    { ON,  "GL_EXT_rescale_normal",             0 },
  87    { OFF, "GL_EXT_secondary_color",            F(EXT_secondary_color) },
  88    { ON,  "GL_EXT_separate_specular_color",    0 },
  89    { OFF, "GL_EXT_shadow_funcs",               F(EXT_shadow_funcs) },
  90    { OFF, "GL_EXT_shared_texture_palette",     F(EXT_shared_texture_palette) },
  91    { OFF, "GL_EXT_stencil_two_side",           F(EXT_stencil_two_side) },
  92    { OFF, "GL_EXT_stencil_wrap",               F(EXT_stencil_wrap) },
  93    { ON,  "GL_EXT_subtexture",                 0 },
  94    { ON,  "GL_EXT_texture",                    0 },
  95    { ON,  "GL_EXT_texture3D",                  F(EXT_texture3D) },
  96    { OFF, "GL_EXT_texture_compression_s3tc",   F(EXT_texture_compression_s3tc) },
  97    { ON,  "GL_EXT_texture_edge_clamp",         F(SGIS_texture_edge_clamp) },
  98    { OFF, "GL_EXT_texture_env_add",            F(EXT_texture_env_add) },
  99    { OFF, "GL_EXT_texture_env_combine",        F(EXT_texture_env_combine) },
 100    { OFF, "GL_EXT_texture_env_dot3",           F(EXT_texture_env_dot3) },
 101    { OFF, "GL_EXT_texture_filter_anisotropic", F(EXT_texture_filter_anisotropic) },
 102    { ON,  "GL_EXT_texture_object",             0 },
 103    { OFF, "GL_EXT_texture_lod_bias",           F(EXT_texture_lod_bias) },
 104    { OFF, "GL_EXT_texture_rectangle",          F(NV_texture_rectangle) },
 105    { ON,  "GL_EXT_vertex_array",               0 },
 106    { OFF, "GL_EXT_vertex_array_set",           F(EXT_vertex_array_set) },
 107    { OFF, "GL_3DFX_texture_compression_FXT1",  F(TDFX_texture_compression_FXT1) },
 108    { OFF, "GL_APPLE_client_storage",           F(APPLE_client_storage) },
 109    { ON,  "GL_APPLE_packed_pixels",            0 },
 110    { OFF, "GL_ATI_texture_env_combine3",       F(ATI_texture_env_combine3)},
 111    { OFF, "GL_ATI_texture_mirror_once",        F(ATI_texture_mirror_once)},
 112    { OFF, "GL_HP_occlusion_test",              F(HP_occlusion_test) },
 113    { ON,  "GL_IBM_rasterpos_clip",             F(IBM_rasterpos_clip) },
 114    { OFF, "GL_IBM_texture_mirrored_repeat",    F(ARB_texture_mirrored_repeat)},
 115    { OFF, "GL_INGR_blend_func_separate",       F(EXT_blend_func_separate) },
 116    { OFF, "GL_MESA_pack_invert",               F(MESA_pack_invert) },
 117    { OFF, "GL_MESA_packed_depth_stencil",      F(MESA_packed_depth_stencil) },
 118    { OFF, "GL_MESA_program_debug",             F(MESA_program_debug) },
 119    { OFF, "GL_MESA_resize_buffers",            F(MESA_resize_buffers) },
 120    { OFF, "GL_MESA_ycbcr_texture",             F(MESA_ycbcr_texture) },
 121    { ON,  "GL_MESA_window_pos",                F(ARB_window_pos) },
 122    { OFF, "GL_NV_blend_square",                F(NV_blend_square) },
 123    { OFF, "GL_NV_fragment_program",            F(NV_fragment_program) },
 124    { ON,  "GL_NV_light_max_exponent",          0 },
 125    { OFF, "GL_NV_point_sprite",                F(NV_point_sprite) },
 126    { OFF, "GL_NV_texture_rectangle",           F(NV_texture_rectangle) },
 127    { ON,  "GL_NV_texgen_reflection",           0 },
 128    { OFF, "GL_NV_vertex_program",              F(NV_vertex_program) },
 129    { OFF, "GL_NV_vertex_program1_1",           F(NV_vertex_program1_1) },
 130    { OFF, "GL_SGI_color_matrix",               F(SGI_color_matrix) },
 131    { OFF, "GL_SGI_color_table",                F(SGI_color_table) },
 132    { OFF, "GL_SGI_texture_color_table",        F(SGI_texture_color_table) },
 133    { OFF, "GL_SGIS_generate_mipmap",           F(SGIS_generate_mipmap) },
 134    { OFF, "GL_SGIS_pixel_texture",             F(SGIS_pixel_texture) },
 135    { OFF, "GL_SGIS_texture_border_clamp",      F(ARB_texture_border_clamp) },
 136    { ON,  "GL_SGIS_texture_edge_clamp",        F(SGIS_texture_edge_clamp) },
 137    { ON,  "GL_SGIS_texture_lod",               0 },
 138    { OFF, "GL_SGIX_depth_texture",             F(SGIX_depth_texture) },
 139    { OFF, "GL_SGIX_pixel_texture",             F(SGIX_pixel_texture) },
 140    { OFF, "GL_SGIX_shadow",                    F(SGIX_shadow) },
 141    { OFF, "GL_SGIX_shadow_ambient",            F(SGIX_shadow_ambient) },
 142 };
 143
 144
 145
 146 /**
 147  * Enable all extensions suitable for a software-only renderer.
 148  * This is a convenience function used by the XMesa, OSMesa, GGI drivers, etc.
 149  */
 150 void
 151 _mesa_enable_sw_extensions(GLcontext *ctx)
 152 {
 153    ctx->Extensions.ARB_depth_texture = GL_TRUE;
 154 #if FEATURE_ARB_fragment_program
 155    ctx->Extensions.ARB_fragment_program = GL_TRUE;
 156 #endif
 157    ctx->Extensions.ARB_imaging = GL_TRUE;
 158    ctx->Extensions.ARB_multitexture = GL_TRUE;
 159 #if FEATURE_ARB_occlusion_query
 160    ctx->Extensions.ARB_occlusion_query = GL_TRUE;
 161 #endif
 162    ctx->Extensions.ARB_shadow = GL_TRUE;
 163    ctx->Extensions.ARB_texture_border_clamp = GL_TRUE;
 164    ctx->Extensions.ARB_texture_cube_map = GL_TRUE;
 165    ctx->Extensions.ARB_texture_env_combine = GL_TRUE;
 166    ctx->Extensions.ARB_texture_env_crossbar = GL_TRUE;
 167    ctx->Extensions.ARB_texture_env_dot3 = GL_TRUE;
 168    ctx->Extensions.ARB_texture_mirrored_repeat = GL_TRUE;
 169    ctx->Extensions.ARB_texture_non_power_of_two = GL_TRUE;
 170 #if FEATURE_ARB_vertex_program
 171    /*ctx->Extensions.ARB_vertex_program = GL_TRUE;*/
 172 #endif
 173    ctx->Extensions.ATI_texture_env_combine3 = GL_TRUE;
 174    ctx->Extensions.ATI_texture_mirror_once = GL_TRUE;
 175    ctx->Extensions.EXT_blend_color = GL_TRUE;
 176    ctx->Extensions.EXT_blend_func_separate = GL_TRUE;
 177    ctx->Extensions.EXT_blend_logic_op = GL_TRUE;
 178    ctx->Extensions.EXT_blend_minmax = GL_TRUE;
 179    ctx->Extensions.EXT_blend_subtract = GL_TRUE;
 180    ctx->Extensions.EXT_convolution = GL_TRUE;
 181    ctx->Extensions.EXT_depth_bounds_test = GL_TRUE;
 182    ctx->Extensions.EXT_fog_coord = GL_TRUE;
 183    ctx->Extensions.EXT_histogram = GL_TRUE;
 184    ctx->Extensions.EXT_paletted_texture = GL_TRUE;
 185    ctx->Extensions.EXT_point_parameters = GL_TRUE;
 186    ctx->Extensions.EXT_shadow_funcs = GL_TRUE;
 187    ctx->Extensions.EXT_secondary_color = GL_TRUE;
 188    ctx->Extensions.EXT_shared_texture_palette = GL_TRUE;
 189    ctx->Extensions.EXT_stencil_wrap = GL_TRUE;
 190    ctx->Extensions.EXT_stencil_two_side = GL_TRUE;
 191    ctx->Extensions.EXT_texture_env_add = GL_TRUE;
 192    ctx->Extensions.EXT_texture_env_combine = GL_TRUE;
 193    ctx->Extensions.EXT_texture_env_dot3 = GL_TRUE;
 194    ctx->Extensions.EXT_texture_lod_bias = GL_TRUE;
 195    ctx->Extensions.HP_occlusion_test = GL_TRUE;
 196    ctx->Extensions.MESA_pack_invert = GL_TRUE;
 197 #if FEATURE_MESA_program_debug
 198    ctx->Extensions.MESA_program_debug = GL_TRUE;
 199 #endif
 200    ctx->Extensions.MESA_resize_buffers = GL_TRUE;
 201    ctx->Extensions.MESA_ycbcr_texture = GL_TRUE;
 202    ctx->Extensions.NV_blend_square = GL_TRUE;
 203    /*ctx->Extensions.NV_light_max_exponent = GL_TRUE;*/
 204    ctx->Extensions.NV_point_sprite = GL_TRUE;
 205    ctx->Extensions.NV_texture_rectangle = GL_TRUE;
 206    /*ctx->Extensions.NV_texgen_reflection = GL_TRUE;*/
 207 #if FEATURE_NV_vertex_program
 208    ctx->Extensions.NV_vertex_program = GL_TRUE;
 209    ctx->Extensions.NV_vertex_program1_1 = GL_TRUE;
 210 #endif
 211 #if FEATURE_NV_fragment_program
 212    ctx->Extensions.NV_fragment_program = GL_TRUE;
 213 #endif
 214    ctx->Extensions.SGI_color_matrix = GL_TRUE;
 215    ctx->Extensions.SGI_color_table = GL_TRUE;
 216    ctx->Extensions.SGI_texture_color_table = GL_TRUE;
 217    ctx->Extensions.SGIS_generate_mipmap = GL_TRUE;
 218    ctx->Extensions.SGIS_pixel_texture = GL_TRUE;
 219    ctx->Extensions.SGIS_texture_edge_clamp = GL_TRUE;
 220    ctx->Extensions.SGIX_depth_texture = GL_TRUE;
 221    ctx->Extensions.SGIX_pixel_texture = GL_TRUE;
 222    ctx->Extensions.SGIX_shadow = GL_TRUE;
 223    ctx->Extensions.SGIX_shadow_ambient = GL_TRUE;
 224 }
 225
 226
 227 /**
 228  * Enable GL_ARB_imaging and all the EXT extensions that are subsets of it.
 229  */
 230 void
 231 _mesa_enable_imaging_extensions(GLcontext *ctx)
 232 {
 233    ctx->Extensions.ARB_imaging = GL_TRUE;
 234    ctx->Extensions.EXT_blend_color = GL_TRUE;
 235    ctx->Extensions.EXT_blend_minmax = GL_TRUE;
 236    ctx->Extensions.EXT_blend_subtract = GL_TRUE;
 237    ctx->Extensions.EXT_convolution = GL_TRUE;
 238    ctx->Extensions.EXT_histogram = GL_TRUE;
 239    ctx->Extensions.SGI_color_matrix = GL_TRUE;
 240    ctx->Extensions.SGI_color_table = GL_TRUE;
 241 }
 242
 243
 244
 245 /**
 246  * Enable all OpenGL 1.3 features and extensions.
 247  * A convenience function to be called by drivers.
 248  */
 249 void
 250 _mesa_enable_1_3_extensions(GLcontext *ctx)
 251 {
 252    ctx->Extensions.ARB_multisample = GL_TRUE;
 253    ctx->Extensions.ARB_multitexture = GL_TRUE;
 254    ctx->Extensions.ARB_texture_border_clamp = GL_TRUE;
 255    ctx->Extensions.ARB_texture_compression = GL_TRUE;
 256    ctx->Extensions.ARB_texture_cube_map = GL_TRUE;
 257    ctx->Extensions.ARB_texture_env_combine = GL_TRUE;
 258    ctx->Extensions.ARB_texture_env_dot3 = GL_TRUE;
 259    ctx->Extensions.EXT_texture_env_add = GL_TRUE;
 260    /*ctx->Extensions.ARB_transpose_matrix = GL_TRUE;*/
 261 }
 262
 263
 264
 265 /**
 266  * Enable all OpenGL 1.4 features and extensions.
 267  * A convenience function to be called by drivers.
 268  */
 269 void
 270 _mesa_enable_1_4_extensions(GLcontext *ctx)
 271 {
 272    ctx->Extensions.ARB_depth_texture = GL_TRUE;
 273    ctx->Extensions.ARB_shadow = GL_TRUE;
 274    ctx->Extensions.ARB_texture_env_crossbar = GL_TRUE;
 275    ctx->Extensions.ARB_texture_mirrored_repeat = GL_TRUE;
 276    ctx->Extensions.ARB_window_pos = GL_TRUE;
 277    ctx->Extensions.EXT_blend_color = GL_TRUE;
 278    ctx->Extensions.EXT_blend_func_separate = GL_TRUE;
 279    ctx->Extensions.EXT_blend_logic_op = GL_TRUE;
 280    ctx->Extensions.EXT_blend_minmax = GL_TRUE;
 281    ctx->Extensions.EXT_blend_subtract = GL_TRUE;
 282    ctx->Extensions.EXT_fog_coord = GL_TRUE;
 283    ctx->Extensions.EXT_multi_draw_arrays = GL_TRUE;
 284    ctx->Extensions.EXT_point_parameters = GL_TRUE;
 285    ctx->Extensions.EXT_secondary_color = GL_TRUE;
 286    ctx->Extensions.EXT_stencil_wrap = GL_TRUE;
 287    ctx->Extensions.SGIS_generate_mipmap = GL_TRUE;
 288 }
 289
 290
 291 /**
 292  * Enable all OpenGL 1.5 features and extensions.
 293  * A convenience function to be called by drivers.
 294  * XXX TENTATIVE!!!
 295  */
 296 void
 297 _mesa_enable_1_5_extensions(GLcontext *ctx)
 298 {
 299    ctx->Extensions.ARB_occlusion_query = GL_TRUE;
 300    ctx->Extensions.ARB_vertex_buffer_object = GL_TRUE;
 301    ctx->Extensions.ARB_texture_non_power_of_two = GL_TRUE;
 302 }
 303
 304
 305 /**
 306  * Either enable or disable the named extension.
 307  */
 308 static void
 309 set_extension( GLcontext *ctx, const char *name, GLboolean state )
 310 {
 311    GLboolean *base = (GLboolean *) &ctx->Extensions;
 312    GLuint i;
 313
 314    if (ctx->Extensions.String) {
 315       /* The string was already queried - can't change it now! */
 316       _mesa_problem(ctx, "Trying to enable/disable extension after glGetString(GL_EXTENSIONS): %s", name);
 317       return;
 318    }
 319
 320    for (i = 0 ; i < Elements(default_extensions) ; i++) {
 321       if (_mesa_strcmp(default_extensions[i].name, name) == 0) {
 322          if (default_extensions[i].flag_offset) {
 323             GLboolean *enabled = base + default_extensions[i].flag_offset;
 324             *enabled = state;
 325          }
 326          return;
 327       }
 328    }
 329    _mesa_problem(ctx, "Trying to enable unknown extension: %s", name);
 330 }
 331
 332
 333 /**
 334  * Enable the named extension.
 335  * Typically called by drivers.
 336  */
 337 void
 338 _mesa_enable_extension( GLcontext *ctx, const char *name )
 339 {
 340    set_extension(ctx, name, GL_TRUE);
 341 }
 342
 343
 344 /**
 345  * Disable the named extension.
 346  * XXX is this really needed???
 347  */
 348 void
 349 _mesa_disable_extension( GLcontext *ctx, const char *name )
 350 {
 351    set_extension(ctx, name, GL_FALSE);
 352 }
 353
 354
 355 /**
 356  * Test if the named extension is enabled in this context.
 357  */
 358 GLboolean
 359 _mesa_extension_is_enabled( GLcontext *ctx, const char *name )
 360 {
 361    const GLboolean *base = (const GLboolean *) &ctx->Extensions;
 362    GLuint i;
 363
 364    for (i = 0 ; i < Elements(default_extensions) ; i++) {
 365       if (_mesa_strcmp(default_extensions[i].name, name) == 0) {
 366          if (!default_extensions[i].flag_offset)
 367             return GL_TRUE;
 368          return *(base + default_extensions[i].flag_offset);
 369       }
 370    }
 371    return GL_FALSE;
 372 }
 373
 374
 375 /**
 376  * Run through the default_extensions array above and set the
 377  * ctx->Extensions.ARB/EXT_* flags accordingly.
 378  * To be called during context initialization.
 379  */
 380 void
 381 _mesa_init_extensions( GLcontext *ctx )
 382 {
 383    GLboolean *base = (GLboolean *) &ctx->Extensions;
 384    GLuint i;
 385
 386    for (i = 0 ; i < Elements(default_extensions) ; i++) {
 387       if (default_extensions[i].enabled &&
 388           default_extensions[i].flag_offset) {
 389          *(base + default_extensions[i].flag_offset) = GL_TRUE;
 390       }
 391    }
 392 }
 393
 394
 395 /**
 396  * Construct the GL_EXTENSIONS string.  Called the first time that
 397  * glGetString(GL_EXTENSIONS) is called.
 398  */
 399 GLubyte *
 400 _mesa_make_extension_string( GLcontext *ctx )
 401 {
 402    const GLboolean *base = (const GLboolean *) &ctx->Extensions;
 403    GLuint extStrLen = 0;
 404    GLubyte *s;
 405    GLuint i;
 406
 407    /* first, compute length of the extension string */
 408    for (i = 0 ; i < Elements(default_extensions) ; i++) {
 409       if (!default_extensions[i].flag_offset ||
 410           *(base + default_extensions[i].flag_offset)) {
 411          extStrLen += _mesa_strlen(default_extensions[i].name) + 1;
 412       }
 413    }
 414    s = _mesa_malloc(extStrLen);
 415
 416    /* second, build the extension string */
 417    extStrLen = 0;
 418    for (i = 0 ; i < Elements(default_extensions) ; i++) {
 419       if (!default_extensions[i].flag_offset ||
 420           *(base + default_extensions[i].flag_offset)) {
 421          GLuint len = _mesa_strlen(default_extensions[i].name);
 422          _mesa_memcpy(s + extStrLen, default_extensions[i].name, len);
 423          extStrLen += len;
 424          s[extStrLen] = (GLubyte) ' ';
 425          extStrLen++;
 426       }
 427    }
 428    ASSERT(extStrLen > 0);
 429
 430    s[extStrLen - 1] = 0;
 431
 432    return s;
 433 }