2 * Mesa 3-D graphics library
4 * Copyright (C) 1999-2006 Brian Paul All Rights Reserved.
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:
13 * The above copyright notice and this permission notice shall be included
14 * in all copies or substantial portions of the Software.
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.
31 #include <X11/Xutil.h>
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
45 #define GLX_EXTENSION_NAME "GLX"
50 * Tokens for glXChooseVisual and glXGetConfig:
53 #define GLX_BUFFER_SIZE 2
56 #define GLX_DOUBLEBUFFER 5
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
72 * Error codes returned by glXGetConfig:
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
88 #define GLX_EXTENSIONS 3
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
155 #define GLX_SAMPLE_BUFFERS 0x186a0 /*100000*/
156 #define GLX_SAMPLES 0x186a1 /*100001*/
160 typedef struct __GLXcontextRec
*GLXContext
;
161 typedef XID GLXPixmap
;
162 typedef XID GLXDrawable
;
163 /* GLX 1.3 and later */
164 typedef struct __GLXFBConfigRec
*GLXFBConfig
;
165 typedef XID GLXFBConfigID
;
166 typedef XID GLXContextID
;
167 typedef XID GLXWindow
;
168 typedef XID GLXPbuffer
;
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.
177 #define GLX_PbufferClobber 0
178 #define GLX_BufferSwapComplete 1
180 #define __GLX_NUMBER_EVENTS 17
182 extern XVisualInfo
* glXChooseVisual( Display
*dpy
, int screen
,
185 extern GLXContext
glXCreateContext( Display
*dpy
, XVisualInfo
*vis
,
186 GLXContext shareList
, Bool direct
);
188 extern void glXDestroyContext( Display
*dpy
, GLXContext ctx
);
190 extern Bool
glXMakeCurrent( Display
*dpy
, GLXDrawable drawable
,
193 extern void glXCopyContext( Display
*dpy
, GLXContext src
, GLXContext dst
,
194 unsigned long mask
);
196 extern void glXSwapBuffers( Display
*dpy
, GLXDrawable drawable
);
198 extern GLXPixmap
glXCreateGLXPixmap( Display
*dpy
, XVisualInfo
*visual
,
201 extern void glXDestroyGLXPixmap( Display
*dpy
, GLXPixmap pixmap
);
203 extern Bool
glXQueryExtension( Display
*dpy
, int *errorb
, int *event
);
205 extern Bool
glXQueryVersion( Display
*dpy
, int *maj
, int *min
);
207 extern Bool
glXIsDirect( Display
*dpy
, GLXContext ctx
);
209 extern int glXGetConfig( Display
*dpy
, XVisualInfo
*visual
,
210 int attrib
, int *value
);
212 extern GLXContext
glXGetCurrentContext( void );
214 extern GLXDrawable
glXGetCurrentDrawable( void );
216 extern void glXWaitGL( void );
218 extern void glXWaitX( void );
220 extern void glXUseXFont( Font font
, int first
, int count
, int list
);
224 /* GLX 1.1 and later */
225 extern const char *glXQueryExtensionsString( Display
*dpy
, int screen
);
227 extern const char *glXQueryServerString( Display
*dpy
, int screen
, int name
);
229 extern const char *glXGetClientString( Display
*dpy
, int name
);
232 /* GLX 1.2 and later */
233 extern Display
*glXGetCurrentDisplay( void );
236 /* GLX 1.3 and later */
237 extern GLXFBConfig
*glXChooseFBConfig( Display
*dpy
, int screen
,
238 const int *attribList
, int *nitems
);
240 extern int glXGetFBConfigAttrib( Display
*dpy
, GLXFBConfig config
,
241 int attribute
, int *value
);
243 extern GLXFBConfig
*glXGetFBConfigs( Display
*dpy
, int screen
,
246 extern XVisualInfo
*glXGetVisualFromFBConfig( Display
*dpy
,
247 GLXFBConfig config
);
249 extern GLXWindow
glXCreateWindow( Display
*dpy
, GLXFBConfig config
,
250 Window win
, const int *attribList
);
252 extern void glXDestroyWindow( Display
*dpy
, GLXWindow window
);
254 extern GLXPixmap
glXCreatePixmap( Display
*dpy
, GLXFBConfig config
,
255 Pixmap pixmap
, const int *attribList
);
257 extern void glXDestroyPixmap( Display
*dpy
, GLXPixmap pixmap
);
259 extern GLXPbuffer
glXCreatePbuffer( Display
*dpy
, GLXFBConfig config
,
260 const int *attribList
);
262 extern void glXDestroyPbuffer( Display
*dpy
, GLXPbuffer pbuf
);
264 extern void glXQueryDrawable( Display
*dpy
, GLXDrawable draw
, int attribute
,
265 unsigned int *value
);
267 extern GLXContext
glXCreateNewContext( Display
*dpy
, GLXFBConfig config
,
268 int renderType
, GLXContext shareList
,
271 extern Bool
glXMakeContextCurrent( Display
*dpy
, GLXDrawable draw
,
272 GLXDrawable read
, GLXContext ctx
);
274 extern GLXDrawable
glXGetCurrentReadDrawable( void );
276 extern int glXQueryContext( Display
*dpy
, GLXContext ctx
, int attribute
,
279 extern void glXSelectEvent( Display
*dpy
, GLXDrawable drawable
,
280 unsigned long mask
);
282 extern void glXGetSelectedEvent( Display
*dpy
, GLXDrawable drawable
,
283 unsigned long *mask
);
285 /* GLX 1.3 function pointer typedefs */
286 typedef GLXFBConfig
* (* PFNGLXGETFBCONFIGSPROC
) (Display
*dpy
, int screen
, int *nelements
);
287 typedef GLXFBConfig
* (* PFNGLXCHOOSEFBCONFIGPROC
) (Display
*dpy
, int screen
, const int *attrib_list
, int *nelements
);
288 typedef int (* PFNGLXGETFBCONFIGATTRIBPROC
) (Display
*dpy
, GLXFBConfig config
, int attribute
, int *value
);
289 typedef XVisualInfo
* (* PFNGLXGETVISUALFROMFBCONFIGPROC
) (Display
*dpy
, GLXFBConfig config
);
290 typedef GLXWindow (* PFNGLXCREATEWINDOWPROC
) (Display
*dpy
, GLXFBConfig config
, Window win
, const int *attrib_list
);
291 typedef void (* PFNGLXDESTROYWINDOWPROC
) (Display
*dpy
, GLXWindow win
);
292 typedef GLXPixmap (* PFNGLXCREATEPIXMAPPROC
) (Display
*dpy
, GLXFBConfig config
, Pixmap pixmap
, const int *attrib_list
);
293 typedef void (* PFNGLXDESTROYPIXMAPPROC
) (Display
*dpy
, GLXPixmap pixmap
);
294 typedef GLXPbuffer (* PFNGLXCREATEPBUFFERPROC
) (Display
*dpy
, GLXFBConfig config
, const int *attrib_list
);
295 typedef void (* PFNGLXDESTROYPBUFFERPROC
) (Display
*dpy
, GLXPbuffer pbuf
);
296 typedef void (* PFNGLXQUERYDRAWABLEPROC
) (Display
*dpy
, GLXDrawable draw
, int attribute
, unsigned int *value
);
297 typedef GLXContext (* PFNGLXCREATENEWCONTEXTPROC
) (Display
*dpy
, GLXFBConfig config
, int render_type
, GLXContext share_list
, Bool direct
);
298 typedef Bool (* PFNGLXMAKECONTEXTCURRENTPROC
) (Display
*dpy
, GLXDrawable draw
, GLXDrawable read
, GLXContext ctx
);
299 typedef GLXDrawable (* PFNGLXGETCURRENTREADDRAWABLEPROC
) (void);
300 typedef Display
* (* PFNGLXGETCURRENTDISPLAYPROC
) (void);
301 typedef int (* PFNGLXQUERYCONTEXTPROC
) (Display
*dpy
, GLXContext ctx
, int attribute
, int *value
);
302 typedef void (* PFNGLXSELECTEVENTPROC
) (Display
*dpy
, GLXDrawable draw
, unsigned long event_mask
);
303 typedef void (* PFNGLXGETSELECTEDEVENTPROC
) (Display
*dpy
, GLXDrawable draw
, unsigned long *event_mask
);
307 * ARB 2. GLX_ARB_get_proc_address
309 #ifndef GLX_ARB_get_proc_address
310 #define GLX_ARB_get_proc_address 1
312 typedef void (*__GLXextFuncPtr
)(void);
313 extern __GLXextFuncPtr
glXGetProcAddressARB (const GLubyte
*);
315 #endif /* GLX_ARB_get_proc_address */
319 /* GLX 1.4 and later */
320 extern void (*glXGetProcAddress(const GLubyte
*procname
))( void );
322 /* GLX 1.4 function pointer typedefs */
323 typedef __GLXextFuncPtr (* PFNGLXGETPROCADDRESSPROC
) (const GLubyte
*procName
);
326 #ifndef GLX_GLXEXT_LEGACY
328 #include <GL/glxext.h>
330 #endif /* GLX_GLXEXT_LEGACY */
334 ** The following aren't in glxext.h yet.
339 * ???. GLX_NV_vertex_array_range
341 #ifndef GLX_NV_vertex_array_range
342 #define GLX_NV_vertex_array_range
344 extern void *glXAllocateMemoryNV(GLsizei size
, GLfloat readfreq
, GLfloat writefreq
, GLfloat priority
);
345 extern void glXFreeMemoryNV(GLvoid
*pointer
);
346 typedef void * ( * PFNGLXALLOCATEMEMORYNVPROC
) (GLsizei size
, GLfloat readfreq
, GLfloat writefreq
, GLfloat priority
);
347 typedef void ( * PFNGLXFREEMEMORYNVPROC
) (GLvoid
*pointer
);
349 #endif /* GLX_NV_vertex_array_range */
353 * ARB ?. GLX_ARB_render_texture
354 * XXX This was never finalized!
356 #ifndef GLX_ARB_render_texture
357 #define GLX_ARB_render_texture 1
359 extern Bool
glXBindTexImageARB(Display
*dpy
, GLXPbuffer pbuffer
, int buffer
);
360 extern Bool
glXReleaseTexImageARB(Display
*dpy
, GLXPbuffer pbuffer
, int buffer
);
361 extern Bool
glXDrawableAttribARB(Display
*dpy
, GLXDrawable draw
, const int *attribList
);
363 #endif /* GLX_ARB_render_texture */
367 * #?. GLX_MESA_swap_frame_usage
369 #ifndef GLX_MESA_swap_frame_usage
370 #define GLX_MESA_swap_frame_usage 1
372 extern int glXGetFrameUsageMESA(Display
*dpy
, GLXDrawable drawable
, float *usage
);
373 extern int glXBeginFrameTrackingMESA(Display
*dpy
, GLXDrawable drawable
);
374 extern int glXEndFrameTrackingMESA(Display
*dpy
, GLXDrawable drawable
);
375 extern int glXQueryFrameTrackingMESA(Display
*dpy
, GLXDrawable drawable
, int64_t *swapCount
, int64_t *missedFrames
, float *lastMissedUsage
);
377 typedef int (*PFNGLXGETFRAMEUSAGEMESAPROC
) (Display
*dpy
, GLXDrawable drawable
, float *usage
);
378 typedef int (*PFNGLXBEGINFRAMETRACKINGMESAPROC
)(Display
*dpy
, GLXDrawable drawable
);
379 typedef int (*PFNGLXENDFRAMETRACKINGMESAPROC
)(Display
*dpy
, GLXDrawable drawable
);
380 typedef int (*PFNGLXQUERYFRAMETRACKINGMESAPROC
)(Display
*dpy
, GLXDrawable drawable
, int64_t *swapCount
, int64_t *missedFrames
, float *lastMissedUsage
);
382 #endif /* GLX_MESA_swap_frame_usage */
387 * #?. GLX_MESA_swap_control
389 #ifndef GLX_MESA_swap_control
390 #define GLX_MESA_swap_control 1
392 extern int glXSwapIntervalMESA(unsigned int interval
);
393 extern int glXGetSwapIntervalMESA(void);
395 typedef int (*PFNGLXSWAPINTERVALMESAPROC
)(unsigned int interval
);
396 typedef int (*PFNGLXGETSWAPINTERVALMESAPROC
)(void);
398 #endif /* GLX_MESA_swap_control */
401 /*** Should these go here, or in another header? */
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 */
416 int count
; /* if nonzero, at least this many more */
417 } GLXPbufferClobberEvent
;
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 */
429 } GLXBufferSwapComplete
;
431 typedef union __GLXEvent
{
432 GLXPbufferClobberEvent glxpbufferclobber
;
433 GLXBufferSwapComplete glxbufferswapcomplete
;