src/mesa/drivers/dri/common/utils.h

   1 /*
   2  * (C) Copyright IBM Corporation 2002, 2004
   3  * 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  * on the rights to use, copy, modify, merge, publish, distribute, sub
   9  * license, and/or sell copies of the Software, and to permit persons to whom
  10  * the Software is furnished to do so, subject to the following conditions:
  11  *
  12  * The above copyright notice and this permission notice (including the next
  13  * paragraph) shall be included in all copies or substantial portions of the
  14  * Software.
  15  *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18  * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.  IN NO EVENT SHALL
  19  * VA LINUX SYSTEM, IBM AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM,
  20  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  21  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
  22  * USE OR OTHER DEALINGS IN THE SOFTWARE.
  23  *
  24  * Authors:
  25  *    Ian Romanick <idr@us.ibm.com>
  26  */
  27
  28 #ifndef DRI_DEBUG_H
  29 #define DRI_DEBUG_H
  30
  31 #include <GL/gl.h>
  32 #include <GL/internal/dri_interface.h>
  33 #include "main/context.h"
  34
  35 typedef struct __DRIutilversionRec2    __DRIutilversion2;
  36
  37 struct dri_debug_control {
  38     const char * string;
  39     unsigned     flag;
  40 };
  41
  42 /**
  43  * Description of the entry-points and parameters for an OpenGL function.
  44  */
  45 struct dri_extension_function {
  46     /**
  47      * \brief
  48      * Packed string describing the parameter signature and the entry-point
  49      * names.
  50      *
  51      * The parameter signature and the names of the entry-points for this
  52      * function are packed into a single string.  The substrings are
  53      * separated by NUL characters.  The whole string is terminated by
  54      * two consecutive NUL characters.
  55      */
  56     const char * strings;
  57
  58
  59     /**
  60      * Location in the remap table where the dispatch offset should be
  61      * stored.
  62      */
  63     int remap_index;
  64
  65     /**
  66      * Offset of the function in the dispatch table.
  67      */
  68     int offset;
  69 };
  70
  71 /**
  72  * Description of the API for an extension to OpenGL.
  73  */
  74 struct dri_extension {
  75     /**
  76      * Name of the extension.
  77      */
  78     const char * name;
  79
  80
  81     /**
  82      * Pointer to a list of \c dri_extension_function structures.  The list
  83      * is terminated by a structure with a \c NULL
  84      * \c dri_extension_function::strings pointer.
  85      */
  86     const struct dri_extension_function * functions;
  87 };
  88
  89 /**
  90  * Used to store a version which includes a major range instead of a single
  91  * major version number.
  92  */
  93 struct __DRIutilversionRec2 {
  94     int    major_min;    /** min allowed Major version number. */
  95     int    major_max;    /** max allowed Major version number. */
  96     int    minor;        /**< Minor version number. */
  97     int    patch;        /**< Patch-level. */
  98 };
  99
 100 extern unsigned driParseDebugString( const char * debug,
 101     const struct dri_debug_control * control );
 102
 103 extern unsigned driGetRendererString( char * buffer,
 104     const char * hardware_name, const char * driver_date, GLuint agp_mode );
 105
 106 extern void driInitExtensions( GLcontext * ctx,
 107     const struct dri_extension * card_extensions, GLboolean enable_imaging );
 108
 109 extern void driInitSingleExtension( GLcontext * ctx,
 110     const struct dri_extension * ext );
 111
 112 extern GLboolean driCheckDriDdxDrmVersions2(const char * driver_name,
 113     const __DRIversion * driActual, const __DRIversion * driExpected,
 114     const __DRIversion * ddxActual, const __DRIversion * ddxExpected,
 115     const __DRIversion * drmActual, const __DRIversion * drmExpected);
 116
 117 extern GLboolean driCheckDriDdxDrmVersions3(const char * driver_name,
 118     const __DRIversion * driActual, const __DRIversion * driExpected,
 119     const __DRIversion * ddxActual, const __DRIutilversion2 * ddxExpected,
 120     const __DRIversion * drmActual, const __DRIversion * drmExpected);
 121
 122 extern GLboolean driClipRectToFramebuffer( const GLframebuffer *buffer,
 123                                            GLint *x, GLint *y,
 124                                            GLsizei *width, GLsizei *height );
 125
 126 struct __DRIconfigRec {
 127     __GLcontextModes modes;
 128 };
 129
 130 extern __DRIconfig **
 131 driCreateConfigs(GLenum fb_format, GLenum fb_type,
 132                  const uint8_t * depth_bits, const uint8_t * stencil_bits,
 133                  unsigned num_depth_stencil_bits,
 134                  const GLenum * db_modes, unsigned num_db_modes,
 135                  const uint8_t * msaa_samples, unsigned num_msaa_modes);
 136
 137 const __DRIconfig **driConcatConfigs(const __DRIconfig **a,
 138                                      const __DRIconfig **b);
 139
 140 int
 141 driGetConfigAttrib(const __DRIconfig *config,
 142                    unsigned int attrib, unsigned int *value);
 143 int
 144 driIndexConfigAttrib(const __DRIconfig *config, int index,
 145                      unsigned int *attrib, unsigned int *value);
 146
 147 #endif /* DRI_DEBUG_H */