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