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 "mtypes.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(void);
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
126