path: root/mesalib/src/mesa/main/version.c

/*
 * Mesa 3-D graphics library
 *
 * Copyright (C) 2010  VMware, Inc.  All Rights Reserved.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included
 * in all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 * OTHER DEALINGS IN THE SOFTWARE.
 */


#include "imports.h"
#include "mtypes.h"
#include "version.h"
#include "git_sha1.h"

/**
 * Scans 'string' to see if it ends with 'ending'.
 */
static GLboolean
check_for_ending(const char *string, const char *ending)
{
   int len1, len2;

   len1 = strlen(string);
   len2 = strlen(ending);

   if (len2 > len1) {
      return GL_FALSE;
   }

   if (strcmp(string + (len1 - len2), ending) == 0) {
      return GL_TRUE;
   } else {
      return GL_FALSE;
   }
}

/**
 * Returns the gl override data
 *
 * version > 0 indicates there is an override requested
 * fwd_context is only valid if version > 0
 */
static void
get_gl_override(int *version, GLboolean *fwd_context)
{
   const char *env_var = "MESA_GL_VERSION_OVERRIDE";
   const char *version_str;
   int major, minor, n;
   static int override_version = -1;
   static GLboolean fc_suffix = GL_FALSE;

   if (override_version < 0) {
      override_version = 0;

      version_str = getenv(env_var);
      if (version_str) {
         fc_suffix = check_for_ending(version_str, "FC");

         n = sscanf(version_str, "%u.%u", &major, &minor);
         if (n != 2) {
            fprintf(stderr, "error: invalid value for %s: %s\n", env_var, version_str);
            override_version = 0;
         } else {
            override_version = major * 10 + minor;
            if (override_version < 30 && fc_suffix) {
               fprintf(stderr, "error: invalid value for %s: %s\n", env_var, version_str);
            }
         }
      }
   }

   *version = override_version;
   *fwd_context = fc_suffix;
}

/**
 * Builds the MESA version string.
 */
static void
create_version_string(struct gl_context *ctx, const char *prefix)
{
   static const int max = 100;

   ctx->VersionString = malloc(max);
   if (ctx->VersionString) {
      _mesa_snprintf(ctx->VersionString, max,
		     "%s%u.%u%s Mesa " PACKAGE_VERSION
#ifdef MESA_GIT_SHA1
		     " (" MESA_GIT_SHA1 ")"
#endif
		     ,
		     prefix,
		     ctx->Version / 10, ctx->Version % 10,
		     (ctx->API == API_OPENGL_CORE) ? " (Core Profile)" : ""
		     );
   }
}

/**
 * Override the context's version and/or API type if the
 * environment variable MESA_GL_VERSION_OVERRIDE is set.
 *
 * Example uses of MESA_GL_VERSION_OVERRIDE:
 *
 * 2.1: select a compatibility (non-Core) profile with GL version 2.1
 * 3.0: select a compatibility (non-Core) profile with GL version 3.0
 * 3.0FC: select a Core+Forward Compatible profile with GL version 3.0
 * 3.1: select a Core profile with GL version 3.1
 * 3.1FC: select a Core+Forward Compatible profile with GL version 3.1
 */
bool
_mesa_override_gl_version_contextless(struct gl_constants *consts,
                                      gl_api *apiOut, GLuint *versionOut)
{
   int version;
   GLboolean fwd_context;

   get_gl_override(&version, &fwd_context);

   if (version > 0) {
      *versionOut = version;
      if (version >= 30 && fwd_context) {
         *apiOut = API_OPENGL_CORE;
         consts->ContextFlags |= GL_CONTEXT_FLAG_FORWARD_COMPATIBLE_BIT;
      } else if (version >= 31) {
         *apiOut = API_OPENGL_CORE;
      } else {
         *apiOut = API_OPENGL_COMPAT;
      }
      return GL_TRUE;
   }
   return GL_FALSE;
}

void
_mesa_override_gl_version(struct gl_context *ctx)
{
   if (_mesa_override_gl_version_contextless(&ctx->Const, &ctx->API,
                                             &ctx->Version)) {
      create_version_string(ctx, "");
   }
}

/**
 * Returns the gl override value
 *
 * version > 0 indicates there is an override requested
 */
int
_mesa_get_gl_version_override(void)
{
   int version;
   GLboolean fwd_context;

   get_gl_override(&version, &fwd_context);

   return version;
}

/**
 * Override the context's GLSL version if the environment variable
 * MESA_GLSL_VERSION_OVERRIDE is set. Valid values for
 * MESA_GLSL_VERSION_OVERRIDE are integers, such as "130".
 */
void
_mesa_override_glsl_version(struct gl_constants *consts)
{
   const char *env_var = "MESA_GLSL_VERSION_OVERRIDE";
   const char *version;
   int n;

   version = getenv(env_var);
   if (!version) {
      return;
   }

   n = sscanf(version, "%u", &consts->GLSLVersion);
   if (n != 1) {
      fprintf(stderr, "error: invalid value for %s: %s\n", env_var, version);
      return;
   }
}

