i965/blorp: Split vertex data and element setup
[mesa.git] / src / mesa / drivers / dri / common / utils.c
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
25 /**
26 * \file utils.c
27 * Utility functions for DRI drivers.
28 *
29 * \author Ian Romanick <idr@us.ibm.com>
30 */
31
32 #include <string.h>
33 #include <stdio.h>
34 #include <stdlib.h>
35 #include <stdbool.h>
36 #include <stdint.h>
37 #include "main/macros.h"
38 #include "main/mtypes.h"
39 #include "main/cpuinfo.h"
40 #include "main/extensions.h"
41 #include "utils.h"
42 #include "dri_util.h"
43
44 /**
45 * Create the \c GL_RENDERER string for DRI drivers.
46 *
47 * Almost all DRI drivers use a \c GL_RENDERER string of the form:
48 *
49 * "Mesa DRI <chip> <driver date> <AGP speed) <CPU information>"
50 *
51 * Using the supplied chip name, driver data, and AGP speed, this function
52 * creates the string.
53 *
54 * \param buffer Buffer to hold the \c GL_RENDERER string.
55 * \param hardware_name Name of the hardware.
56 * \param agp_mode AGP mode (speed).
57 *
58 * \returns
59 * The length of the string stored in \c buffer. This does \b not include
60 * the terminating \c NUL character.
61 */
62 unsigned
63 driGetRendererString( char * buffer, const char * hardware_name,
64 GLuint agp_mode )
65 {
66 unsigned offset;
67 char *cpu;
68
69 offset = sprintf( buffer, "Mesa DRI %s", hardware_name );
70
71 /* Append any AGP-specific information.
72 */
73 switch ( agp_mode ) {
74 case 1:
75 case 2:
76 case 4:
77 case 8:
78 offset += sprintf( & buffer[ offset ], " AGP %ux", agp_mode );
79 break;
80
81 default:
82 break;
83 }
84
85 /* Append any CPU-specific information.
86 */
87 cpu = _mesa_get_cpu_string();
88 if (cpu) {
89 offset += sprintf(buffer + offset, " %s", cpu);
90 free(cpu);
91 }
92
93 return offset;
94 }
95
96
97 /**
98 * Creates a set of \c struct gl_config that a driver will expose.
99 *
100 * A set of \c struct gl_config will be created based on the supplied
101 * parameters. The number of modes processed will be 2 *
102 * \c num_depth_stencil_bits * \c num_db_modes.
103 *
104 * For the most part, data is just copied from \c depth_bits, \c stencil_bits,
105 * \c db_modes, and \c visType into each \c struct gl_config element.
106 * However, the meanings of \c fb_format and \c fb_type require further
107 * explanation. The \c fb_format specifies which color components are in
108 * each pixel and what the default order is. For example, \c GL_RGB specifies
109 * that red, green, blue are available and red is in the "most significant"
110 * position and blue is in the "least significant". The \c fb_type specifies
111 * the bit sizes of each component and the actual ordering. For example, if
112 * \c GL_UNSIGNED_SHORT_5_6_5_REV is specified with \c GL_RGB, bits [15:11]
113 * are the blue value, bits [10:5] are the green value, and bits [4:0] are
114 * the red value.
115 *
116 * One sublte issue is the combination of \c GL_RGB or \c GL_BGR and either
117 * of the \c GL_UNSIGNED_INT_8_8_8_8 modes. The resulting mask values in the
118 * \c struct gl_config structure is \b identical to the \c GL_RGBA or
119 * \c GL_BGRA case, except the \c alphaMask is zero. This means that, as
120 * far as this routine is concerned, \c GL_RGB with \c GL_UNSIGNED_INT_8_8_8_8
121 * still uses 32-bits.
122 *
123 * If in doubt, look at the tables used in the function.
124 *
125 * \param ptr_to_modes Pointer to a pointer to a linked list of
126 * \c struct gl_config. Upon completion, a pointer to
127 * the next element to be process will be stored here.
128 * If the function fails and returns \c GL_FALSE, this
129 * value will be unmodified, but some elements in the
130 * linked list may be modified.
131 * \param format Mesa mesa_format enum describing the pixel format
132 * \param depth_bits Array of depth buffer sizes to be exposed.
133 * \param stencil_bits Array of stencil buffer sizes to be exposed.
134 * \param num_depth_stencil_bits Number of entries in both \c depth_bits and
135 * \c stencil_bits.
136 * \param db_modes Array of buffer swap modes. If an element has a
137 * value of \c GLX_NONE, then it represents a
138 * single-buffered mode. Other valid values are
139 * \c GLX_SWAP_EXCHANGE_OML, \c GLX_SWAP_COPY_OML, and
140 * \c GLX_SWAP_UNDEFINED_OML. See the
141 * GLX_OML_swap_method extension spec for more details.
142 * \param num_db_modes Number of entries in \c db_modes.
143 * \param msaa_samples Array of msaa sample count. 0 represents a visual
144 * without a multisample buffer.
145 * \param num_msaa_modes Number of entries in \c msaa_samples.
146 * \param visType GLX visual type. Usually either \c GLX_TRUE_COLOR or
147 * \c GLX_DIRECT_COLOR.
148 *
149 * \returns
150 * Pointer to any array of pointers to the \c __DRIconfig structures created
151 * for the specified formats. If there is an error, \c NULL is returned.
152 * Currently the only cause of failure is a bad parameter (i.e., unsupported
153 * \c format).
154 */
155 __DRIconfig **
156 driCreateConfigs(mesa_format format,
157 const uint8_t * depth_bits, const uint8_t * stencil_bits,
158 unsigned num_depth_stencil_bits,
159 const GLenum * db_modes, unsigned num_db_modes,
160 const uint8_t * msaa_samples, unsigned num_msaa_modes,
161 GLboolean enable_accum)
162 {
163 static const uint32_t masks_table[][4] = {
164 /* MESA_FORMAT_B5G6R5_UNORM */
165 { 0x0000F800, 0x000007E0, 0x0000001F, 0x00000000 },
166 /* MESA_FORMAT_B8G8R8X8_UNORM */
167 { 0x00FF0000, 0x0000FF00, 0x000000FF, 0x00000000 },
168 /* MESA_FORMAT_B8G8R8A8_UNORM */
169 { 0x00FF0000, 0x0000FF00, 0x000000FF, 0xFF000000 },
170 /* MESA_FORMAT_B10G10R10X2_UNORM */
171 { 0x3FF00000, 0x000FFC00, 0x000003FF, 0x00000000 },
172 /* MESA_FORMAT_B10G10R10A2_UNORM */
173 { 0x3FF00000, 0x000FFC00, 0x000003FF, 0xC0000000 },
174 /* MESA_FORMAT_R8G8B8A8_UNORM */
175 { 0x000000FF, 0x0000FF00, 0x00FF0000, 0xFF000000 },
176 /* MESA_FORMAT_R8G8B8X8_UNORM */
177 { 0x000000FF, 0x0000FF00, 0x00FF0000, 0x00000000 },
178 };
179
180 const uint32_t * masks;
181 __DRIconfig **configs, **c;
182 struct gl_config *modes;
183 unsigned i, j, k, h;
184 unsigned num_modes;
185 unsigned num_accum_bits = (enable_accum) ? 2 : 1;
186 int red_bits;
187 int green_bits;
188 int blue_bits;
189 int alpha_bits;
190 bool is_srgb;
191
192 switch (format) {
193 case MESA_FORMAT_B5G6R5_UNORM:
194 masks = masks_table[0];
195 break;
196 case MESA_FORMAT_B8G8R8X8_UNORM:
197 case MESA_FORMAT_B8G8R8X8_SRGB:
198 masks = masks_table[1];
199 break;
200 case MESA_FORMAT_B8G8R8A8_UNORM:
201 case MESA_FORMAT_B8G8R8A8_SRGB:
202 masks = masks_table[2];
203 break;
204 case MESA_FORMAT_R8G8B8A8_UNORM:
205 masks = masks_table[5];
206 break;
207 case MESA_FORMAT_R8G8B8X8_UNORM:
208 masks = masks_table[6];
209 break;
210 case MESA_FORMAT_B10G10R10X2_UNORM:
211 masks = masks_table[3];
212 break;
213 case MESA_FORMAT_B10G10R10A2_UNORM:
214 masks = masks_table[4];
215 break;
216 default:
217 fprintf(stderr, "[%s:%u] Unknown framebuffer type %s (%d).\n",
218 __func__, __LINE__,
219 _mesa_get_format_name(format), format);
220 return NULL;
221 }
222
223 red_bits = _mesa_get_format_bits(format, GL_RED_BITS);
224 green_bits = _mesa_get_format_bits(format, GL_GREEN_BITS);
225 blue_bits = _mesa_get_format_bits(format, GL_BLUE_BITS);
226 alpha_bits = _mesa_get_format_bits(format, GL_ALPHA_BITS);
227 is_srgb = _mesa_get_format_color_encoding(format) == GL_SRGB;
228
229 num_modes = num_depth_stencil_bits * num_db_modes * num_accum_bits * num_msaa_modes;
230 configs = calloc(num_modes + 1, sizeof *configs);
231 if (configs == NULL)
232 return NULL;
233
234 c = configs;
235 for ( k = 0 ; k < num_depth_stencil_bits ; k++ ) {
236 for ( i = 0 ; i < num_db_modes ; i++ ) {
237 for ( h = 0 ; h < num_msaa_modes; h++ ) {
238 for ( j = 0 ; j < num_accum_bits ; j++ ) {
239 *c = malloc (sizeof **c);
240 modes = &(*c)->modes;
241 c++;
242
243 memset(modes, 0, sizeof *modes);
244 modes->redBits = red_bits;
245 modes->greenBits = green_bits;
246 modes->blueBits = blue_bits;
247 modes->alphaBits = alpha_bits;
248 modes->redMask = masks[0];
249 modes->greenMask = masks[1];
250 modes->blueMask = masks[2];
251 modes->alphaMask = masks[3];
252 modes->rgbBits = modes->redBits + modes->greenBits
253 + modes->blueBits + modes->alphaBits;
254
255 modes->accumRedBits = 16 * j;
256 modes->accumGreenBits = 16 * j;
257 modes->accumBlueBits = 16 * j;
258 modes->accumAlphaBits = (masks[3] != 0) ? 16 * j : 0;
259 modes->visualRating = (j == 0) ? GLX_NONE : GLX_SLOW_CONFIG;
260
261 modes->stencilBits = stencil_bits[k];
262 modes->depthBits = depth_bits[k];
263
264 modes->transparentPixel = GLX_NONE;
265 modes->transparentRed = GLX_DONT_CARE;
266 modes->transparentGreen = GLX_DONT_CARE;
267 modes->transparentBlue = GLX_DONT_CARE;
268 modes->transparentAlpha = GLX_DONT_CARE;
269 modes->transparentIndex = GLX_DONT_CARE;
270 modes->rgbMode = GL_TRUE;
271
272 if ( db_modes[i] == GLX_NONE ) {
273 modes->doubleBufferMode = GL_FALSE;
274 }
275 else {
276 modes->doubleBufferMode = GL_TRUE;
277 modes->swapMethod = db_modes[i];
278 }
279
280 modes->samples = msaa_samples[h];
281 modes->sampleBuffers = modes->samples ? 1 : 0;
282
283
284 modes->haveAccumBuffer = ((modes->accumRedBits +
285 modes->accumGreenBits +
286 modes->accumBlueBits +
287 modes->accumAlphaBits) > 0);
288 modes->haveDepthBuffer = (modes->depthBits > 0);
289 modes->haveStencilBuffer = (modes->stencilBits > 0);
290
291 modes->bindToTextureRgb = GL_TRUE;
292 modes->bindToTextureRgba = GL_TRUE;
293 modes->bindToMipmapTexture = GL_FALSE;
294 modes->bindToTextureTargets =
295 __DRI_ATTRIB_TEXTURE_1D_BIT |
296 __DRI_ATTRIB_TEXTURE_2D_BIT |
297 __DRI_ATTRIB_TEXTURE_RECTANGLE_BIT;
298
299 modes->yInverted = GL_TRUE;
300 modes->sRGBCapable = is_srgb;
301 }
302 }
303 }
304 }
305 *c = NULL;
306
307 return configs;
308 }
309
310 __DRIconfig **driConcatConfigs(__DRIconfig **a,
311 __DRIconfig **b)
312 {
313 __DRIconfig **all;
314 int i, j, index;
315
316 if (a == NULL || a[0] == NULL)
317 return b;
318 else if (b == NULL || b[0] == NULL)
319 return a;
320
321 i = 0;
322 while (a[i] != NULL)
323 i++;
324 j = 0;
325 while (b[j] != NULL)
326 j++;
327
328 all = malloc((i + j + 1) * sizeof *all);
329 index = 0;
330 for (i = 0; a[i] != NULL; i++)
331 all[index++] = a[i];
332 for (j = 0; b[j] != NULL; j++)
333 all[index++] = b[j];
334 all[index++] = NULL;
335
336 free(a);
337 free(b);
338
339 return all;
340 }
341
342 #define __ATTRIB(attrib, field) \
343 { attrib, offsetof(struct gl_config, field) }
344
345 static const struct { unsigned int attrib, offset; } attribMap[] = {
346 __ATTRIB(__DRI_ATTRIB_BUFFER_SIZE, rgbBits),
347 __ATTRIB(__DRI_ATTRIB_LEVEL, level),
348 __ATTRIB(__DRI_ATTRIB_RED_SIZE, redBits),
349 __ATTRIB(__DRI_ATTRIB_GREEN_SIZE, greenBits),
350 __ATTRIB(__DRI_ATTRIB_BLUE_SIZE, blueBits),
351 __ATTRIB(__DRI_ATTRIB_ALPHA_SIZE, alphaBits),
352 __ATTRIB(__DRI_ATTRIB_DEPTH_SIZE, depthBits),
353 __ATTRIB(__DRI_ATTRIB_STENCIL_SIZE, stencilBits),
354 __ATTRIB(__DRI_ATTRIB_ACCUM_RED_SIZE, accumRedBits),
355 __ATTRIB(__DRI_ATTRIB_ACCUM_GREEN_SIZE, accumGreenBits),
356 __ATTRIB(__DRI_ATTRIB_ACCUM_BLUE_SIZE, accumBlueBits),
357 __ATTRIB(__DRI_ATTRIB_ACCUM_ALPHA_SIZE, accumAlphaBits),
358 __ATTRIB(__DRI_ATTRIB_SAMPLE_BUFFERS, sampleBuffers),
359 __ATTRIB(__DRI_ATTRIB_SAMPLES, samples),
360 __ATTRIB(__DRI_ATTRIB_DOUBLE_BUFFER, doubleBufferMode),
361 __ATTRIB(__DRI_ATTRIB_STEREO, stereoMode),
362 __ATTRIB(__DRI_ATTRIB_AUX_BUFFERS, numAuxBuffers),
363 __ATTRIB(__DRI_ATTRIB_TRANSPARENT_TYPE, transparentPixel),
364 __ATTRIB(__DRI_ATTRIB_TRANSPARENT_INDEX_VALUE, transparentPixel),
365 __ATTRIB(__DRI_ATTRIB_TRANSPARENT_RED_VALUE, transparentRed),
366 __ATTRIB(__DRI_ATTRIB_TRANSPARENT_GREEN_VALUE, transparentGreen),
367 __ATTRIB(__DRI_ATTRIB_TRANSPARENT_BLUE_VALUE, transparentBlue),
368 __ATTRIB(__DRI_ATTRIB_TRANSPARENT_ALPHA_VALUE, transparentAlpha),
369 __ATTRIB(__DRI_ATTRIB_RED_MASK, redMask),
370 __ATTRIB(__DRI_ATTRIB_GREEN_MASK, greenMask),
371 __ATTRIB(__DRI_ATTRIB_BLUE_MASK, blueMask),
372 __ATTRIB(__DRI_ATTRIB_ALPHA_MASK, alphaMask),
373 __ATTRIB(__DRI_ATTRIB_MAX_PBUFFER_WIDTH, maxPbufferWidth),
374 __ATTRIB(__DRI_ATTRIB_MAX_PBUFFER_HEIGHT, maxPbufferHeight),
375 __ATTRIB(__DRI_ATTRIB_MAX_PBUFFER_PIXELS, maxPbufferPixels),
376 __ATTRIB(__DRI_ATTRIB_OPTIMAL_PBUFFER_WIDTH, optimalPbufferWidth),
377 __ATTRIB(__DRI_ATTRIB_OPTIMAL_PBUFFER_HEIGHT, optimalPbufferHeight),
378 __ATTRIB(__DRI_ATTRIB_SWAP_METHOD, swapMethod),
379 __ATTRIB(__DRI_ATTRIB_BIND_TO_TEXTURE_RGB, bindToTextureRgb),
380 __ATTRIB(__DRI_ATTRIB_BIND_TO_TEXTURE_RGBA, bindToTextureRgba),
381 __ATTRIB(__DRI_ATTRIB_BIND_TO_MIPMAP_TEXTURE, bindToMipmapTexture),
382 __ATTRIB(__DRI_ATTRIB_BIND_TO_TEXTURE_TARGETS, bindToTextureTargets),
383 __ATTRIB(__DRI_ATTRIB_YINVERTED, yInverted),
384 __ATTRIB(__DRI_ATTRIB_FRAMEBUFFER_SRGB_CAPABLE, sRGBCapable),
385
386 /* The struct field doesn't matter here, these are handled by the
387 * switch in driGetConfigAttribIndex. We need them in the array
388 * so the iterator includes them though.*/
389 __ATTRIB(__DRI_ATTRIB_RENDER_TYPE, level),
390 __ATTRIB(__DRI_ATTRIB_CONFIG_CAVEAT, level),
391 __ATTRIB(__DRI_ATTRIB_SWAP_METHOD, level)
392 };
393
394
395 /**
396 * Return the value of a configuration attribute. The attribute is
397 * indicated by the index.
398 */
399 static int
400 driGetConfigAttribIndex(const __DRIconfig *config,
401 unsigned int index, unsigned int *value)
402 {
403 switch (attribMap[index].attrib) {
404 case __DRI_ATTRIB_RENDER_TYPE:
405 /* no support for color index mode */
406 *value = __DRI_ATTRIB_RGBA_BIT;
407 break;
408 case __DRI_ATTRIB_CONFIG_CAVEAT:
409 if (config->modes.visualRating == GLX_NON_CONFORMANT_CONFIG)
410 *value = __DRI_ATTRIB_NON_CONFORMANT_CONFIG;
411 else if (config->modes.visualRating == GLX_SLOW_CONFIG)
412 *value = __DRI_ATTRIB_SLOW_BIT;
413 else
414 *value = 0;
415 break;
416 case __DRI_ATTRIB_SWAP_METHOD:
417 /* XXX no return value??? */
418 break;
419
420 default:
421 /* any other int-sized field */
422 *value = *(unsigned int *)
423 ((char *) &config->modes + attribMap[index].offset);
424
425 break;
426 }
427
428 return GL_TRUE;
429 }
430
431
432 /**
433 * Get the value of a configuration attribute.
434 * \param attrib the attribute (one of the _DRI_ATTRIB_x tokens)
435 * \param value returns the attribute's value
436 * \return 1 for success, 0 for failure
437 */
438 int
439 driGetConfigAttrib(const __DRIconfig *config,
440 unsigned int attrib, unsigned int *value)
441 {
442 unsigned i;
443
444 for (i = 0; i < ARRAY_SIZE(attribMap); i++)
445 if (attribMap[i].attrib == attrib)
446 return driGetConfigAttribIndex(config, i, value);
447
448 return GL_FALSE;
449 }
450
451
452 /**
453 * Get a configuration attribute name and value, given an index.
454 * \param index which field of the __DRIconfig to query
455 * \param attrib returns the attribute name (one of the _DRI_ATTRIB_x tokens)
456 * \param value returns the attribute's value
457 * \return 1 for success, 0 for failure
458 */
459 int
460 driIndexConfigAttrib(const __DRIconfig *config, int index,
461 unsigned int *attrib, unsigned int *value)
462 {
463 if (index >= 0 && index < ARRAY_SIZE(attribMap)) {
464 *attrib = attribMap[index].attrib;
465 return driGetConfigAttribIndex(config, index, value);
466 }
467
468 return GL_FALSE;
469 }
470
471 /**
472 * Implement queries for values that are common across all Mesa drivers
473 *
474 * Currently only the following queries are supported by this function:
475 *
476 * - \c __DRI2_RENDERER_VERSION
477 * - \c __DRI2_RENDERER_PREFERRED_PROFILE
478 * - \c __DRI2_RENDERER_OPENGL_CORE_PROFILE_VERSION
479 * - \c __DRI2_RENDERER_OPENGL_COMPATIBLITY_PROFILE_VERSION
480 * - \c __DRI2_RENDERER_ES_PROFILE_VERSION
481 * - \c __DRI2_RENDERER_ES2_PROFILE_VERSION
482 *
483 * \returns
484 * Zero if a recognized value of \c param is supplied, -1 otherwise.
485 */
486 int
487 driQueryRendererIntegerCommon(__DRIscreen *psp, int param, unsigned int *value)
488 {
489 switch (param) {
490 case __DRI2_RENDERER_VERSION: {
491 static const char *const ver = PACKAGE_VERSION;
492 char *endptr;
493 int v[3];
494
495 v[0] = strtol(ver, &endptr, 10);
496 assert(endptr[0] == '.');
497 if (endptr[0] != '.')
498 return -1;
499
500 v[1] = strtol(endptr + 1, &endptr, 10);
501 assert(endptr[0] == '.');
502 if (endptr[0] != '.')
503 return -1;
504
505 v[2] = strtol(endptr + 1, &endptr, 10);
506
507 value[0] = v[0];
508 value[1] = v[1];
509 value[2] = v[2];
510 return 0;
511 }
512 case __DRI2_RENDERER_PREFERRED_PROFILE:
513 value[0] = (psp->max_gl_core_version != 0)
514 ? (1U << __DRI_API_OPENGL_CORE) : (1U << __DRI_API_OPENGL);
515 return 0;
516 case __DRI2_RENDERER_OPENGL_CORE_PROFILE_VERSION:
517 value[0] = psp->max_gl_core_version / 10;
518 value[1] = psp->max_gl_core_version % 10;
519 return 0;
520 case __DRI2_RENDERER_OPENGL_COMPATIBILITY_PROFILE_VERSION:
521 value[0] = psp->max_gl_compat_version / 10;
522 value[1] = psp->max_gl_compat_version % 10;
523 return 0;
524 case __DRI2_RENDERER_OPENGL_ES_PROFILE_VERSION:
525 value[0] = psp->max_gl_es1_version / 10;
526 value[1] = psp->max_gl_es1_version % 10;
527 return 0;
528 case __DRI2_RENDERER_OPENGL_ES2_PROFILE_VERSION:
529 value[0] = psp->max_gl_es2_version / 10;
530 value[1] = psp->max_gl_es2_version % 10;
531 return 0;
532 default:
533 break;
534 }
535
536 return -1;
537 }