src/glx/glxclient.h

   1 /*
   2  * SGI FREE SOFTWARE LICENSE B (Version 2.0, Sept. 18, 2008)
   3  * Copyright (C) 1991-2000 Silicon Graphics, Inc. All Rights Reserved.
   4  *
   5  * Permission is hereby granted, free of charge, to any person obtaining a
   6  * copy of this software and associated documentation files (the "Software"),
   7  * to deal in the Software without restriction, including without limitation
   8  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   9  * and/or sell copies of the Software, and to permit persons to whom the
  10  * Software is furnished to do so, subject to the following conditions:
  11  *
  12  * The above copyright notice including the dates of first publication and
  13  * either this permission notice or a reference to
  14  * http://oss.sgi.com/projects/FreeB/
  15  * shall be included 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  * SILICON GRAPHICS, INC. BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
  21  * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
  22  * OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  23  * SOFTWARE.
  24  *
  25  * Except as contained in this notice, the name of Silicon Graphics, Inc.
  26  * shall not be used in advertising or otherwise to promote the sale, use or
  27  * other dealings in this Software without prior written authorization from
  28  * Silicon Graphics, Inc.
  29  */
  30
  31 /**
  32  * \file glxclient.h
  33  * Direct rendering support added by Precision Insight, Inc.
  34  *
  35  * \author Kevin E. Martin <kevin@precisioninsight.com>
  36  */
  37
  38 #ifndef _GLX_client_h_
  39 #define _GLX_client_h_
  40 #include <X11/Xproto.h>
  41 #include <X11/Xlibint.h>
  42 #include <X11/Xfuncproto.h>
  43 #include <X11/extensions/extutil.h>
  44 #define GLX_GLXEXT_PROTOTYPES
  45 #include <GL/glx.h>
  46 #include <GL/glxext.h>
  47 #include <string.h>
  48 #include <stdlib.h>
  49 #include <stdio.h>
  50 #include <stdint.h>
  51 #include <pthread.h>
  52 #include "GL/glxproto.h"
  53 #include "glxconfig.h"
  54 #include "glxhash.h"
  55 #include "util/macros.h"
  56
  57 #include "glxextensions.h"
  58
  59 #if defined(USE_LIBGLVND_GLX)
  60 #define _GLX_PUBLIC _X_HIDDEN
  61 #else
  62 #define _GLX_PUBLIC _X_EXPORT
  63 #endif
  64
  65 #ifdef __cplusplus
  66 extern "C" {
  67 #endif
  68
  69
  70 #define GLX_MAJOR_VERSION 1       /* current version numbers */
  71 #define GLX_MINOR_VERSION 4
  72
  73 #define __GLX_MAX_TEXTURE_UNITS 32
  74
  75 struct glx_display;
  76 struct glx_context;
  77
  78 /************************************************************************/
  79
  80 #ifdef GLX_DIRECT_RENDERING
  81
  82 extern void DRI_glXUseXFont(struct glx_context *ctx,
  83                             Font font, int first, int count, int listbase);
  84
  85 #endif
  86
  87 #if defined(GLX_DIRECT_RENDERING) && !defined(GLX_USE_APPLEGL)
  88
  89 /**
  90  * Display dependent methods.  This structure is initialized during the
  91  * \c driCreateDisplay call.
  92  */
  93 typedef struct __GLXDRIdisplayRec __GLXDRIdisplay;
  94 typedef struct __GLXDRIscreenRec __GLXDRIscreen;
  95 typedef struct __GLXDRIdrawableRec __GLXDRIdrawable;
  96
  97 struct __GLXDRIdisplayRec
  98 {
  99     /**
 100      * Method to destroy the private DRI display data.
 101      */
 102    void (*destroyDisplay) (__GLXDRIdisplay * display);
 103
 104    struct glx_screen *(*createScreen)(int screen, struct glx_display * priv);
 105 };
 106
 107 struct __GLXDRIscreenRec {
 108
 109    void (*destroyScreen)(struct glx_screen *psc);
 110
 111    struct glx_context *(*createContext)(struct glx_screen *psc,
 112                                         struct glx_config *config,
 113                                         struct glx_context *shareList,
 114                                         int renderType);
 115
 116    __GLXDRIdrawable *(*createDrawable)(struct glx_screen *psc,
 117                                        XID drawable,
 118                                        GLXDrawable glxDrawable,
 119                                        struct glx_config *config);
 120
 121    int64_t (*swapBuffers)(__GLXDRIdrawable *pdraw, int64_t target_msc,
 122                           int64_t divisor, int64_t remainder, Bool flush);
 123    void (*copySubBuffer)(__GLXDRIdrawable *pdraw,
 124                          int x, int y, int width, int height, Bool flush);
 125    int (*getDrawableMSC)(struct glx_screen *psc, __GLXDRIdrawable *pdraw,
 126                          int64_t *ust, int64_t *msc, int64_t *sbc);
 127    int (*waitForMSC)(__GLXDRIdrawable *pdraw, int64_t target_msc,
 128                      int64_t divisor, int64_t remainder, int64_t *ust,
 129                      int64_t *msc, int64_t *sbc);
 130    int (*waitForSBC)(__GLXDRIdrawable *pdraw, int64_t target_sbc, int64_t *ust,
 131                      int64_t *msc, int64_t *sbc);
 132    int (*setSwapInterval)(__GLXDRIdrawable *pdraw, int interval);
 133    int (*getSwapInterval)(__GLXDRIdrawable *pdraw);
 134    int (*getBufferAge)(__GLXDRIdrawable *pdraw);
 135 };
 136
 137 struct __GLXDRIdrawableRec
 138 {
 139    void (*destroyDrawable) (__GLXDRIdrawable * drawable);
 140
 141    XID xDrawable;
 142    XID drawable;
 143    struct glx_screen *psc;
 144    GLenum textureTarget;
 145    GLenum textureFormat;        /* EXT_texture_from_pixmap support */
 146    unsigned long eventMask;
 147    int refcount;
 148 };
 149
 150 /*
 151 ** Function to create and DRI display data and initialize the display
 152 ** dependent methods.
 153 */
 154 extern __GLXDRIdisplay *driswCreateDisplay(Display * dpy);
 155 extern __GLXDRIdisplay *driCreateDisplay(Display * dpy);
 156 extern __GLXDRIdisplay *dri2CreateDisplay(Display * dpy);
 157 extern void dri2InvalidateBuffers(Display *dpy, XID drawable);
 158 extern unsigned dri2GetSwapEventType(Display *dpy, XID drawable);
 159
 160 extern __GLXDRIdisplay *dri3_create_display(Display * dpy);
 161
 162 /*
 163 ** Functions to obtain driver configuration information from a direct
 164 ** rendering client application
 165 */
 166 extern const char *glXGetScreenDriver(Display * dpy, int scrNum);
 167
 168 extern const char *glXGetDriverConfig(const char *driverName);
 169
 170 #endif
 171
 172 /************************************************************************/
 173
 174 #define __GL_CLIENT_ATTRIB_STACK_DEPTH 16
 175
 176 typedef struct __GLXpixelStoreModeRec
 177 {
 178    GLboolean swapEndian;
 179    GLboolean lsbFirst;
 180    GLuint rowLength;
 181    GLuint imageHeight;
 182    GLuint imageDepth;
 183    GLuint skipRows;
 184    GLuint skipPixels;
 185    GLuint skipImages;
 186    GLuint alignment;
 187 } __GLXpixelStoreMode;
 188
 189
 190 typedef struct __GLXattributeRec
 191 {
 192    GLuint mask;
 193
 194     /**
 195      * Pixel storage state.  Most of the pixel store mode state is kept
 196      * here and used by the client code to manage the packing and
 197      * unpacking of data sent to/received from the server.
 198      */
 199    __GLXpixelStoreMode storePack, storeUnpack;
 200
 201     /**
 202      * Is EXT_vertex_array / GL 1.1 DrawArrays protocol specifically
 203      * disabled?
 204      */
 205    GLboolean NoDrawArraysProtocol;
 206
 207     /**
 208      * Vertex Array storage state.  The vertex array component
 209      * state is stored here and is used to manage the packing of
 210      * DrawArrays data sent to the server.
 211      */
 212    struct array_state_vector *array_state;
 213 } __GLXattribute;
 214
 215 typedef struct __GLXattributeMachineRec
 216 {
 217    __GLXattribute *stack[__GL_CLIENT_ATTRIB_STACK_DEPTH];
 218    __GLXattribute **stackPointer;
 219 } __GLXattributeMachine;
 220
 221 struct mesa_glinterop_device_info;
 222 struct mesa_glinterop_export_in;
 223 struct mesa_glinterop_export_out;
 224
 225 struct glx_context_vtable {
 226    void (*destroy)(struct glx_context *ctx);
 227    int (*bind)(struct glx_context *context, struct glx_context *old,
 228                GLXDrawable draw, GLXDrawable read);
 229    void (*unbind)(struct glx_context *context, struct glx_context *new_ctx);
 230    void (*wait_gl)(struct glx_context *ctx);
 231    void (*wait_x)(struct glx_context *ctx);
 232    void (*use_x_font)(struct glx_context *ctx,
 233                       Font font, int first, int count, int listBase);
 234    void (*bind_tex_image)(Display * dpy,
 235                           GLXDrawable drawable,
 236                           int buffer, const int *attrib_list);
 237    void (*release_tex_image)(Display * dpy, GLXDrawable drawable, int buffer);
 238    void * (*get_proc_address)(const char *symbol);
 239    int (*interop_query_device_info)(struct glx_context *ctx,
 240                                     struct mesa_glinterop_device_info *out);
 241    int (*interop_export_object)(struct glx_context *ctx,
 242                                 struct mesa_glinterop_export_in *in,
 243                                 struct mesa_glinterop_export_out *out);
 244 };
 245
 246 /**
 247  * GLX state that needs to be kept on the client.  One of these records
 248  * exist for each context that has been made current by this client.
 249  */
 250 struct glx_context
 251 {
 252     /**
 253      * \name Drawing command buffer.
 254      *
 255      * Drawing commands are packed into this buffer before being sent as a
 256      * single GLX protocol request.  The buffer is sent when it overflows or
 257      * is flushed by \c __glXFlushRenderBuffer.  \c pc is the next location
 258      * in the buffer to be filled.  \c limit is described above in the buffer
 259      * slop discussion.
 260      *
 261      * Commands that require large amounts of data to be transfered will
 262      * also use this buffer to hold a header that describes the large
 263      * command.
 264      *
 265      * These must be the first 6 fields since they are static initialized
 266      * in the dummy context in glxext.c
 267      */
 268    /*@{ */
 269    GLubyte *buf;
 270    GLubyte *pc;
 271    GLubyte *limit;
 272    GLubyte *bufEnd;
 273    GLint bufSize;
 274    /*@} */
 275
 276    const struct glx_context_vtable *vtable;
 277
 278     /**
 279      * The XID of this rendering context.  When the context is created a
 280      * new XID is allocated.  This is set to None when the context is
 281      * destroyed but is still current to some thread. In this case the
 282      * context will be freed on next MakeCurrent.
 283      */
 284    XID xid;
 285
 286     /**
 287      * The XID of the \c shareList context.
 288      */
 289    XID share_xid;
 290
 291     /**
 292      * Screen number.
 293      */
 294    GLint screen;
 295    struct glx_screen *psc;
 296
 297     /**
 298      * \c GL_TRUE if the context was created with ImportContext, which
 299      * means the server-side context was created by another X client.
 300      */
 301    GLboolean imported;
 302
 303     /**
 304      * The context tag returned by MakeCurrent when this context is made
 305      * current. This tag is used to identify the context that a thread has
 306      * current so that proper server context management can be done.  It is
 307      * used for all context specific commands (i.e., \c Render, \c RenderLarge,
 308      * \c WaitX, \c WaitGL, \c UseXFont, and \c MakeCurrent (for the old
 309      * context)).
 310      */
 311    GLXContextTag currentContextTag;
 312
 313     /**
 314      * \name Rendering mode
 315      *
 316      * The rendering mode is kept on the client as well as the server.
 317      * When \c glRenderMode is called, the buffer associated with the
 318      * previous rendering mode (feedback or select) is filled.
 319      */
 320    /*@{ */
 321    GLenum renderMode;
 322    GLfloat *feedbackBuf;
 323    GLuint *selectBuf;
 324    /*@} */
 325
 326     /**
 327      * Fill newImage with the unpacked form of \c oldImage getting it
 328      * ready for transport to the server.
 329      */
 330    void (*fillImage) (struct glx_context *, GLint, GLint, GLint, GLint, GLenum,
 331                       GLenum, const GLvoid *, GLubyte *, GLubyte *);
 332
 333     /**
 334      * Client side attribs.
 335      */
 336    __GLXattributeMachine attributes;
 337
 338     /**
 339      * Client side error code.  This is set when client side gl API
 340      * routines need to set an error because of a bad enumerant or
 341      * running out of memory, etc.
 342      */
 343    GLenum error;
 344
 345     /**
 346      * Whether this context does direct rendering.
 347      */
 348    Bool isDirect;
 349
 350 #if defined(GLX_DIRECT_RENDERING) && defined(GLX_USE_APPLEGL)
 351    void *driContext;
 352 #endif
 353
 354     /**
 355      * \c dpy of current display for this context.  Will be \c NULL if not
 356      * current to any display, or if this is the "dummy context".
 357      */
 358    Display *currentDpy;
 359
 360     /**
 361      * The current drawable for this context.  Will be None if this
 362      * context is not current to any drawable.  currentReadable is below.
 363      */
 364    GLXDrawable currentDrawable;
 365
 366     /**
 367      * \name GL Constant Strings
 368      *
 369      * Constant strings that describe the server implementation
 370      * These pertain to GL attributes, not to be confused with
 371      * GLX versioning attributes.
 372      */
 373    /*@{ */
 374    GLubyte *vendor;
 375    GLubyte *renderer;
 376    GLubyte *version;
 377    GLubyte *extensions;
 378    /*@} */
 379
 380     /**
 381      * Maximum small render command size.  This is the smaller of 64k and
 382      * the size of the above buffer.
 383      */
 384    GLint maxSmallRenderCommandSize;
 385
 386     /**
 387      * Major opcode for the extension.  Copied here so a lookup isn't
 388      * needed.
 389      */
 390    GLint majorOpcode;
 391
 392     /**
 393      * Pointer to the config used to create this context.
 394      */
 395    struct glx_config *config;
 396
 397     /**
 398      * The current read-drawable for this context.  Will be None if this
 399      * context is not current to any drawable.
 400      *
 401      * \since Internal API version 20030606.
 402      */
 403    GLXDrawable currentReadable;
 404
 405    /**
 406     * Pointer to client-state data that is private to libGL.  This is only
 407     * used for indirect rendering contexts.
 408     *
 409     * No internal API version change was made for this change.  Client-side
 410     * drivers should NEVER use this data or even care that it exists.
 411     */
 412    void *client_state_private;
 413
 414    /**
 415     * Stored value for \c glXQueryContext attribute \c GLX_RENDER_TYPE.
 416     */
 417    int renderType;
 418
 419    /**
 420     * \name Raw server GL version
 421     *
 422     * True core GL version supported by the server.  This is the raw value
 423     * returned by the server, and it may not reflect what is actually
 424     * supported (or reported) by the client-side library.
 425     */
 426    /*@{ */
 427    int server_major;        /**< Major version number. */
 428    int server_minor;        /**< Minor version number. */
 429    /*@} */
 430
 431    /**
 432     * Number of threads we're currently current in.
 433     */
 434    unsigned long thread_refcount;
 435
 436    char gl_extension_bits[__GL_EXT_BYTES];
 437 };
 438
 439 extern Bool
 440 glx_context_init(struct glx_context *gc,
 441                  struct glx_screen *psc, struct glx_config *fbconfig);
 442
 443 #define __glXSetError(gc,code)  \
 444    if (!(gc)->error) {          \
 445       (gc)->error = code;       \
 446    }
 447
 448 extern void __glFreeAttributeState(struct glx_context *);
 449
 450 /************************************************************************/
 451
 452 /**
 453  * The size of the largest drawing command known to the implementation
 454  * that will use the GLXRender GLX command.  In this case it is
 455  * \c glPolygonStipple.
 456  */
 457 #define __GLX_MAX_SMALL_RENDER_CMD_SIZE 156
 458
 459 /**
 460  * To keep the implementation fast, the code uses a "limit" pointer
 461  * to determine when the drawing command buffer is too full to hold
 462  * another fixed size command.  This constant defines the amount of
 463  * space that must always be available in the drawing command buffer
 464  * at all times for the implementation to work.  It is important that
 465  * the number be just large enough, but not so large as to reduce the
 466  * efficacy of the buffer.  The "+32" is just to keep the code working
 467  * in case somebody counts wrong.
 468  */
 469 #define __GLX_BUFFER_LIMIT_SIZE (__GLX_MAX_SMALL_RENDER_CMD_SIZE + 32)
 470
 471 /**
 472  * This implementation uses a smaller threshold for switching
 473  * to the RenderLarge protocol than the protcol requires so that
 474  * large copies don't occur.
 475  */
 476 #define __GLX_RENDER_CMD_SIZE_LIMIT 4096
 477
 478 /**
 479  * One of these records exists per screen of the display.  It contains
 480  * a pointer to the config data for that screen (if the screen supports GL).
 481  */
 482 struct glx_screen_vtable {
 483    struct glx_context *(*create_context)(struct glx_screen *psc,
 484                                          struct glx_config *config,
 485                                          struct glx_context *shareList,
 486                                          int renderType);
 487
 488    struct glx_context *(*create_context_attribs)(struct glx_screen *psc,
 489                                                  struct glx_config *config,
 490                                                  struct glx_context *shareList,
 491                                                  unsigned num_attrib,
 492                                                  const uint32_t *attribs,
 493                                                  unsigned *error);
 494    int (*query_renderer_integer)(struct glx_screen *psc,
 495                                  int attribute,
 496                                  unsigned int *value);
 497    int (*query_renderer_string)(struct glx_screen *psc,
 498                                 int attribute,
 499                                 const char **value);
 500 };
 501
 502 struct glx_screen
 503 {
 504    const struct glx_screen_vtable *vtable;
 505
 506     /**
 507      * GLX extension string reported by the X-server.
 508      */
 509    const char *serverGLXexts;
 510
 511     /**
 512      * GLX extension string to be reported to applications.  This is the
 513      * set of extensions that the application can actually use.
 514      */
 515    char *effectiveGLXexts;
 516
 517    struct glx_display *display;
 518
 519    Display *dpy;
 520    int scr;
 521
 522 #if defined(GLX_DIRECT_RENDERING) && !defined(GLX_USE_APPLEGL)
 523     /**
 524      * Per screen direct rendering interface functions and data.
 525      */
 526    __GLXDRIscreen *driScreen;
 527 #endif
 528
 529     /**
 530      * Linked list of glx visuals and  fbconfigs for this screen.
 531      */
 532    struct glx_config *visuals, *configs;
 533
 534     /**
 535      * Per-screen dynamic GLX extension tracking.  The \c direct_support
 536      * field only contains enough bits for 64 extensions.  Should libGL
 537      * ever need to track more than 64 GLX extensions, we can safely grow
 538      * this field.  The \c struct glx_screen structure is not used outside
 539      * libGL.
 540      */
 541    /*@{ */
 542    unsigned char direct_support[8];
 543    GLboolean ext_list_first_time;
 544    /*@} */
 545
 546 };
 547
 548 /**
 549  * Per display private data.  One of these records exists for each display
 550  * that is using the OpenGL (GLX) extension.
 551  */
 552 struct glx_display
 553 {
 554    /* The extension protocol codes */
 555    XExtCodes *codes;
 556    struct glx_display *next;
 557
 558     /**
 559      * Back pointer to the display
 560      */
 561    Display *dpy;
 562
 563     /**
 564      * The \c majorOpcode is common to all connections to the same server.
 565      * It is also copied into the context structure.
 566      */
 567    int majorOpcode;
 568
 569     /**
 570      * \name Server Version
 571      *
 572      * Major and minor version returned by the server during initialization.
 573      */
 574    /*@{ */
 575    int majorVersion, minorVersion;
 576    /*@} */
 577
 578     /**
 579      * \name Storage for the servers GLX vendor and versions strings.
 580      *
 581      * These are the same for all screens on this display. These fields will
 582      * be filled in on demand.
 583      */
 584    /*@{ */
 585    const char *serverGLXvendor;
 586    const char *serverGLXversion;
 587    /*@} */
 588
 589     /**
 590      * Configurations of visuals for all screens on this display.
 591      * Also, per screen data which now includes the server \c GLX_EXTENSION
 592      * string.
 593      */
 594    struct glx_screen **screens;
 595
 596    __glxHashTable *glXDrawHash;
 597
 598 #if defined(GLX_DIRECT_RENDERING) && !defined(GLX_USE_APPLEGL)
 599    __glxHashTable *drawHash;
 600
 601     /**
 602      * Per display direct rendering interface functions and data.
 603      */
 604    __GLXDRIdisplay *driswDisplay;
 605    __GLXDRIdisplay *driDisplay;
 606    __GLXDRIdisplay *dri2Display;
 607    __GLXDRIdisplay *dri3Display;
 608 #endif
 609 };
 610
 611 struct glx_drawable {
 612    XID xDrawable;
 613    XID drawable;
 614
 615    uint32_t lastEventSbc;
 616    int64_t eventSbcWrap;
 617 };
 618
 619 extern int
 620 glx_screen_init(struct glx_screen *psc,
 621                 int screen, struct glx_display * priv);
 622 extern void
 623 glx_screen_cleanup(struct glx_screen *psc);
 624
 625 #if defined(GLX_DIRECT_RENDERING) && !defined(GLX_USE_APPLEGL)
 626 extern __GLXDRIdrawable *
 627 dri2GetGlxDrawableFromXDrawableId(Display *dpy, XID id);
 628 #endif
 629
 630 extern GLubyte *__glXFlushRenderBuffer(struct glx_context *, GLubyte *);
 631
 632 extern void __glXSendLargeChunk(struct glx_context * gc, GLint requestNumber,
 633                                 GLint totalRequests,
 634                                 const GLvoid * data, GLint dataLen);
 635
 636 extern void __glXSendLargeCommand(struct glx_context *, const GLvoid *, GLint,
 637                                   const GLvoid *, GLint);
 638
 639 /* Initialize the GLX extension for dpy */
 640 extern struct glx_display *__glXInitialize(Display *);
 641
 642 extern void __glXPreferEGL(int state);
 643
 644 /************************************************************************/
 645
 646 extern int __glXDebug;
 647
 648 /* This is per-thread storage in an MT environment */
 649
 650 extern void __glXSetCurrentContext(struct glx_context * c);
 651
 652 # if defined( GLX_USE_TLS )
 653
 654 extern __thread void *__glX_tls_Context
 655    __attribute__ ((tls_model("initial-exec")));
 656
 657 #  define __glXGetCurrentContext() __glX_tls_Context
 658
 659 # else
 660
 661 extern struct glx_context *__glXGetCurrentContext(void);
 662
 663 # endif /* defined( GLX_USE_TLS ) */
 664
 665 extern void __glXSetCurrentContextNull(void);
 666
 667
 668 /*
 669 ** Global lock for all threads in this address space using the GLX
 670 ** extension
 671 */
 672 extern pthread_mutex_t __glXmutex;
 673 #define __glXLock()    pthread_mutex_lock(&__glXmutex)
 674 #define __glXUnlock()  pthread_mutex_unlock(&__glXmutex)
 675
 676 /*
 677 ** Setup for a command.  Initialize the extension for dpy if necessary.
 678 */
 679 extern CARD8 __glXSetupForCommand(Display * dpy);
 680
 681 /************************************************************************/
 682
 683 /*
 684 ** Data conversion and packing support.
 685 */
 686
 687 extern const GLuint __glXDefaultPixelStore[9];
 688
 689 /* Send an image to the server using RenderLarge. */
 690 extern void __glXSendLargeImage(struct glx_context * gc, GLint compsize, GLint dim,
 691                                 GLint width, GLint height, GLint depth,
 692                                 GLenum format, GLenum type,
 693                                 const GLvoid * src, GLubyte * pc,
 694                                 GLubyte * modes);
 695
 696 /* Return the size, in bytes, of some pixel data */
 697 extern GLint __glImageSize(GLint, GLint, GLint, GLenum, GLenum, GLenum);
 698
 699 /* Return the number of elements per group of a specified format*/
 700 extern GLint __glElementsPerGroup(GLenum format, GLenum type);
 701
 702 /* Return the number of bytes per element, based on the element type (other
 703 ** than GL_BITMAP).
 704 */
 705 extern GLint __glBytesPerElement(GLenum type);
 706
 707 /*
 708 ** Fill the transport buffer with the data from the users buffer,
 709 ** applying some of the pixel store modes (unpack modes) to the data
 710 ** first.  As a side effect of this call, the "modes" field is
 711 ** updated to contain the modes needed by the server to decode the
 712 ** sent data.
 713 */
 714 extern void __glFillImage(struct glx_context *, GLint, GLint, GLint, GLint, GLenum,
 715                           GLenum, const GLvoid *, GLubyte *, GLubyte *);
 716
 717 /* Copy map data with a stride into a packed buffer */
 718 extern void __glFillMap1f(GLint, GLint, GLint, const GLfloat *, GLubyte *);
 719 extern void __glFillMap1d(GLint, GLint, GLint, const GLdouble *, GLubyte *);
 720 extern void __glFillMap2f(GLint, GLint, GLint, GLint, GLint,
 721                           const GLfloat *, GLfloat *);
 722 extern void __glFillMap2d(GLint, GLint, GLint, GLint, GLint,
 723                           const GLdouble *, GLdouble *);
 724
 725 /*
 726 ** Empty an image out of the reply buffer into the clients memory applying
 727 ** the pack modes to pack back into the clients requested format.
 728 */
 729 extern void __glEmptyImage(struct glx_context *, GLint, GLint, GLint, GLint, GLenum,
 730                            GLenum, const GLubyte *, GLvoid *);
 731
 732
 733 /*
 734 ** Allocate and Initialize Vertex Array client state, and free.
 735 */
 736 extern void __glXInitVertexArrayState(struct glx_context *);
 737 extern void __glXFreeVertexArrayState(struct glx_context *);
 738
 739 /*
 740 ** Inform the Server of the major and minor numbers and of the client
 741 ** libraries extension string.
 742 */
 743 extern void __glXClientInfo(Display * dpy, int opcode);
 744
 745 _X_HIDDEN void
 746 __glX_send_client_info(struct glx_display *glx_dpy);
 747
 748 /************************************************************************/
 749
 750 /*
 751 ** Declarations that should be in Xlib
 752 */
 753 #ifdef __GL_USE_OUR_PROTOTYPES
 754 extern void _XFlush(Display *);
 755 extern Status _XReply(Display *, xReply *, int, Bool);
 756 extern void _XRead(Display *, void *, long);
 757 extern void _XSend(Display *, const void *, long);
 758 #endif
 759
 760
 761 extern void __glXInitializeVisualConfigFromTags(struct glx_config * config,
 762                                                 int count, const INT32 * bp,
 763                                                 Bool tagged_only,
 764                                                 Bool fbconfig_style_tags);
 765
 766 extern char *__glXQueryServerString(Display * dpy, int opcode,
 767                                     CARD32 screen, CARD32 name);
 768 extern char *__glXGetString(Display * dpy, int opcode,
 769                             CARD32 screen, CARD32 name);
 770
 771 extern const char __glXGLClientVersion[];
 772 extern const char __glXGLClientExtensions[];
 773
 774 /* Get the unadjusted system time */
 775 extern int __glXGetUST(int64_t * ust);
 776
 777 extern GLboolean __glXGetMscRateOML(Display * dpy, GLXDrawable drawable,
 778                                     int32_t * numerator,
 779                                     int32_t * denominator);
 780
 781 #if defined(GLX_DIRECT_RENDERING) && !defined(GLX_USE_APPLEGL)
 782 extern GLboolean
 783 __glxGetMscRate(struct glx_screen *psc,
 784                 int32_t * numerator, int32_t * denominator);
 785
 786 /* So that dri2.c:DRI2WireToEvent() can access
 787  * glx_info->codes->first_event */
 788 XExtDisplayInfo *__glXFindDisplay (Display *dpy);
 789
 790 extern void
 791 GarbageCollectDRIDrawables(struct glx_screen *psc);
 792
 793 extern __GLXDRIdrawable *
 794 GetGLXDRIDrawable(Display *dpy, GLXDrawable drawable);
 795 #endif
 796
 797 extern struct glx_screen *GetGLXScreenConfigs(Display * dpy, int scrn);
 798
 799 #ifdef GLX_USE_APPLEGL
 800 extern struct glx_screen *
 801 applegl_create_screen(int screen, struct glx_display * priv);
 802
 803 extern struct glx_context *
 804 applegl_create_context(struct glx_screen *psc,
 805                         struct glx_config *mode,
 806                         struct glx_context *shareList, int renderType);
 807
 808 extern int
 809 applegl_create_display(struct glx_display *display);
 810 #endif
 811
 812 extern Bool validate_renderType_against_config(const struct glx_config *config,
 813                                                int renderType);
 814
 815
 816 extern struct glx_drawable *GetGLXDrawable(Display *dpy, GLXDrawable drawable);
 817 extern int InitGLXDrawable(Display *dpy, struct glx_drawable *glxDraw,
 818                            XID xDrawable, GLXDrawable drawable);
 819 extern void DestroyGLXDrawable(Display *dpy, GLXDrawable drawable);
 820
 821 extern struct glx_context dummyContext;
 822
 823 extern struct glx_screen *
 824 indirect_create_screen(int screen, struct glx_display * priv);
 825 extern struct glx_context *
 826 indirect_create_context(struct glx_screen *psc,
 827                         struct glx_config *mode,
 828                         struct glx_context *shareList, int renderType);
 829 extern struct glx_context *
 830 indirect_create_context_attribs(struct glx_screen *base,
 831                                 struct glx_config *config_base,
 832                                 struct glx_context *shareList,
 833                                 unsigned num_attribs,
 834                                 const uint32_t *attribs,
 835                                 unsigned *error);
 836
 837 #ifdef __cplusplus
 838 }
 839 #endif
 840
 841 #endif /* !__GLX_client_h__ */