• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Mesa 3-D graphics library
3  *
4  * Copyright (C) 1999-2006  Brian Paul   All Rights Reserved.
5  *
6  * Permission is hereby granted, free of charge, to any person obtaining a
7  * copy of this software and associated documentation files (the "Software"),
8  * to deal in the Software without restriction, including without limitation
9  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
10  * and/or sell copies of the Software, and to permit persons to whom the
11  * Software is furnished to do so, subject to the following conditions:
12  *
13  * The above copyright notice and this permission notice shall be included
14  * in all copies or substantial portions of the Software.
15  *
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
17  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
19  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
20  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
21  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
22  * OTHER DEALINGS IN THE SOFTWARE.
23  */
24 
25 
26 #ifndef GLX_H
27 #define GLX_H
28 
29 
30 #include <X11/Xlib.h>
31 #include <X11/Xutil.h>
32 #include <GL/gl.h>
33 
34 
35 #if defined(USE_MGL_NAMESPACE)
36 #include "glx_mangle.h"
37 #endif
38 
39 
40 #ifdef __cplusplus
41 extern "C" {
42 #endif
43 
44 
45 #define GLX_VERSION_1_1		1
46 #define GLX_VERSION_1_2		1
47 #define GLX_VERSION_1_3		1
48 #define GLX_VERSION_1_4		1
49 
50 #define GLX_EXTENSION_NAME   "GLX"
51 
52 
53 
54 /*
55  * Tokens for glXChooseVisual and glXGetConfig:
56  */
57 #define GLX_USE_GL		1
58 #define GLX_BUFFER_SIZE		2
59 #define GLX_LEVEL		3
60 #define GLX_RGBA		4
61 #define GLX_DOUBLEBUFFER	5
62 #define GLX_STEREO		6
63 #define GLX_AUX_BUFFERS		7
64 #define GLX_RED_SIZE		8
65 #define GLX_GREEN_SIZE		9
66 #define GLX_BLUE_SIZE		10
67 #define GLX_ALPHA_SIZE		11
68 #define GLX_DEPTH_SIZE		12
69 #define GLX_STENCIL_SIZE	13
70 #define GLX_ACCUM_RED_SIZE	14
71 #define GLX_ACCUM_GREEN_SIZE	15
72 #define GLX_ACCUM_BLUE_SIZE	16
73 #define GLX_ACCUM_ALPHA_SIZE	17
74 
75 
76 /*
77  * Error codes returned by glXGetConfig:
78  */
79 #define GLX_BAD_SCREEN		1
80 #define GLX_BAD_ATTRIBUTE	2
81 #define GLX_NO_EXTENSION	3
82 #define GLX_BAD_VISUAL		4
83 #define GLX_BAD_CONTEXT		5
84 #define GLX_BAD_VALUE       	6
85 #define GLX_BAD_ENUM		7
86 
87 
88 /*
89  * GLX 1.1 and later:
90  */
91 #define GLX_VENDOR		1
92 #define GLX_VERSION		2
93 #define GLX_EXTENSIONS 		3
94 
95 
96 /*
97  * GLX 1.3 and later:
98  */
99 #define GLX_CONFIG_CAVEAT		0x20
100 #define GLX_DONT_CARE			0xFFFFFFFF
101 #define GLX_X_VISUAL_TYPE		0x22
102 #define GLX_TRANSPARENT_TYPE		0x23
103 #define GLX_TRANSPARENT_INDEX_VALUE	0x24
104 #define GLX_TRANSPARENT_RED_VALUE	0x25
105 #define GLX_TRANSPARENT_GREEN_VALUE	0x26
106 #define GLX_TRANSPARENT_BLUE_VALUE	0x27
107 #define GLX_TRANSPARENT_ALPHA_VALUE	0x28
108 #define GLX_WINDOW_BIT			0x00000001
109 #define GLX_PIXMAP_BIT			0x00000002
110 #define GLX_PBUFFER_BIT			0x00000004
111 #define GLX_AUX_BUFFERS_BIT		0x00000010
112 #define GLX_FRONT_LEFT_BUFFER_BIT	0x00000001
113 #define GLX_FRONT_RIGHT_BUFFER_BIT	0x00000002
114 #define GLX_BACK_LEFT_BUFFER_BIT	0x00000004
115 #define GLX_BACK_RIGHT_BUFFER_BIT	0x00000008
116 #define GLX_DEPTH_BUFFER_BIT		0x00000020
117 #define GLX_STENCIL_BUFFER_BIT		0x00000040
118 #define GLX_ACCUM_BUFFER_BIT		0x00000080
119 #define GLX_NONE			0x8000
120 #define GLX_SLOW_CONFIG			0x8001
121 #define GLX_TRUE_COLOR			0x8002
122 #define GLX_DIRECT_COLOR		0x8003
123 #define GLX_PSEUDO_COLOR		0x8004
124 #define GLX_STATIC_COLOR		0x8005
125 #define GLX_GRAY_SCALE			0x8006
126 #define GLX_STATIC_GRAY			0x8007
127 #define GLX_TRANSPARENT_RGB		0x8008
128 #define GLX_TRANSPARENT_INDEX		0x8009
129 #define GLX_VISUAL_ID			0x800B
130 #define GLX_SCREEN			0x800C
131 #define GLX_NON_CONFORMANT_CONFIG	0x800D
132 #define GLX_DRAWABLE_TYPE		0x8010
133 #define GLX_RENDER_TYPE			0x8011
134 #define GLX_X_RENDERABLE		0x8012
135 #define GLX_FBCONFIG_ID			0x8013
136 #define GLX_RGBA_TYPE			0x8014
137 #define GLX_COLOR_INDEX_TYPE		0x8015
138 #define GLX_MAX_PBUFFER_WIDTH		0x8016
139 #define GLX_MAX_PBUFFER_HEIGHT		0x8017
140 #define GLX_MAX_PBUFFER_PIXELS		0x8018
141 #define GLX_PRESERVED_CONTENTS		0x801B
142 #define GLX_LARGEST_PBUFFER		0x801C
143 #define GLX_WIDTH			0x801D
144 #define GLX_HEIGHT			0x801E
145 #define GLX_EVENT_MASK			0x801F
146 #define GLX_DAMAGED			0x8020
147 #define GLX_SAVED			0x8021
148 #define GLX_WINDOW			0x8022
149 #define GLX_PBUFFER			0x8023
150 #define GLX_PBUFFER_HEIGHT              0x8040
151 #define GLX_PBUFFER_WIDTH               0x8041
152 #define GLX_RGBA_BIT			0x00000001
153 #define GLX_COLOR_INDEX_BIT		0x00000002
154 #define GLX_PBUFFER_CLOBBER_MASK	0x08000000
155 
156 
157 /*
158  * GLX 1.4 and later:
159  */
160 #define GLX_SAMPLE_BUFFERS              0x186a0 /*100000*/
161 #define GLX_SAMPLES                     0x186a1 /*100001*/
162 
163 
164 
165 typedef struct __GLXcontextRec *GLXContext;
166 typedef XID GLXPixmap;
167 typedef XID GLXDrawable;
168 /* GLX 1.3 and later */
169 typedef struct __GLXFBConfigRec *GLXFBConfig;
170 typedef XID GLXFBConfigID;
171 typedef XID GLXContextID;
172 typedef XID GLXWindow;
173 typedef XID GLXPbuffer;
174 
175 
176 /*
177 ** Events.
178 ** __GLX_NUMBER_EVENTS is set to 17 to account for the BufferClobberSGIX
179 **  event - this helps initialization if the server supports the pbuffer
180 **  extension and the client doesn't.
181 */
182 #define GLX_PbufferClobber	0
183 #define GLX_BufferSwapComplete	1
184 
185 #define __GLX_NUMBER_EVENTS 17
186 
187 extern XVisualInfo* glXChooseVisual( Display *dpy, int screen,
188 				     int *attribList );
189 
190 extern GLXContext glXCreateContext( Display *dpy, XVisualInfo *vis,
191 				    GLXContext shareList, Bool direct );
192 
193 extern void glXDestroyContext( Display *dpy, GLXContext ctx );
194 
195 extern Bool glXMakeCurrent( Display *dpy, GLXDrawable drawable,
196 			    GLXContext ctx);
197 
198 extern void glXCopyContext( Display *dpy, GLXContext src, GLXContext dst,
199 			    unsigned long mask );
200 
201 extern void glXSwapBuffers( Display *dpy, GLXDrawable drawable );
202 
203 extern GLXPixmap glXCreateGLXPixmap( Display *dpy, XVisualInfo *visual,
204 				     Pixmap pixmap );
205 
206 extern void glXDestroyGLXPixmap( Display *dpy, GLXPixmap pixmap );
207 
208 extern Bool glXQueryExtension( Display *dpy, int *errorb, int *event );
209 
210 extern Bool glXQueryVersion( Display *dpy, int *maj, int *min );
211 
212 extern Bool glXIsDirect( Display *dpy, GLXContext ctx );
213 
214 extern int glXGetConfig( Display *dpy, XVisualInfo *visual,
215 			 int attrib, int *value );
216 
217 extern GLXContext glXGetCurrentContext( void );
218 
219 extern GLXDrawable glXGetCurrentDrawable( void );
220 
221 extern void glXWaitGL( void );
222 
223 extern void glXWaitX( void );
224 
225 extern void glXUseXFont( Font font, int first, int count, int list );
226 
227 
228 
229 /* GLX 1.1 and later */
230 extern const char *glXQueryExtensionsString( Display *dpy, int screen );
231 
232 extern const char *glXQueryServerString( Display *dpy, int screen, int name );
233 
234 extern const char *glXGetClientString( Display *dpy, int name );
235 
236 
237 /* GLX 1.2 and later */
238 extern Display *glXGetCurrentDisplay( void );
239 
240 
241 /* GLX 1.3 and later */
242 extern GLXFBConfig *glXChooseFBConfig( Display *dpy, int screen,
243                                        const int *attribList, int *nitems );
244 
245 extern int glXGetFBConfigAttrib( Display *dpy, GLXFBConfig config,
246                                  int attribute, int *value );
247 
248 extern GLXFBConfig *glXGetFBConfigs( Display *dpy, int screen,
249                                      int *nelements );
250 
251 extern XVisualInfo *glXGetVisualFromFBConfig( Display *dpy,
252                                               GLXFBConfig config );
253 
254 extern GLXWindow glXCreateWindow( Display *dpy, GLXFBConfig config,
255                                   Window win, const int *attribList );
256 
257 extern void glXDestroyWindow( Display *dpy, GLXWindow window );
258 
259 extern GLXPixmap glXCreatePixmap( Display *dpy, GLXFBConfig config,
260                                   Pixmap pixmap, const int *attribList );
261 
262 extern void glXDestroyPixmap( Display *dpy, GLXPixmap pixmap );
263 
264 extern GLXPbuffer glXCreatePbuffer( Display *dpy, GLXFBConfig config,
265                                     const int *attribList );
266 
267 extern void glXDestroyPbuffer( Display *dpy, GLXPbuffer pbuf );
268 
269 extern void glXQueryDrawable( Display *dpy, GLXDrawable draw, int attribute,
270                               unsigned int *value );
271 
272 extern GLXContext glXCreateNewContext( Display *dpy, GLXFBConfig config,
273                                        int renderType, GLXContext shareList,
274                                        Bool direct );
275 
276 extern Bool glXMakeContextCurrent( Display *dpy, GLXDrawable draw,
277                                    GLXDrawable read, GLXContext ctx );
278 
279 extern GLXDrawable glXGetCurrentReadDrawable( void );
280 
281 extern int glXQueryContext( Display *dpy, GLXContext ctx, int attribute,
282                             int *value );
283 
284 extern void glXSelectEvent( Display *dpy, GLXDrawable drawable,
285                             unsigned long mask );
286 
287 extern void glXGetSelectedEvent( Display *dpy, GLXDrawable drawable,
288                                  unsigned long *mask );
289 
290 /* GLX 1.3 function pointer typedefs */
291 typedef GLXFBConfig * (* PFNGLXGETFBCONFIGSPROC) (Display *dpy, int screen, int *nelements);
292 typedef GLXFBConfig * (* PFNGLXCHOOSEFBCONFIGPROC) (Display *dpy, int screen, const int *attrib_list, int *nelements);
293 typedef int (* PFNGLXGETFBCONFIGATTRIBPROC) (Display *dpy, GLXFBConfig config, int attribute, int *value);
294 typedef XVisualInfo * (* PFNGLXGETVISUALFROMFBCONFIGPROC) (Display *dpy, GLXFBConfig config);
295 typedef GLXWindow (* PFNGLXCREATEWINDOWPROC) (Display *dpy, GLXFBConfig config, Window win, const int *attrib_list);
296 typedef void (* PFNGLXDESTROYWINDOWPROC) (Display *dpy, GLXWindow win);
297 typedef GLXPixmap (* PFNGLXCREATEPIXMAPPROC) (Display *dpy, GLXFBConfig config, Pixmap pixmap, const int *attrib_list);
298 typedef void (* PFNGLXDESTROYPIXMAPPROC) (Display *dpy, GLXPixmap pixmap);
299 typedef GLXPbuffer (* PFNGLXCREATEPBUFFERPROC) (Display *dpy, GLXFBConfig config, const int *attrib_list);
300 typedef void (* PFNGLXDESTROYPBUFFERPROC) (Display *dpy, GLXPbuffer pbuf);
301 typedef void (* PFNGLXQUERYDRAWABLEPROC) (Display *dpy, GLXDrawable draw, int attribute, unsigned int *value);
302 typedef GLXContext (* PFNGLXCREATENEWCONTEXTPROC) (Display *dpy, GLXFBConfig config, int render_type, GLXContext share_list, Bool direct);
303 typedef Bool (* PFNGLXMAKECONTEXTCURRENTPROC) (Display *dpy, GLXDrawable draw, GLXDrawable read, GLXContext ctx);
304 typedef GLXDrawable (* PFNGLXGETCURRENTREADDRAWABLEPROC) (void);
305 typedef Display * (* PFNGLXGETCURRENTDISPLAYPROC) (void);
306 typedef int (* PFNGLXQUERYCONTEXTPROC) (Display *dpy, GLXContext ctx, int attribute, int *value);
307 typedef void (* PFNGLXSELECTEVENTPROC) (Display *dpy, GLXDrawable draw, unsigned long event_mask);
308 typedef void (* PFNGLXGETSELECTEDEVENTPROC) (Display *dpy, GLXDrawable draw, unsigned long *event_mask);
309 
310 
311 /*
312  * ARB 2. GLX_ARB_get_proc_address
313  */
314 #ifndef GLX_ARB_get_proc_address
315 #define GLX_ARB_get_proc_address 1
316 
317 typedef void (*__GLXextFuncPtr)(void);
318 extern __GLXextFuncPtr glXGetProcAddressARB (const GLubyte *);
319 
320 #endif /* GLX_ARB_get_proc_address */
321 
322 
323 
324 /* GLX 1.4 and later */
325 extern void (*glXGetProcAddress(const GLubyte *procname))( void );
326 
327 /* GLX 1.4 function pointer typedefs */
328 typedef __GLXextFuncPtr (* PFNGLXGETPROCADDRESSPROC) (const GLubyte *procName);
329 
330 
331 #ifndef GLX_GLXEXT_LEGACY
332 
333 #include <GL/glxext.h>
334 
335 #endif /* GLX_GLXEXT_LEGACY */
336 
337 
338 /**
339  ** The following aren't in glxext.h yet.
340  **/
341 
342 
343 /*
344  * ???. GLX_NV_vertex_array_range
345  */
346 #ifndef GLX_NV_vertex_array_range
347 #define GLX_NV_vertex_array_range
348 
349 extern void *glXAllocateMemoryNV(GLsizei size, GLfloat readfreq, GLfloat writefreq, GLfloat priority);
350 extern void glXFreeMemoryNV(GLvoid *pointer);
351 typedef void * ( * PFNGLXALLOCATEMEMORYNVPROC) (GLsizei size, GLfloat readfreq, GLfloat writefreq, GLfloat priority);
352 typedef void ( * PFNGLXFREEMEMORYNVPROC) (GLvoid *pointer);
353 
354 #endif /* GLX_NV_vertex_array_range */
355 
356 
357 /*
358  * ARB ?. GLX_ARB_render_texture
359  * XXX This was never finalized!
360  */
361 #ifndef GLX_ARB_render_texture
362 #define GLX_ARB_render_texture 1
363 
364 extern Bool glXBindTexImageARB(Display *dpy, GLXPbuffer pbuffer, int buffer);
365 extern Bool glXReleaseTexImageARB(Display *dpy, GLXPbuffer pbuffer, int buffer);
366 extern Bool glXDrawableAttribARB(Display *dpy, GLXDrawable draw, const int *attribList);
367 
368 #endif /* GLX_ARB_render_texture */
369 
370 
371 /*
372  * #?. GLX_MESA_swap_frame_usage
373  */
374 #ifndef GLX_MESA_swap_frame_usage
375 #define GLX_MESA_swap_frame_usage 1
376 
377 extern int glXGetFrameUsageMESA(Display *dpy, GLXDrawable drawable, float *usage);
378 extern int glXBeginFrameTrackingMESA(Display *dpy, GLXDrawable drawable);
379 extern int glXEndFrameTrackingMESA(Display *dpy, GLXDrawable drawable);
380 extern int glXQueryFrameTrackingMESA(Display *dpy, GLXDrawable drawable, int64_t *swapCount, int64_t *missedFrames, float *lastMissedUsage);
381 
382 typedef int (*PFNGLXGETFRAMEUSAGEMESAPROC) (Display *dpy, GLXDrawable drawable, float *usage);
383 typedef int (*PFNGLXBEGINFRAMETRACKINGMESAPROC)(Display *dpy, GLXDrawable drawable);
384 typedef int (*PFNGLXENDFRAMETRACKINGMESAPROC)(Display *dpy, GLXDrawable drawable);
385 typedef int (*PFNGLXQUERYFRAMETRACKINGMESAPROC)(Display *dpy, GLXDrawable drawable, int64_t *swapCount, int64_t *missedFrames, float *lastMissedUsage);
386 
387 #endif /* GLX_MESA_swap_frame_usage */
388 
389 
390 
391 /*
392  * #?. GLX_MESA_swap_control
393  */
394 #ifndef GLX_MESA_swap_control
395 #define GLX_MESA_swap_control 1
396 
397 extern int glXSwapIntervalMESA(unsigned int interval);
398 extern int glXGetSwapIntervalMESA(void);
399 
400 typedef int (*PFNGLXSWAPINTERVALMESAPROC)(unsigned int interval);
401 typedef int (*PFNGLXGETSWAPINTERVALMESAPROC)(void);
402 
403 #endif /* GLX_MESA_swap_control */
404 
405 
406 /*** Should these go here, or in another header? */
407 /*
408 ** GLX Events
409 */
410 typedef struct {
411     int event_type;		/* GLX_DAMAGED or GLX_SAVED */
412     int draw_type;		/* GLX_WINDOW or GLX_PBUFFER */
413     unsigned long serial;	/* # of last request processed by server */
414     Bool send_event;		/* true if this came for SendEvent request */
415     Display *display;		/* display the event was read from */
416     GLXDrawable drawable;	/* XID of Drawable */
417     unsigned int buffer_mask;	/* mask indicating which buffers are affected */
418     unsigned int aux_buffer;	/* which aux buffer was affected */
419     int x, y;
420     int width, height;
421     int count;			/* if nonzero, at least this many more */
422 } GLXPbufferClobberEvent;
423 
424 typedef struct {
425     int type;
426     unsigned long serial;	/* # of last request processed by server */
427     Bool send_event;		/* true if this came from a SendEvent request */
428     Display *display;		/* Display the event was read from */
429     Drawable drawable;	/* drawable on which event was requested in event mask */
430     int event_type;
431     int64_t ust;
432     int64_t msc;
433     int64_t sbc;
434 } GLXBufferSwapComplete;
435 
436 typedef union __GLXEvent {
437     GLXPbufferClobberEvent glxpbufferclobber;
438     GLXBufferSwapComplete glxbufferswapcomplete;
439     long pad[24];
440 } GLXEvent;
441 
442 #ifdef __cplusplus
443 }
444 #endif
445 
446 #endif
447