Merge branch '7.8'
[mesa.git] / 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 #include "main/remap.h"
35
36 typedef struct __DRIutilversionRec2 __DRIutilversion2;
37
38 struct dri_debug_control {
39 const char * string;
40 unsigned flag;
41 };
42
43 /**
44 * Description of the API for an extension to OpenGL.
45 */
46 struct dri_extension {
47 /**
48 * Name of the extension.
49 */
50 const char * name;
51
52
53 /**
54 * Pointer to a list of \c dri_extension_function structures. The list
55 * is terminated by a structure with a \c NULL
56 * \c dri_extension_function::strings pointer.
57 */
58 const struct gl_function_remap * functions;
59 };
60
61 /**
62 * Used to store a version which includes a major range instead of a single
63 * major version number.
64 */
65 struct __DRIutilversionRec2 {
66 int major_min; /** min allowed Major version number. */
67 int major_max; /** max allowed Major version number. */
68 int minor; /**< Minor version number. */
69 int patch; /**< Patch-level. */
70 };
71
72 extern void
73 __driUtilMessage(const char *f, ...);
74
75 extern unsigned driParseDebugString( const char * debug,
76 const struct dri_debug_control * control );
77
78 extern unsigned driGetRendererString( char * buffer,
79 const char * hardware_name, const char * driver_date, GLuint agp_mode );
80
81 extern void driInitExtensions( GLcontext * ctx,
82 const struct dri_extension * card_extensions, GLboolean enable_imaging );
83
84 extern void driInitSingleExtension( GLcontext * ctx,
85 const struct dri_extension * ext );
86
87 extern GLboolean driCheckDriDdxDrmVersions2(const char * driver_name,
88 const __DRIversion * driActual, const __DRIversion * driExpected,
89 const __DRIversion * ddxActual, const __DRIversion * ddxExpected,
90 const __DRIversion * drmActual, const __DRIversion * drmExpected);
91
92 extern GLboolean driCheckDriDdxDrmVersions3(const char * driver_name,
93 const __DRIversion * driActual, const __DRIversion * driExpected,
94 const __DRIversion * ddxActual, const __DRIutilversion2 * ddxExpected,
95 const __DRIversion * drmActual, const __DRIversion * drmExpected);
96
97 extern GLboolean driClipRectToFramebuffer( const GLframebuffer *buffer,
98 GLint *x, GLint *y,
99 GLsizei *width, GLsizei *height );
100
101 struct __DRIconfigRec {
102 __GLcontextModes modes;
103 };
104
105 extern __DRIconfig **
106 driCreateConfigs(GLenum fb_format, GLenum fb_type,
107 const uint8_t * depth_bits, const uint8_t * stencil_bits,
108 unsigned num_depth_stencil_bits,
109 const GLenum * db_modes, unsigned num_db_modes,
110 const uint8_t * msaa_samples, unsigned num_msaa_modes,
111 GLboolean enable_accum);
112
113 __DRIconfig **driConcatConfigs(__DRIconfig **a,
114 __DRIconfig **b);
115
116 int
117 driGetConfigAttrib(const __DRIconfig *config,
118 unsigned int attrib, unsigned int *value);
119 int
120 driIndexConfigAttrib(const __DRIconfig *config, int index,
121 unsigned int *attrib, unsigned int *value);
122
123 #endif /* DRI_DEBUG_H */