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 54 extern "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 178 typedef struct __GLXcontextRec *GLXContext; 179 typedef XID GLXPixmap; 180 typedef XID GLXDrawable; 181 /* GLX 1.3 and later */ 182 typedef struct __GLXFBConfigRec *GLXFBConfig; 183 typedef XID GLXFBConfigID; 184 typedef XID GLXContextID; 185 typedef XID GLXWindow; 186 typedef XID GLXPbuffer; 187 188 189 190 extern XVisualInfo* glXChooseVisual( Display *dpy, int screen, 191 int *attribList ); 192 193 extern GLXContext glXCreateContext( Display *dpy, XVisualInfo *vis, 194 GLXContext shareList, Bool direct ); 195 196 extern void glXDestroyContext( Display *dpy, GLXContext ctx ); 197 198 extern Bool glXMakeCurrent( Display *dpy, GLXDrawable drawable, 199 GLXContext ctx); 200 201 extern void glXCopyContext( Display *dpy, GLXContext src, GLXContext dst, 202 unsigned long mask ); 203 204 extern void glXSwapBuffers( Display *dpy, GLXDrawable drawable ); 205 206 extern GLXPixmap glXCreateGLXPixmap( Display *dpy, XVisualInfo *visual, 207 Pixmap pixmap ); 208 209 extern void glXDestroyGLXPixmap( Display *dpy, GLXPixmap pixmap ); 210 211 extern Bool glXQueryExtension( Display *dpy, int *errorb, int *event ); 212 213 extern Bool glXQueryVersion( Display *dpy, int *maj, int *min ); 214 215 extern Bool glXIsDirect( Display *dpy, GLXContext ctx ); 216 217 extern int glXGetConfig( Display *dpy, XVisualInfo *visual, 218 int attrib, int *value ); 219 220 extern GLXContext glXGetCurrentContext( void ); 221 222 extern GLXDrawable glXGetCurrentDrawable( void ); 223 224 extern void glXWaitGL( void ); 225 226 extern void glXWaitX( void ); 227 228 extern void glXUseXFont( Font font, int first, int count, int list ); 229 230 231 232 /* GLX 1.1 and later */ 233 extern const char *glXQueryExtensionsString( Display *dpy, int screen ); 234 235 extern const char *glXQueryServerString( Display *dpy, int screen, int name ); 236 237 extern const char *glXGetClientString( Display *dpy, int name ); 238 239 240 /* GLX 1.2 and later */ 241 extern Display *glXGetCurrentDisplay( void ); 242 243 244 /* GLX 1.3 and later */ 245 extern GLXFBConfig *glXChooseFBConfig( Display *dpy, int screen, 246 const int *attribList, int *nitems ); 247 248 extern int glXGetFBConfigAttrib( Display *dpy, GLXFBConfig config, 249 int attribute, int *value ); 250 251 extern GLXFBConfig *glXGetFBConfigs( Display *dpy, int screen, 252 int *nelements ); 253 254 extern XVisualInfo *glXGetVisualFromFBConfig( Display *dpy, 255 GLXFBConfig config ); 256 257 extern GLXWindow glXCreateWindow( Display *dpy, GLXFBConfig config, 258 Window win, const int *attribList ); 259 260 extern void glXDestroyWindow( Display *dpy, GLXWindow window ); 261 262 extern GLXPixmap glXCreatePixmap( Display *dpy, GLXFBConfig config, 263 Pixmap pixmap, const int *attribList ); 264 265 extern void glXDestroyPixmap( Display *dpy, GLXPixmap pixmap ); 266 267 extern GLXPbuffer glXCreatePbuffer( Display *dpy, GLXFBConfig config, 268 const int *attribList ); 269 270 extern void glXDestroyPbuffer( Display *dpy, GLXPbuffer pbuf ); 271 272 extern void glXQueryDrawable( Display *dpy, GLXDrawable draw, int attribute, 273 unsigned int *value ); 274 275 extern GLXContext glXCreateNewContext( Display *dpy, GLXFBConfig config, 276 int renderType, GLXContext shareList, 277 Bool direct ); 278 279 extern Bool glXMakeContextCurrent( Display *dpy, GLXDrawable draw, 280 GLXDrawable read, GLXContext ctx ); 281 282 extern GLXDrawable glXGetCurrentReadDrawable( void ); 283 284 extern int glXQueryContext( Display *dpy, GLXContext ctx, int attribute, 285 int *value ); 286 287 extern void glXSelectEvent( Display *dpy, GLXDrawable drawable, 288 unsigned long mask ); 289 290 extern void glXGetSelectedEvent( Display *dpy, GLXDrawable drawable, 291 unsigned long *mask ); 292 293 294 /* GLX 1.4 and later */ 295 extern void (*glXGetProcAddress(const GLubyte *procname))( void ); 296 297 298 #ifndef GLX_GLXEXT_LEGACY 299 300 #include <GL/glxext.h> 301 302 #else 303 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 312 typedef void (*__GLXextFuncPtr)(void); 313 extern __GLXextFuncPtr glXGetProcAddressARB (const GLubyte *); 314 315 #endif /* GLX_ARB_get_proc_address */ 316 317 318 319 #endif /* GLX_GLXEXT_LEGACY */ 320 321 322 /** 323 ** The following aren't in glxext.h yet. 324 **/ 325 326 327 /* 328 * ???. GLX_NV_vertex_array_range 329 */ 330 #ifndef GLX_NV_vertex_array_range 331 #define GLX_NV_vertex_array_range 332 333 extern void *glXAllocateMemoryNV(GLsizei size, GLfloat readfreq, GLfloat writefreq, GLfloat priority); 334 extern void glXFreeMemoryNV(GLvoid *pointer); 335 typedef void * ( * PFNGLXALLOCATEMEMORYNVPROC) (GLsizei size, GLfloat readfreq, GLfloat writefreq, GLfloat priority); 336 typedef void ( * PFNGLXFREEMEMORYNVPROC) (GLvoid *pointer); 337 338 #endif /* GLX_NV_vertex_array_range */ 339 340 341 /* 342 * ???. GLX_MESA_allocate_memory 343 */ 344 #ifndef GLX_MESA_allocate_memory 345 #define GLX_MESA_allocate_memory 1 346 347 extern void *glXAllocateMemoryMESA(Display *dpy, int scrn, size_t size, float readfreq, float writefreq, float priority); 348 extern void glXFreeMemoryMESA(Display *dpy, int scrn, void *pointer); 349 extern GLuint glXGetMemoryOffsetMESA(Display *dpy, int scrn, const void *pointer); 350 typedef void * ( * PFNGLXALLOCATEMEMORYMESAPROC) (Display *dpy, int scrn, size_t size, float readfreq, float writefreq, float priority); 351 typedef void ( * PFNGLXFREEMEMORYMESAPROC) (Display *dpy, int scrn, void *pointer); 352 typedef GLuint (* PFNGLXGETMEMORYOFFSETMESAPROC) (Display *dpy, int scrn, const void *pointer); 353 354 #endif /* GLX_MESA_allocate_memory */ 355 356 357 /* 358 * ARB ?. GLX_ARB_render_texture 359 * XXX This was never finalized! 360 */ 361 #ifndef GLX_ARB_render_texture 362 #define GLX_ARB_render_texture 1 363 364 extern Bool glXBindTexImageARB(Display *dpy, GLXPbuffer pbuffer, int buffer); 365 extern Bool glXReleaseTexImageARB(Display *dpy, GLXPbuffer pbuffer, int buffer); 366 extern Bool glXDrawableAttribARB(Display *dpy, GLXDrawable draw, const int *attribList); 367 368 #endif /* GLX_ARB_render_texture */ 369 370 371 /* 372 * Remove this when glxext.h is updated. 373 */ 374 #ifndef GLX_NV_float_buffer 375 #define GLX_NV_float_buffer 1 376 377 #define GLX_FLOAT_COMPONENTS_NV 0x20B0 378 379 #endif /* GLX_NV_float_buffer */ 380 381 382 383 /* 384 * #?. GLX_MESA_swap_frame_usage 385 */ 386 #ifndef GLX_MESA_swap_frame_usage 387 #define GLX_MESA_swap_frame_usage 1 388 389 extern int glXGetFrameUsageMESA(Display *dpy, GLXDrawable drawable, float *usage); 390 extern int glXBeginFrameTrackingMESA(Display *dpy, GLXDrawable drawable); 391 extern int glXEndFrameTrackingMESA(Display *dpy, GLXDrawable drawable); 392 extern int glXQueryFrameTrackingMESA(Display *dpy, GLXDrawable drawable, int64_t *swapCount, int64_t *missedFrames, float *lastMissedUsage); 393 394 typedef int (*PFNGLXGETFRAMEUSAGEMESAPROC) (Display *dpy, GLXDrawable drawable, float *usage); 395 typedef int (*PFNGLXBEGINFRAMETRACKINGMESAPROC)(Display *dpy, GLXDrawable drawable); 396 typedef int (*PFNGLXENDFRAMETRACKINGMESAPROC)(Display *dpy, GLXDrawable drawable); 397 typedef int (*PFNGLXQUERYFRAMETRACKINGMESAPROC)(Display *dpy, GLXDrawable drawable, int64_t *swapCount, int64_t *missedFrames, float *lastMissedUsage); 398 399 #endif /* GLX_MESA_swap_frame_usage */ 400 401 402 403 /* 404 * #?. GLX_MESA_swap_control 405 */ 406 #ifndef GLX_MESA_swap_control 407 #define GLX_MESA_swap_control 1 408 409 extern int glXSwapIntervalMESA(unsigned int interval); 410 extern int glXGetSwapIntervalMESA(void); 411 412 typedef int (*PFNGLXSWAPINTERVALMESAPROC)(unsigned int interval); 413 typedef int (*PFNGLXGETSWAPINTERVALMESAPROC)(void); 414 415 #endif /* GLX_MESA_swap_control */ 416 417 418 419 /* 420 * #?. GLX_EXT_texture_from_pixmap 421 * XXX not finished? 422 */ 423 #ifndef GLX_EXT_texture_from_pixmap 424 #define GLX_EXT_texture_from_pixmap 1 425 426 #define GLX_BIND_TO_TEXTURE_RGB_EXT 0x20D0 427 #define GLX_BIND_TO_TEXTURE_RGBA_EXT 0x20D1 428 #define GLX_BIND_TO_MIPMAP_TEXTURE_EXT 0x20D2 429 #define GLX_BIND_TO_TEXTURE_TARGETS_EXT 0x20D3 430 #define GLX_Y_INVERTED_EXT 0x20D4 431 432 #define GLX_TEXTURE_FORMAT_EXT 0x20D5 433 #define GLX_TEXTURE_TARGET_EXT 0x20D6 434 #define GLX_MIPMAP_TEXTURE_EXT 0x20D7 435 436 #define GLX_TEXTURE_FORMAT_NONE_EXT 0x20D8 437 #define GLX_TEXTURE_FORMAT_RGB_EXT 0x20D9 438 #define GLX_TEXTURE_FORMAT_RGBA_EXT 0x20DA 439 440 #define GLX_TEXTURE_1D_BIT_EXT 0x00000001 441 #define GLX_TEXTURE_2D_BIT_EXT 0x00000002 442 #define GLX_TEXTURE_RECTANGLE_BIT_EXT 0x00000004 443 444 #define GLX_TEXTURE_1D_EXT 0x20DB 445 #define GLX_TEXTURE_2D_EXT 0x20DC 446 #define GLX_TEXTURE_RECTANGLE_EXT 0x20DD 447 448 #define GLX_FRONT_LEFT_EXT 0x20DE 449 #define GLX_FRONT_RIGHT_EXT 0x20DF 450 #define GLX_BACK_LEFT_EXT 0x20E0 451 #define GLX_BACK_RIGHT_EXT 0x20E1 452 #define GLX_FRONT_EXT GLX_FRONT_LEFT_EXT 453 #define GLX_BACK_EXT GLX_BACK_LEFT_EXT 454 #define GLX_AUX0_EXT 0x20E2 455 #define GLX_AUX1_EXT 0x20E3 456 #define GLX_AUX2_EXT 0x20E4 457 #define GLX_AUX3_EXT 0x20E5 458 #define GLX_AUX4_EXT 0x20E6 459 #define GLX_AUX5_EXT 0x20E7 460 #define GLX_AUX6_EXT 0x20E8 461 #define GLX_AUX7_EXT 0x20E9 462 #define GLX_AUX8_EXT 0x20EA 463 #define GLX_AUX9_EXT 0x20EB 464 465 extern void glXBindTexImageEXT(Display *dpy, GLXDrawable drawable, int buffer, const int *attrib_list); 466 extern void glXReleaseTexImageEXT(Display *dpy, GLXDrawable drawable, int buffer); 467 468 #endif /* GLX_EXT_texture_from_pixmap */ 469 470 471 472 473 /*** Should these go here, or in another header? */ 474 /* 475 ** GLX Events 476 */ 477 typedef struct { 478 int event_type; /* GLX_DAMAGED or GLX_SAVED */ 479 int draw_type; /* GLX_WINDOW or GLX_PBUFFER */ 480 unsigned long serial; /* # of last request processed by server */ 481 Bool send_event; /* true if this came for SendEvent request */ 482 Display *display; /* display the event was read from */ 483 GLXDrawable drawable; /* XID of Drawable */ 484 unsigned int buffer_mask; /* mask indicating which buffers are affected */ 485 unsigned int aux_buffer; /* which aux buffer was affected */ 486 int x, y; 487 int width, height; 488 int count; /* if nonzero, at least this many more */ 489 } GLXPbufferClobberEvent; 490 491 typedef union __GLXEvent { 492 GLXPbufferClobberEvent glxpbufferclobber; 493 long pad[24]; 494 } GLXEvent; 495 496 #ifdef __cplusplus 497 } 498 #endif 499 500 #endif 501