src/mesa/main/extensions.h

   1 /**
   2  * \file extensions.h
   3  * Extension handling.
   4  *
   5  * \if subset
   6  * (No-op)
   7  *
   8  * \endif
   9  */
  10
  11 /*
  12  * Mesa 3-D graphics library
  13  *
  14  * Copyright (C) 1999-2006  Brian Paul   All Rights Reserved.
  15  *
  16  * Permission is hereby granted, free of charge, to any person obtaining a
  17  * copy of this software and associated documentation files (the "Software"),
  18  * to deal in the Software without restriction, including without limitation
  19  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  20  * and/or sell copies of the Software, and to permit persons to whom the
  21  * Software is furnished to do so, subject to the following conditions:
  22  *
  23  * The above copyright notice and this permission notice shall be included
  24  * in all copies or substantial portions of the Software.
  25  *
  26  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  27  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  28  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  29  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
  30  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  31  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  32  * OTHER DEALINGS IN THE SOFTWARE.
  33  */
  34
  35
  36 #ifndef _EXTENSIONS_H_
  37 #define _EXTENSIONS_H_
  38
  39 #include "glheader.h"
  40
  41 #ifdef __cplusplus
  42 extern "C" {
  43 #endif
  44
  45 struct gl_context;
  46 struct gl_extensions;
  47
  48 extern void _mesa_enable_sw_extensions(struct gl_context *ctx);
  49
  50 extern void _mesa_one_time_init_extension_overrides(struct gl_context *ctx);
  51
  52 extern void _mesa_init_extensions(struct gl_extensions *extentions);
  53
  54 extern GLubyte *_mesa_make_extension_string(struct gl_context *ctx);
  55
  56 extern void _mesa_override_extensions(struct gl_context *ctx);
  57
  58 extern GLuint
  59 _mesa_get_extension_count(struct gl_context *ctx);
  60
  61 extern const GLubyte *
  62 _mesa_get_enabled_extension(struct gl_context *ctx, GLuint index);
  63
  64
  65 /**
  66  * \brief An element of the \c extension_table.
  67  */
  68 struct mesa_extension {
  69    /** Name of extension, such as "GL_ARB_depth_clamp". */
  70    const char *name;
  71
  72    /** Offset (in bytes) of the corresponding member in struct gl_extensions. */
  73    size_t offset;
  74
  75    /** Minimum version the extension requires for the given API
  76     * (see gl_api defined in mtypes.h). The value is equal to:
  77     * 10 * major_version + minor_version
  78     */
  79    uint8_t version[API_OPENGL_LAST + 1];
  80
  81    /** Year the extension was proposed or approved.  Used to sort the
  82     * extension string chronologically. */
  83    uint16_t year;
  84 };
  85
  86 extern const struct mesa_extension _mesa_extension_table[];
  87
  88
  89 /* Generate enums for the functions below */
  90 enum {
  91 #define EXT(name_str, ...) MESA_EXTENSION_##name_str,
  92 #include "extensions_table.h"
  93 #undef EXT
  94 MESA_EXTENSION_COUNT
  95 };
  96
  97
  98 /** Checks if the context supports a user-facing extension */
  99 #define EXT(name_str, driver_cap, ...) \
 100 static inline bool \
 101 _mesa_has_##name_str(const struct gl_context *ctx) \
 102 { \
 103    return ctx->Extensions.driver_cap && (ctx->Extensions.Version >= \
 104           _mesa_extension_table[MESA_EXTENSION_##name_str].version[ctx->API]); \
 105 }
 106 #include "extensions_table.h"
 107 #undef EXT
 108
 109 /* Sometimes the driver wants to query the extension override status before
 110  * a context is created. These variables are filled with extension override
 111  * information before context creation.
 112  *
 113  * This can be useful during extension bring-up when an extension is
 114  * partially implemented, but cannot yet be advertised as supported.
 115  *
 116  * Use it with care and keep access read-only.
 117  */
 118 extern struct gl_extensions _mesa_extension_override_enables;
 119 extern struct gl_extensions _mesa_extension_override_disables;
 120
 121 #ifdef __cplusplus
 122 }
 123 #endif
 124
 125 #endif