/**
 * Examine enabled GL extensions to determine GL version.
 */
static GLuint
compute_version(const struct gl_extensions *extensions,
                const struct gl_constants *consts, gl_api api)
{
   GLuint major, minor, version;

   const GLboolean ver_1_3 = (extensions->ARB_texture_border_clamp &&
                              extensions->ARB_texture_cube_map &&
                              extensions->ARB_texture_env_combine &&
                              extensions->ARB_texture_env_dot3);
   const GLboolean ver_1_4 = (ver_1_3 &&
                              extensions->ARB_depth_texture &&
                              extensions->ARB_shadow &&
                              extensions->ARB_texture_env_crossbar &&
                              extensions->EXT_blend_color &&
                              extensions->EXT_blend_func_separate &&
                              extensions->EXT_blend_minmax &&
                              extensions->EXT_point_parameters);
   const GLboolean ver_1_5 = (ver_1_4 &&
                              extensions->ARB_occlusion_query);
   const GLboolean ver_2_0 = (ver_1_5 &&
                              extensions->ARB_point_sprite &&
                              extensions->ARB_vertex_shader &&
                              extensions->ARB_fragment_shader &&
                              extensions->ARB_texture_non_power_of_two &&
                              extensions->EXT_blend_equation_separate &&

			      /* Technically, 2.0 requires the functionality
			       * of the EXT version.  Enable 2.0 if either
			       * extension is available, and assume that a
			       * driver that only exposes the ATI extension
			       * will fallback to software when necessary.
			       */
			      (extensions->EXT_stencil_two_side
			       || extensions->ATI_separate_stencil));
   const GLboolean ver_2_1 = (ver_2_0 &&
                              extensions->EXT_pixel_buffer_object &&
                              extensions->EXT_texture_sRGB);
   const GLboolean ver_3_0 = (ver_2_1 &&
                              consts->GLSLVersion >= 130 &&
                              (consts->MaxSamples >= 4 || consts->FakeSWMSAA) &&
                              (api == API_OPENGL_CORE ||
                               extensions->ARB_color_buffer_float) &&
                              extensions->ARB_depth_buffer_float &&
                              extensions->ARB_half_float_vertex &&
                              extensions->ARB_map_buffer_range &&
                              extensions->ARB_shader_texture_lod &&
                              extensions->ARB_texture_float &&
                              extensions->ARB_texture_rg &&
                              extensions->ARB_texture_compression_rgtc &&
                              extensions->EXT_draw_buffers2 &&
                              extensions->ARB_framebuffer_object &&
                              extensions->EXT_framebuffer_sRGB &&
                              extensions->EXT_packed_float &&
                              extensions->EXT_texture_array &&
                              extensions->EXT_texture_shared_exponent &&
                              extensions->EXT_transform_feedback &&
                              extensions->NV_conditional_render);
   const GLboolean ver_3_1 = (ver_3_0 &&
                              consts->GLSLVersion >= 140 &&
                              extensions->ARB_draw_instanced &&
                              extensions->ARB_texture_buffer_object &&
                              extensions->ARB_uniform_buffer_object &&
                              extensions->EXT_texture_snorm &&
                              extensions->NV_primitive_restart &&
                              extensions->NV_texture_rectangle &&
                              consts->Program[MESA_SHADER_VERTEX].MaxTextureImageUnits >= 16);
   const GLboolean ver_3_2 = (ver_3_1 &&
                              consts->GLSLVersion >= 150 &&
                              extensions->ARB_depth_clamp &&
                              extensions->ARB_draw_elements_base_vertex &&
                              extensions->ARB_fragment_coord_conventions &&
                              extensions->EXT_provoking_vertex &&
                              extensions->ARB_seamless_cube_map &&
                              extensions->ARB_sync &&
                              extensions->ARB_texture_multisample &&
                              extensions->EXT_vertex_array_bgra);
   const GLboolean ver_3_3 = (ver_3_2 &&
                              consts->GLSLVersion >= 330 &&
                              extensions->ARB_blend_func_extended &&
                              extensions->ARB_explicit_attrib_location &&
                              extensions->ARB_instanced_arrays &&
                              extensions->ARB_occlusion_query2 &&
                              extensions->ARB_shader_bit_encoding &&
                              extensions->ARB_texture_rgb10_a2ui &&
                              extensions->ARB_timer_query &&
                              extensions->ARB_vertex_type_2_10_10_10_rev &&
                              extensions->EXT_texture_swizzle);
                              /* ARB_sampler_objects is always enabled in mesa */

   if (ver_3_3) {
      major = 3;
      minor = 3;
   }
   else if (ver_3_2) {
      major = 3;
      minor = 2;
   }
   else if (ver_3_1) {
      major = 3;
      minor = 1;
   }
   else if (ver_3_0) {
      major = 3;
      minor = 0;
   }
   else if (ver_2_1) {
      major = 2;
      minor = 1;
   }
   else if (ver_2_0) {
      major = 2;
      minor = 0;
   }
   else if (ver_1_5) {
      major = 1;
      minor = 5;
   }
   else if (ver_1_4) {
      major = 1;
      minor = 4;
   }
   else if (ver_1_3) {
      major = 1;
      minor = 3;
   }
   else {
      major = 1;
      minor = 2;
   }

   version = major * 10 + minor;

   if (api == API_OPENGL_CORE && version < 31)
      return 0;

   return version;
}

