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