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(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 126