glxextensions.c revision f433fe015e903424d25673ebfe5dcb115381d753
1/*
2 * (C) Copyright IBM Corporation 2002, 2004
3 * All Rights Reserved.
4 *
5 * Permission is hereby granted, free of charge, to any person obtaining a
6 * copy of this software and associated documentation files (the "Software"),
7 * to deal in the Software without restriction, including without limitation
8 * on the rights to use, copy, modify, merge, publish, distribute, sub
9 * license, and/or sell copies of the Software, and to permit persons to whom
10 * the Software is furnished to do so, subject to the following conditions:
11 *
12 * The above copyright notice and this permission notice (including the next
13 * paragraph) shall be included in all copies or substantial portions of the
14 * Software.
15 *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.  IN NO EVENT SHALL
19 * THE COPYRIGHT HOLDERS AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM,
20 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
21 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
22 * USE OR OTHER DEALINGS IN THE SOFTWARE.
23 */
24
25/**
26 * \file glxextensions.c
27 *
28 * \author Ian Romanick <idr@us.ibm.com>
29 */
30
31#include "glxclient.h"
32#include <X11/extensions/extutil.h>
33#include <X11/extensions/Xext.h>
34#include <string.h>
35#include "glxextensions.h"
36
37
38#define SET_BIT(m,b)   (m[ (b) / 8 ] |=  (1U << ((b) % 8)))
39#define CLR_BIT(m,b)   (m[ (b) / 8 ] &= ~(1U << ((b) % 8)))
40#define IS_SET(m,b)    ((m[ (b) / 8 ] & (1U << ((b) % 8))) != 0)
41#define CONCAT(a,b) a ## b
42#define GLX(n) "GLX_" # n, 4 + sizeof( # n ) - 1, CONCAT(n,_bit)
43#define GL(n)  "GL_" # n,  3 + sizeof( # n ) - 1, GL_ ## n ## _bit
44#define VER(a,b)  a, b
45#define Y  1
46#define N  0
47#define EXT_ENABLED(bit,supported) (IS_SET( supported, bit ))
48
49
50struct extension_info
51{
52   const char *const name;
53   unsigned name_len;
54
55   unsigned char bit;
56
57   /* This is the lowest version of GLX that "requires" this extension.
58    * For example, GLX 1.3 requires SGIX_fbconfig, SGIX_pbuffer, and
59    * SGI_make_current_read.  If the extension is not required by any known
60    * version of GLX, use 0, 0.
61    */
62   unsigned char version_major;
63   unsigned char version_minor;
64   unsigned char client_support;
65   unsigned char direct_support;
66   unsigned char client_only;        /** Is the extension client-side only? */
67   unsigned char direct_only;        /** Is the extension for direct
68				      * contexts only?
69				      */
70};
71
72/* *INDENT-OFF* */
73static const struct extension_info known_glx_extensions[] = {
74#ifdef XCB_GLX_CREATE_CONTEXT_ATTRIBS_ARB
75   { GLX(ARB_create_context),          VER(0,0), Y, N, N, N },
76   { GLX(ARB_create_context_profile),  VER(0,0), Y, N, N, N },
77#else
78   { GLX(ARB_create_context),          VER(0,0), N, N, N, N },
79   { GLX(ARB_create_context_profile),  VER(0,0), N, N, N, N },
80#endif
81   { GLX(ARB_get_proc_address),        VER(1,4), Y, N, Y, N },
82   { GLX(ARB_multisample),             VER(1,4), Y, Y, N, N },
83   { GLX(ATI_pixel_format_float),      VER(0,0), N, N, N, N },
84   { GLX(EXT_import_context),          VER(0,0), Y, Y, N, N },
85   { GLX(EXT_visual_info),             VER(0,0), Y, Y, N, N },
86   { GLX(EXT_visual_rating),           VER(0,0), Y, Y, N, N },
87   { GLX(EXT_framebuffer_sRGB),        VER(0,0), Y, Y, N, N },
88#ifdef XCB_GLX_CREATE_CONTEXT_ATTRIBS_ARB
89   { GLX(EXT_create_context_es2_profile), VER(0,0), Y, N, N, Y },
90#else
91   { GLX(EXT_create_context_es2_profile), VER(0,0), N, N, N, N },
92#endif
93   { GLX(MESA_copy_sub_buffer),        VER(0,0), Y, N, N, N },
94   { GLX(MESA_multithread_makecurrent),VER(0,0), Y, N, Y, N },
95   { GLX(MESA_swap_control),           VER(0,0), Y, N, N, Y },
96   { GLX(NV_float_buffer),             VER(0,0), N, N, N, N },
97   { GLX(OML_swap_method),             VER(0,0), Y, Y, N, N },
98   { GLX(OML_sync_control),            VER(0,0), Y, N, N, Y },
99   { GLX(SGI_make_current_read),       VER(1,3), Y, N, N, N },
100   { GLX(SGI_swap_control),            VER(0,0), Y, N, N, N },
101   { GLX(SGI_video_sync),              VER(0,0), Y, N, N, Y },
102   { GLX(SGIS_multisample),            VER(0,0), Y, Y, N, N },
103   { GLX(SGIX_fbconfig),               VER(1,3), Y, Y, N, N },
104   { GLX(SGIX_pbuffer),                VER(1,3), Y, Y, N, N },
105   { GLX(SGIX_swap_barrier),           VER(0,0), N, N, N, N },
106   { GLX(SGIX_swap_group),             VER(0,0), N, N, N, N },
107   { GLX(SGIX_visual_select_group),    VER(0,0), Y, Y, N, N },
108   { GLX(EXT_texture_from_pixmap),     VER(0,0), Y, N, N, N },
109   { GLX(INTEL_swap_event),            VER(0,0), Y, N, N, N },
110   { NULL }
111};
112
113static const struct extension_info known_gl_extensions[] = {
114   { GL(ARB_depth_texture),              VER(1,4), Y, N, N, N },
115   { GL(ARB_draw_buffers),               VER(0,0), Y, N, N, N },
116   { GL(ARB_fragment_program),           VER(0,0), Y, N, N, N },
117   { GL(ARB_fragment_program_shadow),    VER(0,0), Y, N, N, N },
118   { GL(ARB_framebuffer_object),         VER(0,0), Y, N, N, N },
119   { GL(ARB_imaging),                    VER(0,0), Y, N, N, N },
120   { GL(ARB_multisample),                VER(1,3), Y, N, N, N },
121   { GL(ARB_multitexture),               VER(1,3), Y, N, N, N },
122   { GL(ARB_occlusion_query),            VER(1,5), Y, N, N, N },
123   { GL(ARB_point_parameters),           VER(1,4), Y, N, N, N },
124   { GL(ARB_point_sprite),               VER(0,0), Y, N, N, N },
125   { GL(ARB_shadow),                     VER(1,4), Y, N, N, N },
126   { GL(ARB_shadow_ambient),             VER(0,0), Y, N, N, N },
127   { GL(ARB_texture_border_clamp),       VER(1,3), Y, N, N, N },
128   { GL(ARB_texture_compression),        VER(1,3), Y, N, N, N },
129   { GL(ARB_texture_cube_map),           VER(1,3), Y, N, N, N },
130   { GL(ARB_texture_env_add),            VER(1,3), Y, N, N, N },
131   { GL(ARB_texture_env_combine),        VER(1,3), Y, N, N, N },
132   { GL(ARB_texture_env_crossbar),       VER(1,4), Y, N, N, N },
133   { GL(ARB_texture_env_dot3),           VER(1,3), Y, N, N, N },
134   { GL(ARB_texture_mirrored_repeat),    VER(1,4), Y, N, N, N },
135   { GL(ARB_texture_non_power_of_two),   VER(1,5), Y, N, N, N },
136   { GL(ARB_texture_rectangle),          VER(0,0), Y, N, N, N },
137   { GL(ARB_texture_rg),                 VER(0,0), Y, N, N, N },
138   { GL(ARB_transpose_matrix),           VER(1,3), Y, N, Y, N },
139   { GL(ARB_vertex_buffer_object),       VER(1,5), N, N, N, N },
140   { GL(ARB_vertex_program),             VER(0,0), Y, N, N, N },
141   { GL(ARB_window_pos),                 VER(1,4), Y, N, N, N },
142   { GL(EXT_abgr),                       VER(0,0), Y, N, N, N },
143   { GL(EXT_bgra),                       VER(1,2), Y, N, N, N },
144   { GL(EXT_blend_color),                VER(1,4), Y, N, N, N },
145   { GL(EXT_blend_equation_separate),    VER(0,0), Y, N, N, N },
146   { GL(EXT_blend_func_separate),        VER(1,4), Y, N, N, N },
147   { GL(EXT_blend_logic_op),             VER(1,4), Y, N, N, N },
148   { GL(EXT_blend_minmax),               VER(1,4), Y, N, N, N },
149   { GL(EXT_blend_subtract),             VER(1,4), Y, N, N, N },
150   { GL(EXT_clip_volume_hint),           VER(0,0), Y, N, N, N },
151   { GL(EXT_compiled_vertex_array),      VER(0,0), N, N, N, N },
152   { GL(EXT_convolution),                VER(0,0), N, N, N, N },
153   { GL(EXT_copy_texture),               VER(1,1), Y, N, N, N },
154   { GL(EXT_cull_vertex),                VER(0,0), N, N, N, N },
155   { GL(EXT_depth_bounds_test),          VER(0,0), N, N, N, N },
156   { GL(EXT_draw_range_elements),        VER(1,2), Y, N, Y, N },
157   { GL(EXT_fog_coord),                  VER(1,4), Y, N, N, N },
158   { GL(EXT_framebuffer_blit),           VER(0,0), Y, N, N, N },
159   { GL(EXT_framebuffer_multisample),    VER(0,0), Y, N, N, N },
160   { GL(EXT_framebuffer_object),         VER(0,0), Y, N, N, N },
161   { GL(EXT_framebuffer_sRGB),           VER(0,0), Y, N, N, N },
162   { GL(EXT_multi_draw_arrays),          VER(1,4), Y, N, Y, N },
163   { GL(EXT_packed_depth_stencil),       VER(0,0), Y, N, N, N },
164   { GL(EXT_packed_pixels),              VER(1,2), Y, N, N, N },
165   { GL(EXT_paletted_texture),           VER(0,0), Y, N, N, N },
166   { GL(EXT_pixel_buffer_object),        VER(0,0), N, N, N, N },
167   { GL(EXT_point_parameters),           VER(1,4), Y, N, N, N },
168   { GL(EXT_polygon_offset),             VER(1,1), Y, N, N, N },
169   { GL(EXT_rescale_normal),             VER(1,2), Y, N, N, N },
170   { GL(EXT_secondary_color),            VER(1,4), Y, N, N, N },
171   { GL(EXT_separate_specular_color),    VER(1,2), Y, N, N, N },
172   { GL(EXT_shadow_funcs),               VER(1,5), Y, N, N, N },
173   { GL(EXT_shared_texture_palette),     VER(0,0), Y, N, N, N },
174   { GL(EXT_stencil_two_side),           VER(0,0), Y, N, N, N },
175   { GL(EXT_stencil_wrap),               VER(1,4), Y, N, N, N },
176   { GL(EXT_subtexture),                 VER(1,1), Y, N, N, N },
177   { GL(EXT_texture),                    VER(1,1), Y, N, N, N },
178   { GL(EXT_texture3D),                  VER(1,2), Y, N, N, N },
179   { GL(EXT_texture_compression_dxt1),   VER(0,0), Y, N, N, N },
180   { GL(EXT_texture_compression_s3tc),   VER(0,0), Y, N, N, N },
181   { GL(EXT_texture_edge_clamp),         VER(1,2), Y, N, N, N },
182   { GL(EXT_texture_env_add),            VER(1,3), Y, N, N, N },
183   { GL(EXT_texture_env_combine),        VER(1,3), Y, N, N, N },
184   { GL(EXT_texture_env_dot3),           VER(0,0), Y, N, N, N },
185   { GL(EXT_texture_filter_anisotropic), VER(0,0), Y, N, N, N },
186   { GL(EXT_texture_lod),                VER(1,2), Y, N, N, N },
187   { GL(EXT_texture_lod_bias),           VER(1,4), Y, N, N, N },
188   { GL(EXT_texture_mirror_clamp),       VER(0,0), Y, N, N, N },
189   { GL(EXT_texture_object),             VER(1,1), Y, N, N, N },
190   { GL(EXT_texture_rectangle),          VER(0,0), Y, N, N, N },
191   { GL(EXT_vertex_array),               VER(0,0), Y, N, N, N },
192   { GL(3DFX_texture_compression_FXT1),  VER(0,0), Y, N, N, N },
193   { GL(APPLE_packed_pixels),            VER(1,2), Y, N, N, N },
194   { GL(APPLE_ycbcr_422),                VER(0,0), Y, N, N, N },
195   { GL(ATI_draw_buffers),               VER(0,0), Y, N, N, N },
196   { GL(ATI_text_fragment_shader),       VER(0,0), Y, N, N, N },
197   { GL(ATI_texture_env_combine3),       VER(0,0), Y, N, N, N },
198   { GL(ATI_texture_float),              VER(0,0), Y, N, N, N },
199   { GL(ATI_texture_mirror_once),        VER(0,0), Y, N, N, N },
200   { GL(ATIX_texture_env_combine3),      VER(0,0), Y, N, N, N },
201   { GL(HP_convolution_border_modes),    VER(0,0), Y, N, N, N },
202   { GL(HP_occlusion_test),              VER(0,0), Y, N, N, N },
203   { GL(IBM_cull_vertex),                VER(0,0), Y, N, N, N },
204   { GL(IBM_pixel_filter_hint),          VER(0,0), Y, N, N, N },
205   { GL(IBM_rasterpos_clip),             VER(0,0), Y, N, N, N },
206   { GL(IBM_texture_clamp_nodraw),       VER(0,0), Y, N, N, N },
207   { GL(IBM_texture_mirrored_repeat),    VER(0,0), Y, N, N, N },
208   { GL(INGR_blend_func_separate),       VER(0,0), Y, N, N, N },
209   { GL(INGR_interlace_read),            VER(0,0), Y, N, N, N },
210   { GL(MESA_pack_invert),               VER(0,0), Y, N, N, N },
211   { GL(MESA_ycbcr_texture),             VER(0,0), Y, N, N, N },
212   { GL(NV_blend_square),                VER(1,4), Y, N, N, N },
213   { GL(NV_copy_depth_to_color),         VER(0,0), Y, N, N, N },
214   { GL(NV_depth_clamp),                 VER(0,0), Y, N, N, N },
215   { GL(NV_fog_distance),                VER(0,0), Y, N, N, N },
216   { GL(NV_fragment_program),            VER(0,0), Y, N, N, N },
217   { GL(NV_fragment_program_option),     VER(0,0), Y, N, N, N },
218   { GL(NV_fragment_program2),           VER(0,0), Y, N, N, N },
219   { GL(NV_light_max_exponent),          VER(0,0), Y, N, N, N },
220   { GL(NV_multisample_filter_hint),     VER(0,0), Y, N, N, N },
221   { GL(NV_packed_depth_stencil),        VER(0,0), Y, N, N, N },
222   { GL(NV_point_sprite),                VER(0,0), Y, N, N, N },
223   { GL(NV_texgen_reflection),           VER(0,0), Y, N, N, N },
224   { GL(NV_texture_compression_vtc),     VER(0,0), Y, N, N, N },
225   { GL(NV_texture_env_combine4),        VER(0,0), Y, N, N, N },
226   { GL(NV_texture_rectangle),           VER(0,0), Y, N, N, N },
227   { GL(NV_vertex_program),              VER(0,0), Y, N, N, N },
228   { GL(NV_vertex_program1_1),           VER(0,0), Y, N, N, N },
229   { GL(NV_vertex_program2),             VER(0,0), Y, N, N, N },
230   { GL(NV_vertex_program2_option),      VER(0,0), Y, N, N, N },
231   { GL(NV_vertex_program3),             VER(0,0), Y, N, N, N },
232   { GL(OES_read_format),                VER(0,0), Y, N, N, N },
233   { GL(OES_compressed_paletted_texture),VER(0,0), Y, N, N, N },
234   { GL(SGI_color_matrix),               VER(0,0), Y, N, N, N },
235   { GL(SGI_color_table),                VER(0,0), Y, N, N, N },
236   { GL(SGI_texture_color_table),        VER(0,0), Y, N, N, N },
237   { GL(SGIS_generate_mipmap),           VER(1,4), Y, N, N, N },
238   { GL(SGIS_multisample),               VER(0,0), Y, N, N, N },
239   { GL(SGIS_texture_border_clamp),      VER(1,3), Y, N, N, N },
240   { GL(SGIS_texture_edge_clamp),        VER(1,2), Y, N, N, N },
241   { GL(SGIS_texture_lod),               VER(1,2), Y, N, N, N },
242   { GL(SGIX_blend_alpha_minmax),        VER(0,0), Y, N, N, N },
243   { GL(SGIX_clipmap),                   VER(0,0), Y, N, N, N },
244   { GL(SGIX_depth_texture),             VER(0,0), Y, N, N, N },
245   { GL(SGIX_fog_offset),                VER(0,0), Y, N, N, N },
246   { GL(SGIX_shadow),                    VER(0,0), Y, N, N, N },
247   { GL(SGIX_shadow_ambient),            VER(0,0), Y, N, N, N },
248   { GL(SGIX_texture_coordinate_clamp),  VER(0,0), Y, N, N, N },
249   { GL(SGIX_texture_lod_bias),          VER(0,0), Y, N, N, N },
250   { GL(SGIX_texture_range),             VER(0,0), Y, N, N, N },
251   { GL(SGIX_texture_scale_bias),        VER(0,0), Y, N, N, N },
252   { GL(SGIX_vertex_preclip),            VER(0,0), Y, N, N, N },
253   { GL(SGIX_vertex_preclip_hint),       VER(0,0), Y, N, N, N },
254   { GL(SGIX_ycrcb),                     VER(0,0), Y, N, N, N },
255   { GL(SUN_convolution_border_modes),   VER(0,0), Y, N, N, N },
256   { GL(SUN_multi_draw_arrays),          VER(0,0), Y, N, Y, N },
257   { GL(SUN_slice_accum),                VER(0,0), Y, N, N, N },
258   { NULL }
259};
260/* *INDENT-ON* */
261
262
263/* global bit-fields of available extensions and their characteristics */
264static unsigned char client_glx_support[8];
265static unsigned char client_glx_only[8];
266static unsigned char direct_glx_only[8];
267static unsigned char client_gl_support[__GL_EXT_BYTES];
268static unsigned char client_gl_only[__GL_EXT_BYTES];
269
270/**
271 * Bits representing the set of extensions that are enabled by default in all
272 * direct rendering drivers.
273 */
274static unsigned char direct_glx_support[8];
275
276/**
277 * Highest core GL version that can be supported for indirect rendering.
278 */
279static const unsigned gl_major = 1;
280static const unsigned gl_minor = 4;
281
282/* client extensions string */
283static const char *__glXGLXClientExtensions = NULL;
284
285static void __glXExtensionsCtr(void);
286static void __glXExtensionsCtrScreen(struct glx_screen * psc);
287static void __glXProcessServerString(const struct extension_info *ext,
288                                     const char *server_string,
289                                     unsigned char *server_support);
290
291/**
292 * Set the state of a GLX extension.
293 *
294 * \param name      Name of the extension.
295 * \param name_len  Length, in characters, of the extension name.
296 * \param state     New state (either enabled or disabled) of the extension.
297 * \param supported Table in which the state of the extension is to be set.
298 */
299static void
300set_glx_extension(const struct extension_info *ext,
301                  const char *name, unsigned name_len, GLboolean state,
302                  unsigned char *supported)
303{
304   unsigned i;
305
306
307   for (i = 0; ext[i].name != NULL; i++) {
308      if ((name_len == ext[i].name_len)
309          && (strncmp(ext[i].name, name, name_len) == 0)) {
310         if (state) {
311            SET_BIT(supported, ext[i].bit);
312         }
313         else {
314            CLR_BIT(supported, ext[i].bit);
315         }
316
317         return;
318      }
319   }
320}
321
322
323#define NUL '\0'
324#define SEPARATOR ' '
325
326/**
327 * Convert the server's extension string to a bit-field.
328 *
329 * \param server_string   GLX extension string from the server.
330 * \param server_support  Bit-field of supported extensions.
331 *
332 * \note
333 * This function is used to process both GLX and GL extension strings.  The
334 * bit-fields used to track each of these have different sizes.  Therefore,
335 * the data pointed by \c server_support must be preinitialized to zero.
336 */
337static void
338__glXProcessServerString(const struct extension_info *ext,
339                         const char *server_string,
340                         unsigned char *server_support)
341{
342   unsigned base;
343   unsigned len;
344
345   for (base = 0; server_string[base] != NUL; /* empty */ ) {
346      /* Determine the length of the next extension name.
347       */
348      for (len = 0; (server_string[base + len] != SEPARATOR)
349           && (server_string[base + len] != NUL); len++) {
350         /* empty */
351      }
352
353      /* Set the bit for the extension in the server_support table.
354       */
355      set_glx_extension(ext, &server_string[base], len, GL_TRUE,
356                        server_support);
357
358
359      /* Advance to the next extension string.  This means that we skip
360       * over the previous string and any trialing white-space.
361       */
362      for (base += len; (server_string[base] == SEPARATOR)
363           && (server_string[base] != NUL); base++) {
364         /* empty */
365      }
366   }
367}
368
369void
370__glXEnableDirectExtension(struct glx_screen * psc, const char *name)
371{
372   __glXExtensionsCtr();
373   __glXExtensionsCtrScreen(psc);
374
375   set_glx_extension(known_glx_extensions,
376                     name, strlen(name), GL_TRUE, psc->direct_support);
377}
378
379/**
380 * Initialize global extension support tables.
381 */
382
383static void
384__glXExtensionsCtr(void)
385{
386   unsigned i;
387   static GLboolean ext_list_first_time = GL_TRUE;
388
389
390   if (ext_list_first_time) {
391      ext_list_first_time = GL_FALSE;
392
393      (void) memset(client_glx_support, 0, sizeof(client_glx_support));
394      (void) memset(direct_glx_support, 0, sizeof(direct_glx_support));
395      (void) memset(client_glx_only, 0, sizeof(client_glx_only));
396      (void) memset(direct_glx_only, 0, sizeof(direct_glx_only));
397
398      (void) memset(client_gl_support, 0, sizeof(client_gl_support));
399      (void) memset(client_gl_only, 0, sizeof(client_gl_only));
400
401      for (i = 0; known_glx_extensions[i].name != NULL; i++) {
402         const unsigned bit = known_glx_extensions[i].bit;
403
404         if (known_glx_extensions[i].client_support) {
405            SET_BIT(client_glx_support, bit);
406         }
407
408         if (known_glx_extensions[i].direct_support) {
409            SET_BIT(direct_glx_support, bit);
410         }
411
412         if (known_glx_extensions[i].client_only) {
413            SET_BIT(client_glx_only, bit);
414         }
415
416         if (known_glx_extensions[i].direct_only) {
417            SET_BIT(direct_glx_only, bit);
418         }
419      }
420
421      for (i = 0; known_gl_extensions[i].name != NULL; i++) {
422         const unsigned bit = known_gl_extensions[i].bit;
423
424         if (known_gl_extensions[i].client_support) {
425            SET_BIT(client_gl_support, bit);
426         }
427
428         if (known_gl_extensions[i].client_only) {
429            SET_BIT(client_gl_only, bit);
430         }
431      }
432
433#if 0
434      fprintf(stderr, "[%s:%u] Maximum client library version: %u.%u\n",
435              __func__, __LINE__, gl_major, gl_minor);
436#endif
437   }
438}
439
440
441/**
442 * Make sure that per-screen direct-support table is initialized.
443 *
444 * \param psc  Pointer to GLX per-screen record.
445 */
446
447static void
448__glXExtensionsCtrScreen(struct glx_screen * psc)
449{
450   if (psc->ext_list_first_time) {
451      psc->ext_list_first_time = GL_FALSE;
452      (void) memcpy(psc->direct_support, direct_glx_support,
453                    sizeof(direct_glx_support));
454   }
455}
456
457
458/**
459 * Check if a certain extension is enabled on a given screen.
460 *
461 * \param psc  Pointer to GLX per-screen record.
462 * \param bit  Bit index in the direct-support table.
463 * \returns If the extension bit is enabled for the screen, \c GL_TRUE is
464 *          returned.  If the extension bit is not enabled or if \c psc is
465 *          \c NULL, then \c GL_FALSE is returned.
466 */
467GLboolean
468__glXExtensionBitIsEnabled(struct glx_screen * psc, unsigned bit)
469{
470   GLboolean enabled = GL_FALSE;
471
472   if (psc != NULL) {
473      __glXExtensionsCtr();
474      __glXExtensionsCtrScreen(psc);
475      enabled = EXT_ENABLED(bit, psc->direct_support);
476   }
477
478   return enabled;
479}
480
481
482/**
483 * Check if a certain extension is enabled in a given context.
484 *
485 */
486GLboolean
487__glExtensionBitIsEnabled(struct glx_context *gc, unsigned bit)
488{
489   GLboolean enabled = GL_FALSE;
490
491   if (gc != NULL) {
492      enabled = EXT_ENABLED(bit, gc->gl_extension_bits);
493   }
494
495   return enabled;
496}
497
498
499
500/**
501 * Convert a bit-field to a string of supported extensions.
502 */
503static char *
504__glXGetStringFromTable(const struct extension_info *ext,
505                        const unsigned char *supported)
506{
507   unsigned i;
508   unsigned ext_str_len;
509   char *ext_str;
510   char *point;
511
512
513   ext_str_len = 0;
514   for (i = 0; ext[i].name != NULL; i++) {
515      if (EXT_ENABLED(ext[i].bit, supported)) {
516         ext_str_len += ext[i].name_len + 1;
517      }
518   }
519
520   ext_str = Xmalloc(ext_str_len + 1);
521   if (ext_str != NULL) {
522      point = ext_str;
523
524      for (i = 0; ext[i].name != NULL; i++) {
525         if (EXT_ENABLED(ext[i].bit, supported)) {
526            (void) memcpy(point, ext[i].name, ext[i].name_len);
527            point += ext[i].name_len;
528
529            *point = ' ';
530            point++;
531         }
532      }
533
534      *point = '\0';
535   }
536
537   return ext_str;
538}
539
540
541/**
542 * Get the string of client library supported extensions.
543 */
544const char *
545__glXGetClientExtensions(void)
546{
547   if (__glXGLXClientExtensions == NULL) {
548      __glXExtensionsCtr();
549      __glXGLXClientExtensions = __glXGetStringFromTable(known_glx_extensions,
550                                                         client_glx_support);
551   }
552
553   return __glXGLXClientExtensions;
554}
555
556
557/**
558 * Calculate the list of application usable extensions.  The resulting
559 * string is stored in \c psc->effectiveGLXexts.
560 *
561 * \param psc                        Pointer to GLX per-screen record.
562 * \param display_is_direct_capable  True if the display is capable of
563 *                                   direct rendering.
564 * \param minor_version              GLX minor version from the server.
565 */
566
567void
568__glXCalculateUsableExtensions(struct glx_screen * psc,
569                               GLboolean display_is_direct_capable,
570                               int minor_version)
571{
572   unsigned char server_support[8];
573   unsigned char usable[8];
574   unsigned i;
575
576   __glXExtensionsCtr();
577   __glXExtensionsCtrScreen(psc);
578
579   (void) memset(server_support, 0, sizeof(server_support));
580   __glXProcessServerString(known_glx_extensions,
581                            psc->serverGLXexts, server_support);
582
583
584   /* This is a hack.  Some servers support GLX 1.3 but don't export
585    * all of the extensions implied by GLX 1.3.  If the server claims
586    * support for GLX 1.3, enable support for the extensions that can be
587    * "emulated" as well.
588    */
589#ifndef GLX_USE_APPLEGL
590   if (minor_version >= 3) {
591      SET_BIT(server_support, EXT_visual_info_bit);
592      SET_BIT(server_support, EXT_visual_rating_bit);
593      SET_BIT(server_support, SGI_make_current_read_bit);
594      SET_BIT(server_support, SGIX_fbconfig_bit);
595      SET_BIT(server_support, SGIX_pbuffer_bit);
596
597      /* This one is a little iffy.  GLX 1.3 doesn't incorporate all of this
598       * extension.  However, the only part that is not strictly client-side
599       * is shared.  That's the glXQueryContext / glXQueryContextInfoEXT
600       * function.
601       */
602
603      SET_BIT(server_support, EXT_import_context_bit);
604   }
605#endif
606
607   /* An extension is supported if the client-side (i.e., libGL) supports
608    * it and the "server" supports it.  In this case that means that either
609    * the true server supports it or it is only for direct-rendering and
610    * the direct rendering driver supports it.
611    *
612    * If the display is not capable of direct rendering, then the extension
613    * is enabled if and only if the client-side library and the server
614    * support it.
615    */
616
617   if (display_is_direct_capable) {
618      for (i = 0; i < 8; i++) {
619         usable[i] = (client_glx_support[i] & client_glx_only[i])
620            | (client_glx_support[i] & psc->direct_support[i] &
621               server_support[i])
622            | (client_glx_support[i] & psc->direct_support[i] &
623               direct_glx_only[i]);
624      }
625   }
626   else {
627      for (i = 0; i < 8; i++) {
628         usable[i] = (client_glx_support[i] & client_glx_only[i])
629            | (client_glx_support[i] & server_support[i]);
630      }
631   }
632
633   /* This hack is necessary because GLX_ARB_create_context_profile depends on
634    * server support, but GLX_EXT_create_context_es2_profile is direct-only.
635    * Without this hack, it would be possible to advertise
636    * GLX_EXT_create_context_es2_profile without
637    * GLX_ARB_create_context_profile.  That would be a problem.
638    */
639   if (!IS_SET(server_support, ARB_create_context_profile_bit)) {
640      CLR_BIT(usable, EXT_create_context_es2_profile_bit);
641   }
642
643   psc->effectiveGLXexts = __glXGetStringFromTable(known_glx_extensions,
644                                                   usable);
645}
646
647
648/**
649 * Calculate the list of application usable extensions.  The resulting
650 * string is stored in \c gc->extensions.
651 *
652 * \param gc             Pointer to GLX context.
653 * \param server_string  Extension string from the server.
654 * \param major_version  GL major version from the server.
655 * \param minor_version  GL minor version from the server.
656 */
657
658void
659__glXCalculateUsableGLExtensions(struct glx_context * gc,
660                                 const char *server_string,
661                                 int major_version, int minor_version)
662{
663   unsigned char server_support[__GL_EXT_BYTES];
664   unsigned char usable[__GL_EXT_BYTES];
665   unsigned i;
666
667
668   __glXExtensionsCtr();
669
670   (void) memset(server_support, 0, sizeof(server_support));
671   __glXProcessServerString(known_gl_extensions, server_string,
672                            server_support);
673
674
675   /* Handle lazy servers that don't export all the extensions strings that
676    * are part of the GL core version that they support.
677    */
678
679   for (i = 0; i < __GL_EXT_BYTES; i++) {
680      if ((known_gl_extensions[i].version_major != 0)
681          && ((major_version > known_gl_extensions[i].version_major)
682              || ((major_version == known_gl_extensions[i].version_major)
683                  && (minor_version >=
684                      known_gl_extensions[i].version_minor)))) {
685         SET_BIT(server_support, known_gl_extensions[i].bit);
686      }
687   }
688
689
690   /* An extension is supported if the client-side (i.e., libGL) supports
691    * it and the server supports it or the client-side library supports it
692    * and it only needs client-side support.
693    */
694
695   for (i = 0; i < __GL_EXT_BYTES; i++) {
696      usable[i] = (client_gl_support[i] & client_gl_only[i])
697         | (client_gl_support[i] & server_support[i]);
698   }
699
700   gc->extensions = (unsigned char *)
701      __glXGetStringFromTable(known_gl_extensions, usable);
702   (void) memcpy(gc->gl_extension_bits, usable, sizeof(usable));
703}
704
705
706/**
707 * Calculates the maximum core GL version that can be supported for indirect
708 * rendering.
709 */
710void
711__glXGetGLVersion(int *major_version, int *minor_version)
712{
713   __glXExtensionsCtr();
714   *major_version = gl_major;
715   *minor_version = gl_minor;
716}
717
718
719/**
720 * Get a string representing the set of extensions supported by the client
721 * library.  This is currently only used to send the list of extensions
722 * supported by the client to the server.
723 */
724char *
725__glXGetClientGLExtensionString(void)
726{
727   __glXExtensionsCtr();
728   return __glXGetStringFromTable(known_gl_extensions, client_gl_support);
729}
730