src/mesa/main/version.c

   1 /*
   2  * Mesa 3-D graphics library
   3  *
   4  * Copyright (C) 2010  VMware, Inc.  All Rights Reserved.
   5  *
   6  * Permission is hereby granted, free of charge, to any person obtaining a
   7  * copy of this software and associated documentation files (the "Software"),
   8  * to deal in the Software without restriction, including without limitation
   9  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  10  * and/or sell copies of the Software, and to permit persons to whom the
  11  * Software is furnished to do so, subject to the following conditions:
  12  *
  13  * The above copyright notice and this permission notice shall be included
  14  * in all copies or substantial portions of the Software.
  15  *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  17  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  19  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
  20  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  21  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  22  * OTHER DEALINGS IN THE SOFTWARE.
  23  */
  24
  25
  26 #include <stdio.h>
  27 #include "imports.h"
  28 #include "mtypes.h"
  29 #include "version.h"
  30 #include "git_sha1.h"
  31
  32 /**
  33  * Scans 'string' to see if it ends with 'ending'.
  34  */
  35 static bool
  36 check_for_ending(const char *string, const char *ending)
  37 {
  38    const size_t len1 = strlen(string);
  39    const size_t len2 = strlen(ending);
  40
  41    if (len2 > len1)
  42       return false;
  43
  44    return strcmp(string + (len1 - len2), ending) == 0;
  45 }
  46
  47 /**
  48  * Returns the gl override data
  49  *
  50  * version > 0 indicates there is an override requested
  51  * fwd_context is only valid if version > 0
  52  */
  53 static void
  54 get_gl_override(gl_api api, int *version, bool *fwd_context,
  55                 bool *compat_context)
  56 {
  57    const char *env_var = (api == API_OPENGL_CORE || api == API_OPENGL_COMPAT)
  58       ? "MESA_GL_VERSION_OVERRIDE" : "MESA_GLES_VERSION_OVERRIDE";
  59    const char *version_str;
  60    int major, minor, n;
  61    static struct override_info {
  62       int version;
  63       bool fc_suffix;
  64       bool compat_suffix;
  65    } override[] = {
  66       { -1, false, false},
  67       { -1, false, false},
  68       { -1, false, false},
  69       { -1, false, false},
  70    };
  71
  72    STATIC_ASSERT(ARRAY_SIZE(override) == API_OPENGL_LAST + 1);
  73
  74    if (api == API_OPENGLES)
  75       goto exit;
  76
  77    if (override[api].version < 0) {
  78       override[api].version = 0;
  79
  80       version_str = getenv(env_var);
  81       if (version_str) {
  82          override[api].fc_suffix = check_for_ending(version_str, "FC");
  83          override[api].compat_suffix = check_for_ending(version_str, "COMPAT");
  84
  85          n = sscanf(version_str, "%u.%u", &major, &minor);
  86          if (n != 2) {
  87             fprintf(stderr, "error: invalid value for %s: %s\n",
  88                     env_var, version_str);
  89             override[api].version = 0;
  90          } else {
  91             override[api].version = major * 10 + minor;
  92
  93             /* There is no such thing as compatibility or forward-compatible for
  94              * OpenGL ES 2.0 or 3.x APIs.
  95              */
  96             if ((override[api].version < 30 && override[api].fc_suffix) ||
  97                 (api == API_OPENGLES2 && (override[api].fc_suffix ||
  98                                           override[api].compat_suffix))) {
  99                fprintf(stderr, "error: invalid value for %s: %s\n",
 100                        env_var, version_str);
 101             }
 102          }
 103       }
 104    }
 105
 106 exit:
 107    *version = override[api].version;
 108    *fwd_context = override[api].fc_suffix;
 109    *compat_context = override[api].compat_suffix;
 110 }
 111
 112 /**
 113  * Builds the MESA version string.
 114  */
 115 static void
 116 create_version_string(struct gl_context *ctx, const char *prefix)
 117 {
 118    static const int max = 100;
 119
 120    ctx->VersionString = malloc(max);
 121    if (ctx->VersionString) {
 122       _mesa_snprintf(ctx->VersionString, max,
 123                      "%s%u.%u%s Mesa " PACKAGE_VERSION
 124 #ifdef MESA_GIT_SHA1
 125                      " (" MESA_GIT_SHA1 ")"
 126 #endif
 127                      ,
 128                      prefix,
 129                      ctx->Version / 10, ctx->Version % 10,
 130                      (ctx->API == API_OPENGL_CORE) ? " (Core Profile)" : ""
 131                      );
 132    }
 133 }
 134
 135 /**
 136  * Override the context's version and/or API type if the
 137  * environment variable MESA_GL_VERSION_OVERRIDE is set.
 138  *
 139  * Example uses of MESA_GL_VERSION_OVERRIDE:
 140  *
 141  * 2.1: select a compatibility (non-Core) profile with GL version 2.1
 142  * 3.0: select a compatibility (non-Core) profile with GL version 3.0
 143  * 3.0FC: select a Core+Forward Compatible profile with GL version 3.0
 144  * 3.1: select a Core profile with GL version 3.1
 145  * 3.1FC: select a Core+Forward Compatible profile with GL version 3.1
 146  */
 147 bool
 148 _mesa_override_gl_version_contextless(struct gl_constants *consts,
 149                                       gl_api *apiOut, GLuint *versionOut)
 150 {
 151    int version;
 152    bool fwd_context, compat_context;
 153
 154    get_gl_override(*apiOut, &version, &fwd_context, &compat_context);
 155
 156    if (version > 0) {
 157       *versionOut = version;
 158
 159       /* If the API is a desktop API, adjust the context flags.  We may also
 160        * need to modify the API depending on the version.  For example, Mesa
 161        * does not support a GL 3.3 compatibility profile.
 162        */
 163       if (*apiOut == API_OPENGL_CORE || *apiOut == API_OPENGL_COMPAT) {
 164          if (version >= 30 && fwd_context) {
 165             *apiOut = API_OPENGL_CORE;
 166             consts->ContextFlags |= GL_CONTEXT_FLAG_FORWARD_COMPATIBLE_BIT;
 167          } else if (version >= 31 && !compat_context) {
 168             *apiOut = API_OPENGL_CORE;
 169          } else {
 170             *apiOut = API_OPENGL_COMPAT;
 171          }
 172       }
 173
 174       return true;
 175    }
 176    return false;
 177 }
 178
 179 void
 180 _mesa_override_gl_version(struct gl_context *ctx)
 181 {
 182    if (_mesa_override_gl_version_contextless(&ctx->Const, &ctx->API,
 183                                              &ctx->Version)) {
 184       create_version_string(ctx, "");
 185    }
 186 }
 187
 188 /**
 189  * Override the context's GLSL version if the environment variable
 190  * MESA_GLSL_VERSION_OVERRIDE is set. Valid values for
 191  * MESA_GLSL_VERSION_OVERRIDE are integers, such as "130".
 192  */
 193 void
 194 _mesa_override_glsl_version(struct gl_constants *consts)
 195 {
 196    const char *env_var = "MESA_GLSL_VERSION_OVERRIDE";
 197    const char *version;
 198    int n;
 199
 200    version = getenv(env_var);
 201    if (!version) {
 202       return;
 203    }
 204
 205    n = sscanf(version, "%u", &consts->GLSLVersion);
 206    if (n != 1) {
 207       fprintf(stderr, "error: invalid value for %s: %s\n", env_var, version);
 208       return;
 209    }
 210 }
 211
 212 /**
 213  * Examine enabled GL extensions to determine GL version.
 214  */
 215 static GLuint
 216 compute_version(const struct gl_extensions *extensions,
 217                 const struct gl_constants *consts, gl_api api)
 218 {
 219    GLuint major, minor, version;
 220
 221    const bool ver_1_3 = (extensions->ARB_texture_border_clamp &&
 222                          extensions->ARB_texture_cube_map &&
 223                          extensions->ARB_texture_env_combine &&
 224                          extensions->ARB_texture_env_dot3);
 225    const bool ver_1_4 = (ver_1_3 &&
 226                          extensions->ARB_depth_texture &&
 227                          extensions->ARB_shadow &&
 228                          extensions->ARB_texture_env_crossbar &&
 229                          extensions->EXT_blend_color &&
 230                          extensions->EXT_blend_func_separate &&
 231                          extensions->EXT_blend_minmax &&
 232                          extensions->EXT_point_parameters);
 233    const bool ver_1_5 = (ver_1_4 &&
 234                          extensions->ARB_occlusion_query);
 235    const bool ver_2_0 = (ver_1_5 &&
 236                          extensions->ARB_point_sprite &&
 237                          extensions->ARB_vertex_shader &&
 238                          extensions->ARB_fragment_shader &&
 239                          extensions->ARB_texture_non_power_of_two &&
 240                          extensions->EXT_blend_equation_separate &&
 241
 242                          /* Technically, 2.0 requires the functionality of the
 243                           * EXT version.  Enable 2.0 if either extension is
 244                           * available, and assume that a driver that only
 245                           * exposes the ATI extension will fallback to
 246                           * software when necessary.
 247                           */
 248                          (extensions->EXT_stencil_two_side
 249                           || extensions->ATI_separate_stencil));
 250    const bool ver_2_1 = (ver_2_0 &&
 251                          extensions->EXT_pixel_buffer_object &&
 252                          extensions->EXT_texture_sRGB);
 253    const bool ver_3_0 = (ver_2_1 &&
 254                          consts->GLSLVersion >= 130 &&
 255                          (consts->MaxSamples >= 4 || consts->FakeSWMSAA) &&
 256                          (api == API_OPENGL_CORE ||
 257                           extensions->ARB_color_buffer_float) &&
 258                          extensions->ARB_depth_buffer_float &&
 259                          extensions->ARB_half_float_vertex &&
 260                          extensions->ARB_map_buffer_range &&
 261                          extensions->ARB_shader_texture_lod &&
 262                          extensions->ARB_texture_float &&
 263                          extensions->ARB_texture_rg &&
 264                          extensions->ARB_texture_compression_rgtc &&
 265                          extensions->EXT_draw_buffers2 &&
 266                          extensions->ARB_framebuffer_object &&
 267                          extensions->EXT_framebuffer_sRGB &&
 268                          extensions->EXT_packed_float &&
 269                          extensions->EXT_texture_array &&
 270                          extensions->EXT_texture_shared_exponent &&
 271                          extensions->EXT_transform_feedback &&
 272                          extensions->NV_conditional_render);
 273    const bool ver_3_1 = (ver_3_0 &&
 274                          consts->GLSLVersion >= 140 &&
 275                          extensions->ARB_draw_instanced &&
 276                          extensions->ARB_texture_buffer_object &&
 277                          extensions->ARB_uniform_buffer_object &&
 278                          extensions->EXT_texture_snorm &&
 279                          extensions->NV_primitive_restart &&
 280                          extensions->NV_texture_rectangle &&
 281                          consts->Program[MESA_SHADER_VERTEX].MaxTextureImageUnits >= 16);
 282    const bool ver_3_2 = (ver_3_1 &&
 283                          consts->GLSLVersion >= 150 &&
 284                          extensions->ARB_depth_clamp &&
 285                          extensions->ARB_draw_elements_base_vertex &&
 286                          extensions->ARB_fragment_coord_conventions &&
 287                          extensions->EXT_provoking_vertex &&
 288                          extensions->ARB_seamless_cube_map &&
 289                          extensions->ARB_sync &&
 290                          extensions->ARB_texture_multisample &&
 291                          extensions->EXT_vertex_array_bgra);
 292    const bool ver_3_3 = (ver_3_2 &&
 293                          consts->GLSLVersion >= 330 &&
 294                          extensions->ARB_blend_func_extended &&
 295                          extensions->ARB_explicit_attrib_location &&
 296                          extensions->ARB_instanced_arrays &&
 297                          extensions->ARB_occlusion_query2 &&
 298                          extensions->ARB_shader_bit_encoding &&
 299                          extensions->ARB_texture_rgb10_a2ui &&
 300                          extensions->ARB_timer_query &&
 301                          extensions->ARB_vertex_type_2_10_10_10_rev &&
 302                          extensions->EXT_texture_swizzle);
 303    /* ARB_sampler_objects is always enabled in mesa */
 304
 305    const bool ver_4_0 = (ver_3_3 &&
 306                          consts->GLSLVersion >= 400 &&
 307                          extensions->ARB_draw_buffers_blend &&
 308                          extensions->ARB_draw_indirect &&
 309                          extensions->ARB_gpu_shader5 &&
 310                          extensions->ARB_gpu_shader_fp64 &&
 311                          extensions->ARB_sample_shading &&
 312                          extensions->ARB_shader_subroutine &&
 313                          extensions->ARB_tessellation_shader &&
 314                          extensions->ARB_texture_buffer_object_rgb32 &&
 315                          extensions->ARB_texture_cube_map_array &&
 316                          extensions->ARB_texture_query_lod &&
 317                          extensions->ARB_transform_feedback2 &&
 318                          extensions->ARB_transform_feedback3);
 319    const bool ver_4_1 = (ver_4_0 &&
 320                          consts->GLSLVersion >= 410 &&
 321                          extensions->ARB_ES2_compatibility &&
 322                          extensions->ARB_shader_precision &&
 323                          extensions->ARB_vertex_attrib_64bit &&
 324                          extensions->ARB_viewport_array);
 325    const bool ver_4_2 = (ver_4_1 &&
 326                          consts->GLSLVersion >= 420 &&
 327                          extensions->ARB_base_instance &&
 328                          extensions->ARB_conservative_depth &&
 329                          extensions->ARB_internalformat_query &&
 330                          extensions->ARB_shader_atomic_counters &&
 331                          extensions->ARB_shader_image_load_store &&
 332                          extensions->ARB_shading_language_420pack &&
 333                          extensions->ARB_shading_language_packing &&
 334                          extensions->ARB_texture_compression_bptc &&
 335                          extensions->ARB_transform_feedback_instanced);
 336
 337    if (ver_4_2) {
 338       major = 4;
 339       minor = 2;
 340    }
 341    else if (ver_4_1) {
 342       major = 4;
 343       minor = 1;
 344    }
 345    else if (ver_4_0) {
 346       major = 4;
 347       minor = 0;
 348    }
 349    else if (ver_3_3) {
 350       major = 3;
 351       minor = 3;
 352    }
 353    else if (ver_3_2) {
 354       major = 3;
 355       minor = 2;
 356    }
 357    else if (ver_3_1) {
 358       major = 3;
 359       minor = 1;
 360    }
 361    else if (ver_3_0) {
 362       major = 3;
 363       minor = 0;
 364    }
 365    else if (ver_2_1) {
 366       major = 2;
 367       minor = 1;
 368    }
 369    else if (ver_2_0) {
 370       major = 2;
 371       minor = 0;
 372    }
 373    else if (ver_1_5) {
 374       major = 1;
 375       minor = 5;
 376    }
 377    else if (ver_1_4) {
 378       major = 1;
 379       minor = 4;
 380    }
 381    else if (ver_1_3) {
 382       major = 1;
 383       minor = 3;
 384    }
 385    else {
 386       major = 1;
 387       minor = 2;
 388    }
 389
 390    version = major * 10 + minor;
 391
 392    if (api == API_OPENGL_CORE && version < 31)
 393       return 0;
 394
 395    return version;
 396 }
 397
 398 static GLuint
 399 compute_version_es1(const struct gl_extensions *extensions)
 400 {
 401    /* OpenGL ES 1.0 is derived from OpenGL 1.3 */
 402    const bool ver_1_0 = (extensions->ARB_texture_env_combine &&
 403                          extensions->ARB_texture_env_dot3);
 404    /* OpenGL ES 1.1 is derived from OpenGL 1.5 */
 405    const bool ver_1_1 = (ver_1_0 &&
 406                          extensions->EXT_point_parameters);
 407
 408    if (ver_1_1) {
 409       return 11;
 410    } else if (ver_1_0) {
 411       return 10;
 412    } else {
 413       return 0;
 414    }
 415 }
 416
 417 static GLuint
 418 compute_version_es2(const struct gl_extensions *extensions)
 419 {
 420    /* OpenGL ES 2.0 is derived from OpenGL 2.0 */
 421    const bool ver_2_0 = (extensions->ARB_texture_cube_map &&
 422                          extensions->EXT_blend_color &&
 423                          extensions->EXT_blend_func_separate &&
 424                          extensions->EXT_blend_minmax &&
 425                          extensions->ARB_vertex_shader &&
 426                          extensions->ARB_fragment_shader &&
 427                          extensions->ARB_texture_non_power_of_two &&
 428                          extensions->EXT_blend_equation_separate);
 429    /* FINISHME: This list isn't quite right. */
 430    const bool ver_3_0 = (extensions->ARB_half_float_vertex &&
 431                          extensions->ARB_internalformat_query &&
 432                          extensions->ARB_map_buffer_range &&
 433                          extensions->ARB_shader_texture_lod &&
 434                          extensions->ARB_texture_float &&
 435                          extensions->ARB_texture_rg &&
 436                          extensions->ARB_depth_buffer_float &&
 437                          extensions->EXT_draw_buffers2 &&
 438                          /* extensions->ARB_framebuffer_object && */
 439                          extensions->EXT_framebuffer_sRGB &&
 440                          extensions->EXT_packed_float &&
 441                          extensions->EXT_texture_array &&
 442                          extensions->EXT_texture_shared_exponent &&
 443                          extensions->EXT_transform_feedback &&
 444                          extensions->ARB_draw_instanced &&
 445                          extensions->ARB_uniform_buffer_object &&
 446                          extensions->EXT_texture_snorm &&
 447                          extensions->NV_primitive_restart &&
 448                          extensions->OES_depth_texture_cube_map);
 449    const bool ver_3_1 = (ver_3_0 &&
 450                          extensions->ARB_arrays_of_arrays &&
 451                          extensions->ARB_compute_shader &&
 452                          extensions->ARB_draw_indirect &&
 453                          false /*extensions->ARB_framebuffer_no_attachments*/ &&
 454                          extensions->ARB_shader_atomic_counters &&
 455                          extensions->ARB_shader_image_load_store &&
 456                          false /*extensions->ARB_shader_image_size*/ &&
 457                          false /*extensions->ARB_shader_storage_buffer_object*/ &&
 458                          extensions->ARB_shading_language_packing &&
 459                          extensions->ARB_stencil_texturing &&
 460                          extensions->ARB_gpu_shader5 &&
 461                          extensions->EXT_shader_integer_mix);
 462
 463    if (ver_3_1) {
 464       return 31;
 465    } else if (ver_3_0) {
 466       return 30;
 467    } else if (ver_2_0) {
 468       return 20;
 469    } else {
 470       return 0;
 471    }
 472 }
 473
 474 GLuint
 475 _mesa_get_version(const struct gl_extensions *extensions,
 476                   struct gl_constants *consts, gl_api api)
 477 {
 478    switch (api) {
 479    case API_OPENGL_COMPAT:
 480       /* Disable GLSL 1.40 and later for legacy contexts.
 481        * This disallows creation of the GL 3.1 compatibility context. */
 482       if (consts->GLSLVersion > 130) {
 483          consts->GLSLVersion = 130;
 484       }
 485       /* fall through */
 486    case API_OPENGL_CORE:
 487       return compute_version(extensions, consts, api);
 488    case API_OPENGLES:
 489       return compute_version_es1(extensions);
 490    case API_OPENGLES2:
 491       return compute_version_es2(extensions);
 492    }
 493    return 0;
 494 }
 495
 496 /**
 497  * Set the context's Version and VersionString fields.
 498  * This should only be called once as part of context initialization
 499  * or to perform version check for GLX_ARB_create_context_profile.
 500  */
 501 void
 502 _mesa_compute_version(struct gl_context *ctx)
 503 {
 504    if (ctx->Version)
 505       return;
 506
 507    ctx->Version = _mesa_get_version(&ctx->Extensions, &ctx->Const, ctx->API);
 508
 509    /* Make sure that the GLSL version lines up with the GL version. In some
 510     * cases it can be too high, e.g. if an extension is missing.
 511     */
 512    if (ctx->API == API_OPENGL_CORE) {
 513       switch (ctx->Version) {
 514       case 31:
 515          ctx->Const.GLSLVersion = 140;
 516          break;
 517       case 32:
 518          ctx->Const.GLSLVersion = 150;
 519          break;
 520       default:
 521          ctx->Const.GLSLVersion = ctx->Version * 10;
 522          break;
 523       }
 524    }
 525
 526    switch (ctx->API) {
 527    case API_OPENGL_COMPAT:
 528    case API_OPENGL_CORE:
 529       create_version_string(ctx, "");
 530       break;
 531
 532    case API_OPENGLES:
 533       if (!ctx->Version) {
 534          _mesa_problem(ctx, "Incomplete OpenGL ES 1.0 support.");
 535          return;
 536       }
 537       create_version_string(ctx, "OpenGL ES-CM ");
 538       break;
 539
 540    case API_OPENGLES2:
 541       if (!ctx->Version) {
 542          _mesa_problem(ctx, "Incomplete OpenGL ES 2.0 support.");
 543          return;
 544       }
 545       create_version_string(ctx, "OpenGL ES ");
 546       break;
 547    }
 548 }