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