static GLuint
compute_version_es1(const struct gl_extensions *extensions)
{
   /* OpenGL ES 1.0 is derived from OpenGL 1.3 */
   const GLboolean ver_1_0 = (extensions->ARB_texture_env_combine &&
                              extensions->ARB_texture_env_dot3);
   /* OpenGL ES 1.1 is derived from OpenGL 1.5 */
   const GLboolean ver_1_1 = (ver_1_0 &&
                              extensions->EXT_point_parameters);

   if (ver_1_1) {
      return 11;
   } else if (ver_1_0) {
      return 10;
   } else {
      return 0;
   }
}

static GLuint
compute_version_es2(const struct gl_extensions *extensions)
{
   /* OpenGL ES 2.0 is derived from OpenGL 2.0 */
   const GLboolean ver_2_0 = (extensions->ARB_texture_cube_map &&
                              extensions->EXT_blend_color &&
                              extensions->EXT_blend_func_separate &&
                              extensions->EXT_blend_minmax &&
                              extensions->ARB_vertex_shader &&
                              extensions->ARB_fragment_shader &&
                              extensions->ARB_texture_non_power_of_two &&
                              extensions->EXT_blend_equation_separate);
   /* FINISHME: This list isn't quite right. */
   const GLboolean ver_3_0 = (extensions->ARB_half_float_vertex &&
                              extensions->ARB_internalformat_query &&
                              extensions->ARB_map_buffer_range &&
                              extensions->ARB_shader_texture_lod &&
                              extensions->ARB_texture_float &&
                              extensions->ARB_texture_rg &&
                              extensions->ARB_texture_compression_rgtc &&
                              extensions->EXT_draw_buffers2 &&
                              /* extensions->ARB_framebuffer_object && */
                              extensions->EXT_framebuffer_sRGB &&
                              extensions->EXT_packed_float &&
                              extensions->EXT_texture_array &&
                              extensions->EXT_texture_shared_exponent &&
                              extensions->EXT_transform_feedback &&
                              extensions->NV_conditional_render &&
                              extensions->ARB_draw_instanced &&
                              extensions->ARB_uniform_buffer_object &&
                              extensions->EXT_texture_snorm &&
                              extensions->NV_primitive_restart &&
                              extensions->OES_depth_texture_cube_map);
   if (ver_3_0) {
      return 30;
   } else if (ver_2_0) {
      return 20;
   } else {
      return 0;
   }
}

GLuint
_mesa_get_version(const struct gl_extensions *extensions,
                  struct gl_constants *consts, gl_api api)
{
   switch (api) {
   case API_OPENGL_COMPAT:
      /* Disable GLSL 1.40 and later for legacy contexts.
       * This disallows creation of the GL 3.1 compatibility context. */
      if (consts->GLSLVersion > 130) {
         consts->GLSLVersion = 130;
      }
      /* fall through */
   case API_OPENGL_CORE:
      return compute_version(extensions, consts, api);
   case API_OPENGLES:
      return compute_version_es1(extensions);
   case API_OPENGLES2:
      return compute_version_es2(extensions);
   }
   return 0;
}

/**
 * Set the context's Version and VersionString fields.
 * This should only be called once as part of context initialization
 * or to perform version check for GLX_ARB_create_context_profile.
 */
void
_mesa_compute_version(struct gl_context *ctx)
{
   if (ctx->Version)
      return;

   ctx->Version = _mesa_get_version(&ctx->Extensions, &ctx->Const, ctx->API);

   switch (ctx->API) {
   case API_OPENGL_COMPAT:
   case API_OPENGL_CORE:
      create_version_string(ctx, "");
      break;

   case API_OPENGLES:
      if (!ctx->Version) {
         _mesa_problem(ctx, "Incomplete OpenGL ES 1.0 support.");
         return;
      }
      create_version_string(ctx, "OpenGL ES-CM ");
      break;

   case API_OPENGLES2:
      if (!ctx->Version) {
         _mesa_problem(ctx, "Incomplete OpenGL ES 2.0 support.");
         return;
      }
      create_version_string(ctx, "OpenGL ES ");
      break;
   }
}