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_resize_buffers",            F(MESA_resize_buffers) },
 119    { OFF, "GL_MESA_ycbcr_texture",             F(MESA_ycbcr_texture) },
 120    { ON,  "GL_MESA_window_pos",                F(ARB_window_pos) },
 121    { OFF, "GL_NV_blend_square",                F(NV_blend_square) },
 122    { OFF, "GL_NV_fragment_program",            F(NV_fragment_program) },
 123    { ON,  "GL_NV_light_max_exponent",          0 },
 124    { OFF, "GL_NV_point_sprite",                F(NV_point_sprite) },
 125    { OFF, "GL_NV_texture_rectangle",           F(NV_texture_rectangle) },
 126    { ON,  "GL_NV_texgen_reflection",           0 },
 127    { OFF, "GL_NV_vertex_program",              F(NV_vertex_program) },
 128    { OFF, "GL_NV_vertex_program1_1",           F(NV_vertex_program1_1) },
 129    { OFF, "GL_SGI_color_matrix",               F(SGI_color_matrix) },
 130    { OFF, "GL_SGI_color_table",                F(SGI_color_table) },
 131    { OFF, "GL_SGI_texture_color_table",        F(SGI_texture_color_table) },
 132    { OFF, "GL_SGIS_generate_mipmap",           F(SGIS_generate_mipmap) },
 133    { OFF, "GL_SGIS_pixel_texture",             F(SGIS_pixel_texture) },
 134    { OFF, "GL_SGIS_texture_border_clamp",      F(ARB_texture_border_clamp) },
 135    { ON,  "GL_SGIS_texture_edge_clamp",        F(SGIS_texture_edge_clamp) },
 136    { ON,  "GL_SGIS_texture_lod",               0 },
 137    { OFF, "GL_SGIX_depth_texture",             F(SGIX_depth_texture) },
 138    { OFF, "GL_SGIX_pixel_texture",             F(SGIX_pixel_texture) },
 139    { OFF, "GL_SGIX_shadow",                    F(SGIX_shadow) },
 140    { OFF, "GL_SGIX_shadow_ambient",            F(SGIX_shadow_ambient) },
 141 };
 142
 143
 144
 145 /**
 146  * Enable all extensions suitable for a software-only renderer.
 147  * This is a convenience function used by the XMesa, OSMesa, GGI drivers, etc.
 148  */
 149 void
 150 _mesa_enable_sw_extensions(GLcontext *ctx)
 151 {
 152    ctx->Extensions.ARB_depth_texture = GL_TRUE;
 153 #if FEATURE_ARB_fragment_program
 154    /*ctx->Extensions.ARB_fragment_program = GL_TRUE;*/
 155 #endif
 156    ctx->Extensions.ARB_imaging = GL_TRUE;
 157    ctx->Extensions.ARB_multitexture = GL_TRUE;
 158 #if FEATURE_ARB_occlusion_query
 159    ctx->Extensions.ARB_occlusion_query = GL_TRUE;
 160 #endif
 161    ctx->Extensions.ARB_shadow = GL_TRUE;
 162    ctx->Extensions.ARB_texture_border_clamp = GL_TRUE;
 163    ctx->Extensions.ARB_texture_cube_map = GL_TRUE;
 164    ctx->Extensions.ARB_texture_env_combine = GL_TRUE;
 165    ctx->Extensions.ARB_texture_env_crossbar = GL_TRUE;
 166    ctx->Extensions.ARB_texture_env_dot3 = GL_TRUE;
 167    ctx->Extensions.ARB_texture_mirrored_repeat = GL_TRUE;
 168    ctx->Extensions.ARB_texture_non_power_of_two = GL_TRUE;
 169 #if FEATURE_ARB_vertex_program
 170    /*ctx->Extensions.ARB_vertex_program = GL_TRUE;*/
 171 #endif
 172    ctx->Extensions.ATI_texture_env_combine3 = GL_TRUE;
 173    ctx->Extensions.ATI_texture_mirror_once = GL_TRUE;
 174    ctx->Extensions.EXT_blend_color = GL_TRUE;
 175    ctx->Extensions.EXT_blend_func_separate = GL_TRUE;
 176    ctx->Extensions.EXT_blend_logic_op = GL_TRUE;
 177    ctx->Extensions.EXT_blend_minmax = GL_TRUE;
 178    ctx->Extensions.EXT_blend_subtract = GL_TRUE;
 179    ctx->Extensions.EXT_convolution = GL_TRUE;
 180    ctx->Extensions.EXT_depth_bounds_test = GL_TRUE;
 181    ctx->Extensions.EXT_fog_coord = GL_TRUE;
 182    ctx->Extensions.EXT_histogram = GL_TRUE;
 183    ctx->Extensions.EXT_paletted_texture = GL_TRUE;
 184    ctx->Extensions.EXT_point_parameters = GL_TRUE;
 185    ctx->Extensions.EXT_shadow_funcs = GL_TRUE;
 186    ctx->Extensions.EXT_secondary_color = GL_TRUE;
 187    ctx->Extensions.EXT_shared_texture_palette = GL_TRUE;
 188    ctx->Extensions.EXT_stencil_wrap = GL_TRUE;
 189    ctx->Extensions.EXT_stencil_two_side = GL_TRUE;
 190    ctx->Extensions.EXT_texture_env_add = GL_TRUE;
 191    ctx->Extensions.EXT_texture_env_combine = GL_TRUE;
 192    ctx->Extensions.EXT_texture_env_dot3 = GL_TRUE;
 193    ctx->Extensions.EXT_texture_lod_bias = GL_TRUE;
 194    ctx->Extensions.HP_occlusion_test = GL_TRUE;
 195    ctx->Extensions.MESA_pack_invert = GL_TRUE;
 196    ctx->Extensions.MESA_resize_buffers = GL_TRUE;
 197    ctx->Extensions.MESA_ycbcr_texture = GL_TRUE;
 198    ctx->Extensions.NV_blend_square = GL_TRUE;
 199    /*ctx->Extensions.NV_light_max_exponent = GL_TRUE;*/
 200    ctx->Extensions.NV_point_sprite = GL_TRUE;
 201    ctx->Extensions.NV_texture_rectangle = GL_TRUE;
 202    /*ctx->Extensions.NV_texgen_reflection = GL_TRUE;*/
 203 #if FEATURE_NV_vertex_program
 204    ctx->Extensions.NV_vertex_program = GL_TRUE;
 205    ctx->Extensions.NV_vertex_program1_1 = GL_TRUE;
 206 #endif
 207 #if FEATURE_NV_fragment_program
 208    ctx->Extensions.NV_fragment_program = GL_TRUE;
 209 #endif
 210    ctx->Extensions.SGI_color_matrix = GL_TRUE;
 211    ctx->Extensions.SGI_color_table = GL_TRUE;
 212    ctx->Extensions.SGI_texture_color_table = GL_TRUE;
 213    ctx->Extensions.SGIS_generate_mipmap = GL_TRUE;
 214    ctx->Extensions.SGIS_pixel_texture = GL_TRUE;
 215    ctx->Extensions.SGIS_texture_edge_clamp = GL_TRUE;
 216    ctx->Extensions.SGIX_depth_texture = GL_TRUE;
 217    ctx->Extensions.SGIX_pixel_texture = GL_TRUE;
 218    ctx->Extensions.SGIX_shadow = GL_TRUE;
 219    ctx->Extensions.SGIX_shadow_ambient = GL_TRUE;
 220 }
 221
 222
 223 /**
 224  * Enable GL_ARB_imaging and all the EXT extensions that are subsets of it.
 225  */
 226 void
 227 _mesa_enable_imaging_extensions(GLcontext *ctx)
 228 {
 229    ctx->Extensions.ARB_imaging = GL_TRUE;
 230    ctx->Extensions.EXT_blend_color = GL_TRUE;
 231    ctx->Extensions.EXT_blend_minmax = GL_TRUE;
 232    ctx->Extensions.EXT_blend_subtract = GL_TRUE;
 233    ctx->Extensions.EXT_convolution = GL_TRUE;
 234    ctx->Extensions.EXT_histogram = GL_TRUE;
 235    ctx->Extensions.SGI_color_matrix = GL_TRUE;
 236    ctx->Extensions.SGI_color_table = GL_TRUE;
 237 }
 238
 239
 240
 241 /**
 242  * Enable all OpenGL 1.3 features and extensions.
 243  * A convenience function to be called by drivers.
 244  */
 245 void
 246 _mesa_enable_1_3_extensions(GLcontext *ctx)
 247 {
 248    ctx->Extensions.ARB_multisample = GL_TRUE;
 249    ctx->Extensions.ARB_multitexture = GL_TRUE;
 250    ctx->Extensions.ARB_texture_border_clamp = GL_TRUE;
 251    ctx->Extensions.ARB_texture_compression = GL_TRUE;
 252    ctx->Extensions.ARB_texture_cube_map = GL_TRUE;
 253    ctx->Extensions.ARB_texture_env_combine = GL_TRUE;
 254    ctx->Extensions.ARB_texture_env_dot3 = GL_TRUE;
 255    ctx->Extensions.EXT_texture_env_add = GL_TRUE;
 256    /*ctx->Extensions.ARB_transpose_matrix = GL_TRUE;*/
 257 }
 258
 259
 260
 261 /**
 262  * Enable all OpenGL 1.4 features and extensions.
 263  * A convenience function to be called by drivers.
 264  */
 265 void
 266 _mesa_enable_1_4_extensions(GLcontext *ctx)
 267 {
 268    ctx->Extensions.ARB_depth_texture = GL_TRUE;
 269    ctx->Extensions.ARB_shadow = GL_TRUE;
 270    ctx->Extensions.ARB_texture_env_crossbar = GL_TRUE;
 271    ctx->Extensions.ARB_texture_mirrored_repeat = GL_TRUE;
 272    ctx->Extensions.ARB_window_pos = GL_TRUE;
 273    ctx->Extensions.EXT_blend_color = GL_TRUE;
 274    ctx->Extensions.EXT_blend_func_separate = GL_TRUE;
 275    ctx->Extensions.EXT_blend_logic_op = GL_TRUE;
 276    ctx->Extensions.EXT_blend_minmax = GL_TRUE;
 277    ctx->Extensions.EXT_blend_subtract = GL_TRUE;
 278    ctx->Extensions.EXT_fog_coord = GL_TRUE;
 279    ctx->Extensions.EXT_multi_draw_arrays = GL_TRUE;
 280    ctx->Extensions.EXT_point_parameters = GL_TRUE;
 281    ctx->Extensions.EXT_secondary_color = GL_TRUE;
 282    ctx->Extensions.EXT_stencil_wrap = GL_TRUE;
 283    ctx->Extensions.SGIS_generate_mipmap = GL_TRUE;
 284 }
 285
 286
 287 /**
 288  * Enable all OpenGL 1.5 features and extensions.
 289  * A convenience function to be called by drivers.
 290  * XXX TENTATIVE!!!
 291  */
 292 void
 293 _mesa_enable_1_5_extensions(GLcontext *ctx)
 294 {
 295    ctx->Extensions.ARB_occlusion_query = GL_TRUE;
 296    ctx->Extensions.ARB_vertex_buffer_object = GL_TRUE;
 297    ctx->Extensions.ARB_texture_non_power_of_two = GL_TRUE;
 298 }
 299
 300
 301 /**
 302  * Either enable or disable the named extension.
 303  */
 304 static void
 305 set_extension( GLcontext *ctx, const char *name, GLboolean state )
 306 {
 307    GLboolean *base = (GLboolean *) &ctx->Extensions;
 308    GLuint i;
 309
 310    if (ctx->Extensions.String) {
 311       /* The string was already queried - can't change it now! */
 312       _mesa_problem(ctx, "Trying to enable/disable extension after glGetString(GL_EXTENSIONS): %s", name);
 313       return;
 314    }
 315
 316    for (i = 0 ; i < Elements(default_extensions) ; i++) {
 317       if (_mesa_strcmp(default_extensions[i].name, name) == 0) {
 318          if (default_extensions[i].flag_offset) {
 319             GLboolean *enabled = base + default_extensions[i].flag_offset;
 320             *enabled = state;
 321          }
 322          return;
 323       }
 324    }
 325    _mesa_problem(ctx, "Trying to enable unknown extension: %s", name);
 326 }
 327
 328
 329 /**
 330  * Enable the named extension.
 331  * Typically called by drivers.
 332  */
 333 void
 334 _mesa_enable_extension( GLcontext *ctx, const char *name )
 335 {
 336    set_extension(ctx, name, GL_TRUE);
 337 }
 338
 339
 340 /**
 341  * Disable the named extension.
 342  * XXX is this really needed???
 343  */
 344 void
 345 _mesa_disable_extension( GLcontext *ctx, const char *name )
 346 {
 347    set_extension(ctx, name, GL_FALSE);
 348 }
 349
 350
 351 /**
 352  * Test if the named extension is enabled in this context.
 353  */
 354 GLboolean
 355 _mesa_extension_is_enabled( GLcontext *ctx, const char *name )
 356 {
 357    const GLboolean *base = (const GLboolean *) &ctx->Extensions;
 358    GLuint i;
 359
 360    for (i = 0 ; i < Elements(default_extensions) ; i++) {
 361       if (_mesa_strcmp(default_extensions[i].name, name) == 0) {
 362          if (!default_extensions[i].flag_offset)
 363             return GL_TRUE;
 364          return *(base + default_extensions[i].flag_offset);
 365       }
 366    }
 367    return GL_FALSE;
 368 }
 369
 370
 371 /**
 372  * Run through the default_extensions array above and set the
 373  * ctx->Extensions.ARB/EXT_* flags accordingly.
 374  * To be called during context initialization.
 375  */
 376 void
 377 _mesa_init_extensions( GLcontext *ctx )
 378 {
 379    GLboolean *base = (GLboolean *) &ctx->Extensions;
 380    GLuint i;
 381
 382    for (i = 0 ; i < Elements(default_extensions) ; i++) {
 383       if (default_extensions[i].enabled &&
 384           default_extensions[i].flag_offset) {
 385          *(base + default_extensions[i].flag_offset) = GL_TRUE;
 386       }
 387    }
 388 }
 389
 390
 391 /**
 392  * Construct the GL_EXTENSIONS string.  Called the first time that
 393  * glGetString(GL_EXTENSIONS) is called.
 394  */
 395 GLubyte *
 396 _mesa_make_extension_string( GLcontext *ctx )
 397 {
 398    const GLboolean *base = (const GLboolean *) &ctx->Extensions;
 399    GLuint extStrLen = 0;
 400    GLubyte *s;
 401    GLuint i;
 402
 403    /* first, compute length of the extension string */
 404    for (i = 0 ; i < Elements(default_extensions) ; i++) {
 405       if (!default_extensions[i].flag_offset ||
 406           *(base + default_extensions[i].flag_offset)) {
 407          extStrLen += _mesa_strlen(default_extensions[i].name) + 1;
 408       }
 409    }
 410    s = _mesa_malloc(extStrLen);
 411
 412    /* second, build the extension string */
 413    extStrLen = 0;
 414    for (i = 0 ; i < Elements(default_extensions) ; i++) {
 415       if (!default_extensions[i].flag_offset ||
 416           *(base + default_extensions[i].flag_offset)) {
 417          GLuint len = _mesa_strlen(default_extensions[i].name);
 418          _mesa_memcpy(s + extStrLen, default_extensions[i].name, len);
 419          extStrLen += len;
 420          s[extStrLen] = (GLubyte) ' ';
 421          extStrLen++;
 422       }
 423    }
 424    ASSERT(extStrLen > 0);
 425
 426    s[extStrLen - 1] = 0;
 427
 428    return s;
 429 }
 430
 431 void
 432 _mesa_extensions_dtr( GLcontext *ctx )
 433 {
 434    if (ctx->Extensions.String)
 435       FREE((void *) ctx->Extensions.String);
 436 }