1 /* $Id: glxapi.c,v 1.13 2000/02/25 16:46:01 brianp Exp $ */
4 * Mesa 3-D graphics library
7 * Copyright (C) 1999-2000 Brian Paul All Rights Reserved.
9 * Permission is hereby granted, free of charge, to any person obtaining a
10 * copy of this software and associated documentation files (the "Software"),
11 * to deal in the Software without restriction, including without limitation
12 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
13 * and/or sell copies of the Software, and to permit persons to whom the
14 * Software is furnished to do so, subject to the following conditions:
16 * The above copyright notice and this permission notice shall be included
17 * in all copies or substantial portions of the Software.
19 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
20 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
22 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
23 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
24 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
29 * This is the GLX API dispatcher. Calls to the glX* functions are
30 * either routed to real (SGI / Utah) GLX encoders or to Mesa's
42 * XXX - this really shouldn't be here.
43 * Instead, add -DUSE_MESA_GLX to the compiler flags when needed.
45 #define USE_MESA_GLX 1
48 /* Rather than include possibly non-existant headers... */
50 extern struct _glxapi_table
*_sgi_GetGLXDispatchtable(void);
53 extern struct _glxapi_table
*_utah_GetGLXDispatchTable(void);
56 extern struct _glxapi_table
*_mesa_GetGLXDispatchTable(void);
61 struct display_dispatch
{
63 struct _glxapi_table
*Table
;
64 struct display_dispatch
*Next
;
67 static struct display_dispatch
*DispatchList
= NULL
;
70 static struct _glxapi_table
*
71 get_dispatch(Display
*dpy
)
73 static Display
*prevDisplay
= NULL
;
74 static struct _glxapi_table
*prevTable
= NULL
;
79 /* try cached display */
80 if (dpy
== prevDisplay
) {
84 /* search list of display/dispatch pairs for this display */
86 const struct display_dispatch
*d
= DispatchList
;
91 return d
->Table
; /* done! */
97 /* A new display, determine if we should use real GLX (SGI / Utah)
98 * or Mesa's pseudo-GLX.
101 struct _glxapi_table
*t
= NULL
;
103 #if defined(USE_SGI_GLX) || defined(USE_UTAH_GLX)
104 if (!getenv("MESA_FORCE_SOFTX")) {
106 if (XQueryExtension( dpy
, "GLX", &ignore
, &ignore
, &ignore
)) {
107 /* the X server has the GLX extension */
108 #if defined(USE_SGI_GLX)
109 t
= _sgi_GetGLXDispatchtable();
110 #elif defined(USE_UTAH_GLX)
111 t
= _utah_GetGLXDispatchTable();
117 #if defined(USE_MESA_GLX)
119 t
= _mesa_GetGLXDispatchTable();
120 assert(t
); /* this has to work */
125 struct display_dispatch
*d
;
126 d
= (struct display_dispatch
*) malloc(sizeof(struct display_dispatch
));
130 /* insert at head of list */
131 d
->Next
= DispatchList
;
141 /* If we get here that means we can't use real GLX on this display
142 * and the Mesa pseudo-GLX software renderer wasn't compiled in.
143 * Or, we ran out of memory!
150 /* Set by glXMakeCurrent() and glXMakeContextCurrent() only */
151 static Display
*CurrentDisplay
= NULL
;
152 static GLXContext CurrentContext
= 0;
153 static GLXDrawable CurrentDrawable
= 0;
154 static GLXDrawable CurrentReadDrawable
= 0;
159 * GLX API entrypoints
163 XVisualInfo
*glXChooseVisual(Display
*dpy
, int screen
, int *list
)
165 struct _glxapi_table
*t
= get_dispatch(dpy
);
168 return (t
->ChooseVisual
)(dpy
, screen
, list
);
172 void glXCopyContext(Display
*dpy
, GLXContext src
, GLXContext dst
,
175 struct _glxapi_table
*t
= get_dispatch(dpy
);
178 (t
->CopyContext
)(dpy
, src
, dst
, mask
);
182 GLXContext
glXCreateContext(Display
*dpy
, XVisualInfo
*visinfo
, GLXContext shareList
, Bool direct
)
184 struct _glxapi_table
*t
= get_dispatch(dpy
);
187 return (t
->CreateContext
)(dpy
, visinfo
, shareList
, direct
);
191 GLXPixmap
glXCreateGLXPixmap(Display
*dpy
, XVisualInfo
*visinfo
, Pixmap pixmap
)
193 struct _glxapi_table
*t
= get_dispatch(dpy
);
196 return (t
->CreateGLXPixmap
)(dpy
, visinfo
, pixmap
);
200 void glXDestroyContext(Display
*dpy
, GLXContext ctx
)
202 struct _glxapi_table
*t
= get_dispatch(dpy
);
205 (t
->DestroyContext
)(dpy
, ctx
);
209 void glXDestroyGLXPixmap(Display
*dpy
, GLXPixmap pixmap
)
211 struct _glxapi_table
*t
= get_dispatch(dpy
);
214 (t
->DestroyGLXPixmap
)(dpy
, pixmap
);
218 int glXGetConfig(Display
*dpy
, XVisualInfo
*visinfo
, int attrib
, int *value
)
220 struct _glxapi_table
*t
= get_dispatch(dpy
);
222 return GLX_NO_EXTENSION
;
223 return (t
->GetConfig
)(dpy
, visinfo
, attrib
, value
);
227 GLXContext
glXGetCurrentContext(void)
229 return CurrentContext
;
233 GLXDrawable
glXGetCurrentDrawable(void)
235 return CurrentDrawable
;
239 Bool
glXIsDirect(Display
*dpy
, GLXContext ctx
)
241 struct _glxapi_table
*t
= get_dispatch(dpy
);
244 return (t
->IsDirect
)(dpy
, ctx
);
248 Bool
glXMakeCurrent(Display
*dpy
, GLXDrawable drawable
, GLXContext ctx
)
251 struct _glxapi_table
*t
= get_dispatch(dpy
);
254 b
= (*t
->MakeCurrent
)(dpy
, drawable
, ctx
);
256 CurrentDisplay
= dpy
;
257 CurrentContext
= ctx
;
258 CurrentDrawable
= drawable
;
259 CurrentReadDrawable
= drawable
;
265 Bool
glXQueryExtension(Display
*dpy
, int *errorb
, int *event
)
267 struct _glxapi_table
*t
= get_dispatch(dpy
);
270 return (t
->QueryExtension
)(dpy
, errorb
, event
);
274 Bool
glXQueryVersion(Display
*dpy
, int *maj
, int *min
)
276 struct _glxapi_table
*t
= get_dispatch(dpy
);
279 return (t
->QueryVersion
)(dpy
, maj
, min
);
283 void glXSwapBuffers(Display
*dpy
, GLXDrawable drawable
)
285 struct _glxapi_table
*t
= get_dispatch(dpy
);
288 (t
->SwapBuffers
)(dpy
, drawable
);
292 void glXUseXFont(Font font
, int first
, int count
, int listBase
)
294 struct _glxapi_table
*t
= get_dispatch(CurrentDisplay
);
297 (t
->UseXFont
)(font
, first
, count
, listBase
);
303 struct _glxapi_table
*t
= get_dispatch(CurrentDisplay
);
312 struct _glxapi_table
*t
= get_dispatch(CurrentDisplay
);
320 #ifdef _GLXAPI_VERSION_1_1
322 const char *glXGetClientString(Display
*dpy
, int name
)
324 struct _glxapi_table
*t
= get_dispatch(dpy
);
327 return (t
->GetClientString
)(dpy
, name
);
331 const char *glXQueryExtensionsString(Display
*dpy
, int screen
)
333 struct _glxapi_table
*t
= get_dispatch(dpy
);
336 return (t
->QueryExtensionsString
)(dpy
, screen
);
340 const char *glXQueryServerString(Display
*dpy
, int screen
, int name
)
342 struct _glxapi_table
*t
= get_dispatch(dpy
);
345 return (t
->QueryServerString
)(dpy
, screen
, name
);
352 #ifdef _GLXAPI_VERSION_1_2
353 Display
*glXGetCurrentDisplay(void)
355 return CurrentDisplay
;
361 #ifdef _GLXAPI_VERSION_1_3
363 GLXFBConfig
glXChooseFBConfig(Display
*dpy
, int screen
, const int *attribList
, int *nitems
)
365 struct _glxapi_table
*t
= get_dispatch(dpy
);
368 return (t
->ChooseFBConfig
)(dpy
, screen
, attribList
, nitems
);
372 GLXContext
glXCreateNewContext(Display
*dpy
, GLXFBConfig config
, int renderType
, GLXContext shareList
, Bool direct
)
374 struct _glxapi_table
*t
= get_dispatch(dpy
);
377 return (t
->CreateNewContext
)(dpy
, config
, renderType
, shareList
, direct
);
381 GLXPbuffer
glXCreatePbuffer(Display
*dpy
, GLXFBConfig config
, const int *attribList
)
383 struct _glxapi_table
*t
= get_dispatch(dpy
);
386 return (t
->CreatePbuffer
)(dpy
, config
, attribList
);
390 GLXPixmap
glXCreatePixmap(Display
*dpy
, GLXFBConfig config
, Pixmap pixmap
, const int *attribList
)
392 struct _glxapi_table
*t
= get_dispatch(dpy
);
395 return (t
->CreatePixmap
)(dpy
, config
, pixmap
, attribList
);
399 GLXWindow
glXCreateWindow(Display
*dpy
, GLXFBConfig config
, Window win
, const int *attribList
)
401 struct _glxapi_table
*t
= get_dispatch(dpy
);
404 return (t
->CreateWindow
)(dpy
, config
, win
, attribList
);
408 void glXDestroyPbuffer(Display
*dpy
, GLXPbuffer pbuf
)
410 struct _glxapi_table
*t
= get_dispatch(dpy
);
413 (t
->DestroyPbuffer
)(dpy
, pbuf
);
417 void glXDestroyPixmap(Display
*dpy
, GLXPixmap pixmap
)
419 struct _glxapi_table
*t
= get_dispatch(dpy
);
422 (t
->DestroyPixmap
)(dpy
, pixmap
);
426 void glXDestroyWindow(Display
*dpy
, GLXWindow window
)
428 struct _glxapi_table
*t
= get_dispatch(dpy
);
431 (t
->DestroyWindow
)(dpy
, window
);
435 GLXDrawable
glXGetCurrentReadDrawable(void)
437 return CurrentReadDrawable
;
441 int glXGetFBConfigAttrib(Display
*dpy
, GLXFBConfig config
, int attribute
, int *value
)
443 struct _glxapi_table
*t
= get_dispatch(dpy
);
445 return GLX_NO_EXTENSION
;
446 return (t
->GetFBConfigAttrib
)(dpy
, config
, attribute
, value
);
450 void glXGetSelectedEvent(Display
*dpy
, GLXDrawable drawable
, unsigned long *mask
)
452 struct _glxapi_table
*t
= get_dispatch(dpy
);
455 (t
->GetSelectedEvent
)(dpy
, drawable
, mask
);
459 XVisualInfo
*glXGetVisualFromFBConfig(Display
*dpy
, GLXFBConfig config
)
461 struct _glxapi_table
*t
= get_dispatch(dpy
);
464 return (t
->GetVisualFromFBConfig
)(dpy
, config
);
468 Bool
glXMakeContextCurrent(Display
*dpy
, GLXDrawable draw
, GLXDrawable read
, GLXContext ctx
)
470 struct _glxapi_table
*t
= get_dispatch(dpy
);
474 b
= (t
->MakeContextCurrent
)(dpy
, draw
, read
, ctx
);
476 CurrentDisplay
= dpy
;
477 CurrentContext
= ctx
;
478 CurrentDrawable
= draw
;
479 CurrentReadDrawable
= read
;
485 int glXQueryContext(Display
*dpy
, GLXContext ctx
, int attribute
, int *value
)
487 struct _glxapi_table
*t
= get_dispatch(dpy
);
490 return 0; /* XXX correct? */
491 return (t
->QueryContext
)(dpy
, ctx
, attribute
, value
);
495 void glXQueryDrawable(Display
*dpy
, GLXDrawable draw
, int attribute
, unsigned int *value
)
497 struct _glxapi_table
*t
= get_dispatch(dpy
);
500 (t
->QueryDrawable
)(dpy
, draw
, attribute
, value
);
504 void glXSelectEvent(Display
*dpy
, GLXDrawable drawable
, unsigned long mask
)
506 struct _glxapi_table
*t
= get_dispatch(dpy
);
509 (t
->SelectEvent
)(dpy
, drawable
, mask
);
512 #endif /* _GLXAPI_VERSION_1_3 */
515 #ifdef _GLXAPI_EXT_import_context
517 void glXFreeContextEXT(Display
*dpy
, GLXContext context
)
519 struct _glxapi_table
*t
= get_dispatch(dpy
);
522 (t
->FreeContextEXT
)(dpy
, context
);
526 GLXContextID
glXGetContextIDEXT(const GLXContext context
)
528 /* XXX is this function right? */
529 struct _glxapi_table
*t
= get_dispatch(CurrentDisplay
);
532 return (t
->GetContextIDEXT
)(context
);
536 Display
*glXGetCurrentDisplayEXT(void)
538 return CurrentDisplay
;
542 GLXContext
glXImportContextEXT(Display
*dpy
, GLXContextID contextID
)
544 struct _glxapi_table
*t
= get_dispatch(dpy
);
547 return (t
->ImportContextEXT
)(dpy
, contextID
);
550 int glXQueryContextInfoEXT(Display
*dpy
, GLXContext context
, int attribute
,int *value
)
552 struct _glxapi_table
*t
= get_dispatch(dpy
);
554 return 0; /* XXX ok? */
555 return (t
->QueryContextInfoEXT
)(dpy
, context
, attribute
, value
);
561 #ifdef _GLXAPI_SGI_video_sync
563 int glXGetVideoSyncSGI(unsigned int *count
)
565 struct _glxapi_table
*t
= get_dispatch(CurrentDisplay
);
568 return (t
->GetVideoSyncSGI
)(count
);
572 int glXWaitVideoSyncSGI(int divisor
, int remainder
, unsigned int *count
)
574 struct _glxapi_table
*t
= get_dispatch(CurrentDisplay
);
577 return (t
->WaitVideoSyncSGI
)(divisor
, remainder
, count
);
583 #ifdef _GLXAPI_MESA_copy_sub_buffer
585 void glXCopySubBufferMESA(Display
*dpy
, GLXDrawable drawable
, int x
, int y
, int width
, int height
)
587 struct _glxapi_table
*t
= get_dispatch(dpy
);
590 (t
->CopySubBufferMESA
)(dpy
, drawable
, x
, y
, width
, height
);
596 #ifdef _GLXAPI_MESA_release_buffers
598 Bool
glXReleaseBuffersMESA(Display
*dpy
, Window w
)
600 struct _glxapi_table
*t
= get_dispatch(dpy
);
603 return (t
->ReleaseBuffersMESA
)(dpy
, w
);
609 #ifdef _GLXAPI_MESA_pixmap_colormap
611 GLXPixmap
glXCreateGLXPixmapMESA(Display
*dpy
, XVisualInfo
*visinfo
, Pixmap pixmap
, Colormap cmap
)
613 struct _glxapi_table
*t
= get_dispatch(dpy
);
616 return (t
->CreateGLXPixmapMESA
)(dpy
, visinfo
, pixmap
, cmap
);
622 #ifdef _GLXAPI_MESA_set_3dfx_mode
624 GLboolean
glXSet3DfxModeMESA(GLint mode
)
626 struct _glxapi_table
*t
= get_dispatch(CurrentDisplay
);
629 return (t
->Set3DfxModeMESA
)(mode
);
636 /**********************************************************************/
637 /* GLX API management functions */
638 /**********************************************************************/
642 _glxapi_get_version(void)
649 * Return array of extension strings.
652 _glxapi_get_extensions(void)
654 static const char *extensions
[] = {
655 #ifdef _GLXAPI_EXT_import_context
656 "GLX_EXT_import_context",
658 #ifdef _GLXAPI_SGI_video_sync
659 "GLX_SGI_video_sync",
661 #ifdef _GLXAPI_MESA_copy_sub_buffer
662 "GLX_MESA_copy_sub_buffer",
664 #ifdef _GLXAPI_MESA_release_buffers
665 "GLX_MESA_release_buffers",
667 #ifdef _GLXAPI_MESA_pixmap_colormap
668 "GLX_MESA_pixmap_colormap",
670 #ifdef _GLXAPI_MESA_set_3dfx_mode
671 "GLX_MESA_set_3dfx_mode",
680 * Return size of the GLX dispatch table, in entries, not bytes.
683 _glxapi_get_dispatch_table_size(void)
685 return sizeof(struct _glxapi_table
) / sizeof(void *);
690 generic_no_op_func(void)
697 * Initialize all functions in given dispatch table to be no-ops
700 _glxapi_set_no_op_table(struct _glxapi_table
*t
)
702 GLuint n
= _glxapi_get_dispatch_table_size();
704 void **dispatch
= (void **) t
;
705 for (i
= 0; i
< n
; i
++) {
706 dispatch
[i
] = (void *) generic_no_op_func
;
712 struct name_address_pair
{
717 static struct name_address_pair GLX_functions
[] = {
718 { "glXChooseVisual", (GLvoid
*) glXChooseVisual
},
719 { "glXCopyContext", (GLvoid
*) glXCopyContext
},
720 { "glXCreateContext", (GLvoid
*) glXCreateContext
},
721 { "glXCreateGLXPixmap", (GLvoid
*) glXCreateGLXPixmap
},
722 { "glXDestroyContext", (GLvoid
*) glXDestroyContext
},
723 { "glXDestroyGLXPixmap", (GLvoid
*) glXDestroyGLXPixmap
},
724 { "glXGetConfig", (GLvoid
*) glXGetConfig
},
725 { "glXGetCurrentContext", (GLvoid
*) glXGetCurrentContext
},
726 { "glXGetCurrentDrawable", (GLvoid
*) glXGetCurrentDrawable
},
727 { "glXIsDirect", (GLvoid
*) glXIsDirect
},
728 { "glXMakeCurrent", (GLvoid
*) glXMakeCurrent
},
729 { "glXQueryExtension", (GLvoid
*) glXQueryExtension
},
730 { "glXQueryVersion", (GLvoid
*) glXQueryVersion
},
731 { "glXSwapBuffers", (GLvoid
*) glXSwapBuffers
},
732 { "glXUseXFont", (GLvoid
*) glXUseXFont
},
733 { "glXWaitGL", (GLvoid
*) glXWaitGL
},
734 { "glXWaitX", (GLvoid
*) glXWaitX
},
736 #ifdef _GLXAPI_VERSION_1_1
737 { "glXGetClientString", (GLvoid
*) glXGetClientString
},
738 { "glXQueryExtensionsString", (GLvoid
*) glXQueryExtensionsString
},
739 { "glXQueryServerString", (GLvoid
*) glXQueryServerString
},
742 #ifdef _GLXAPI_VERSION_1_2
743 { "glXGetCurrentDisplay", (GLvoid
*) glXGetCurrentDisplay
},
746 #ifdef _GLXAPI_VERSION_1_3
747 { "glXChooseFBConfig", (GLvoid
*) glXChooseFBConfig
},
748 { "glXCreateNewContext", (GLvoid
*) glXCreateNewContext
},
749 { "glXCreatePbuffer", (GLvoid
*) glXCreatePbuffer
},
750 { "glXCreatePixmap", (GLvoid
*) glXCreatePixmap
},
751 { "glXCreateWindow", (GLvoid
*) glXCreateWindow
},
752 { "glXDestroyPbuffer", (GLvoid
*) glXDestroyPbuffer
},
753 { "glXDestroyPixmap", (GLvoid
*) glXDestroyPixmap
},
754 { "glXDestroyWindow", (GLvoid
*) glXDestroyWindow
},
755 { "glXGetCurrentReadDrawable", (GLvoid
*) glXGetCurrentReadDrawable
},
756 { "glXGetFBConfigAttrib", (GLvoid
*) glXGetFBConfigAttrib
},
757 { "glXGetSelectedEvent", (GLvoid
*) glXGetSelectedEvent
},
758 { "glXGetVisualFromFBConfig", (GLvoid
*) glXGetVisualFromFBConfig
},
759 { "glXMakeContextCurrent", (GLvoid
*) glXMakeContextCurrent
},
760 { "glXQueryContext", (GLvoid
*) glXQueryContext
},
761 { "glXQueryDrawable", (GLvoid
*) glXQueryDrawable
},
762 { "glXSelectEvent", (GLvoid
*) glXSelectEvent
},
765 #ifdef _GLXAPI_SGI_video_sync
766 { "glXGetVideoSyncSGI", (GLvoid
*) glXGetVideoSyncSGI
},
767 { "glXWaitVideoSyncSGI", (GLvoid
*) glXWaitVideoSyncSGI
},
770 #ifdef _GLXAPI_MESA_copy_sub_buffer
771 { "glXCopySubBufferMESA", (GLvoid
*) glXCopySubBufferMESA
},
774 #ifdef _GLXAPI_MESA_release_buffers
775 { "glXReleaseBuffersMESA", (GLvoid
*) glXReleaseBuffersMESA
},
778 #ifdef _GLXAPI_MESA_pixmap_colormap
779 { "glXCreateGLXPixmapMESA", (GLvoid
*) glXCreateGLXPixmapMESA
},
782 #ifdef _GLXAPI_MESA_set_3dfx_mode
783 { "glXSet3DfxModeMESA", (GLvoid
*) glXSet3DfxModeMESA
},
786 { "glXGetProcAddressARB", (GLvoid
*) glXGetProcAddressARB
},
788 { NULL
, NULL
} /* end of list */
794 * Return address of named glX function, or NULL if not found.
797 _glxapi_get_proc_address(const char *funcName
)
800 for (i
= 0; GLX_functions
[i
].Name
; i
++) {
801 if (strcmp(GLX_functions
[i
].Name
, funcName
) == 0)
802 return GLX_functions
[i
].Address
;
810 * This function does not get dispatched through the dispatch table
811 * since it's really a "meta" function.
813 void (*glXGetProcAddressARB(const GLubyte
*procName
))()
815 typedef void (*gl_function
)();
818 f
= (gl_function
) _glxapi_get_proc_address((const char *) procName
);
823 f
= (gl_function
) _glapi_get_proc_address((const char *) procName
);