OSDN Git Service

mesa: remove unused DD_LINE_SMOOTH flag
[android-x86/external-mesa.git] / src / mesa / main / debug.c
1 /*
2  * Mesa 3-D graphics library
3  * Version:  6.5
4  *
5  * Copyright (C) 1999-2005  Brian Paul   All Rights Reserved.
6  * Copyright (C) 2009  VMware, Inc.  All Rights Reserved.
7  *
8  * Permission is hereby granted, free of charge, to any person obtaining a
9  * copy of this software and associated documentation files (the "Software"),
10  * to deal in the Software without restriction, including without limitation
11  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
12  * and/or sell copies of the Software, and to permit persons to whom the
13  * Software is furnished to do so, subject to the following conditions:
14  *
15  * The above copyright notice and this permission notice shall be included
16  * in all copies or substantial portions of the Software.
17  *
18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
21  * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
22  * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
23  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
24  */
25
26 #include "mtypes.h"
27 #include "attrib.h"
28 #include "colormac.h"
29 #include "enums.h"
30 #include "formats.h"
31 #include "hash.h"
32 #include "imports.h"
33 #include "debug.h"
34 #include "get.h"
35 #include "pixelstore.h"
36 #include "readpix.h"
37 #include "texobj.h"
38
39
40 static const char *
41 tex_target_name(GLenum tgt)
42 {
43    static const struct {
44       GLenum target;
45       const char *name;
46    } tex_targets[] = {
47       { GL_TEXTURE_1D, "GL_TEXTURE_1D" },
48       { GL_TEXTURE_2D, "GL_TEXTURE_2D" },
49       { GL_TEXTURE_3D, "GL_TEXTURE_3D" },
50       { GL_TEXTURE_CUBE_MAP, "GL_TEXTURE_CUBE_MAP" },
51       { GL_TEXTURE_RECTANGLE, "GL_TEXTURE_RECTANGLE" },
52       { GL_TEXTURE_1D_ARRAY_EXT, "GL_TEXTURE_1D_ARRAY" },
53       { GL_TEXTURE_2D_ARRAY_EXT, "GL_TEXTURE_2D_ARRAY" },
54       { GL_TEXTURE_EXTERNAL_OES, "GL_TEXTURE_EXTERNAL_OES" }
55    };
56    GLuint i;
57    for (i = 0; i < Elements(tex_targets); i++) {
58       if (tex_targets[i].target == tgt)
59          return tex_targets[i].name;
60    }
61    return "UNKNOWN TEX TARGET";
62 }
63
64
65 void
66 _mesa_print_state( const char *msg, GLuint state )
67 {
68    _mesa_debug(NULL,
69            "%s: (0x%x) %s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s\n",
70            msg,
71            state,
72            (state & _NEW_MODELVIEW)       ? "ctx->ModelView, " : "",
73            (state & _NEW_PROJECTION)      ? "ctx->Projection, " : "",
74            (state & _NEW_TEXTURE_MATRIX)  ? "ctx->TextureMatrix, " : "",
75            (state & _NEW_COLOR)           ? "ctx->Color, " : "",
76            (state & _NEW_DEPTH)           ? "ctx->Depth, " : "",
77            (state & _NEW_EVAL)            ? "ctx->Eval/EvalMap, " : "",
78            (state & _NEW_FOG)             ? "ctx->Fog, " : "",
79            (state & _NEW_HINT)            ? "ctx->Hint, " : "",
80            (state & _NEW_LIGHT)           ? "ctx->Light, " : "",
81            (state & _NEW_LINE)            ? "ctx->Line, " : "",
82            (state & _NEW_PIXEL)           ? "ctx->Pixel, " : "",
83            (state & _NEW_POINT)           ? "ctx->Point, " : "",
84            (state & _NEW_POLYGON)         ? "ctx->Polygon, " : "",
85            (state & _NEW_POLYGONSTIPPLE)  ? "ctx->PolygonStipple, " : "",
86            (state & _NEW_SCISSOR)         ? "ctx->Scissor, " : "",
87            (state & _NEW_STENCIL)         ? "ctx->Stencil, " : "",
88            (state & _NEW_TEXTURE)         ? "ctx->Texture, " : "",
89            (state & _NEW_TRANSFORM)       ? "ctx->Transform, " : "",
90            (state & _NEW_VIEWPORT)        ? "ctx->Viewport, " : "",
91            (state & _NEW_PACKUNPACK)      ? "ctx->Pack/Unpack, " : "",
92            (state & _NEW_ARRAY)           ? "ctx->Array, " : "",
93            (state & _NEW_RENDERMODE)      ? "ctx->RenderMode, " : "",
94            (state & _NEW_BUFFERS)         ? "ctx->Visual, ctx->DrawBuffer,, " : "");
95 }
96
97
98
99 void
100 _mesa_print_tri_caps( const char *name, GLuint flags )
101 {
102    _mesa_debug(NULL,
103            "%s: (0x%x) %s%s%s%s%s%s%s%s%s\n",
104            name,
105            flags,
106            (flags & DD_SEPARATE_SPECULAR)   ? "separate-specular, " : "",
107            (flags & DD_TRI_LIGHT_TWOSIDE)   ? "tri-light-twoside, " : "",
108            (flags & DD_TRI_UNFILLED)        ? "tri-unfilled, " : "",
109            (flags & DD_TRI_STIPPLE)         ? "tri-stipple, " : "",
110            (flags & DD_TRI_OFFSET)          ? "tri-offset, " : "",
111            (flags & DD_TRI_SMOOTH)          ? "tri-smooth, " : "",
112            (flags & DD_LINE_STIPPLE)        ? "line-stipple, " : "",
113            (flags & DD_POINT_SMOOTH)        ? "point-smooth, " : "",
114            (flags & DD_POINT_ATTEN)         ? "point-atten, " : ""
115       );
116 }
117
118
119 /**
120  * Print information about this Mesa version and build options.
121  */
122 void _mesa_print_info( void )
123 {
124    _mesa_debug(NULL, "Mesa GL_VERSION = %s\n",
125            (char *) _mesa_GetString(GL_VERSION));
126    _mesa_debug(NULL, "Mesa GL_RENDERER = %s\n",
127            (char *) _mesa_GetString(GL_RENDERER));
128    _mesa_debug(NULL, "Mesa GL_VENDOR = %s\n",
129            (char *) _mesa_GetString(GL_VENDOR));
130    _mesa_debug(NULL, "Mesa GL_EXTENSIONS = %s\n",
131            (char *) _mesa_GetString(GL_EXTENSIONS));
132 #if defined(THREADS)
133    _mesa_debug(NULL, "Mesa thread-safe: YES\n");
134 #else
135    _mesa_debug(NULL, "Mesa thread-safe: NO\n");
136 #endif
137 #if defined(USE_X86_ASM)
138    _mesa_debug(NULL, "Mesa x86-optimized: YES\n");
139 #else
140    _mesa_debug(NULL, "Mesa x86-optimized: NO\n");
141 #endif
142 #if defined(USE_SPARC_ASM)
143    _mesa_debug(NULL, "Mesa sparc-optimized: YES\n");
144 #else
145    _mesa_debug(NULL, "Mesa sparc-optimized: NO\n");
146 #endif
147 }
148
149
150 /**
151  * Set verbose logging flags.  When these flags are set, GL API calls
152  * in the various categories will be printed to stderr.
153  * \param str  a comma-separated list of keywords
154  */
155 static void
156 set_verbose_flags(const char *str)
157 {
158 #ifdef DEBUG
159    struct option {
160       const char *name;
161       GLbitfield flag;
162    };
163    static const struct option opts[] = {
164       { "varray",    VERBOSE_VARRAY },
165       { "tex",       VERBOSE_TEXTURE },
166       { "mat",       VERBOSE_MATERIAL },
167       { "pipe",      VERBOSE_PIPELINE },
168       { "driver",    VERBOSE_DRIVER },
169       { "state",     VERBOSE_STATE },
170       { "api",       VERBOSE_API },
171       { "list",      VERBOSE_DISPLAY_LIST },
172       { "lighting",  VERBOSE_LIGHTING },
173       { "disassem",  VERBOSE_DISASSEM },
174       { "draw",      VERBOSE_DRAW },
175       { "swap",      VERBOSE_SWAPBUFFERS }
176    };
177    GLuint i;
178
179    if (!str)
180       return;
181
182    MESA_VERBOSE = 0x0;
183    for (i = 0; i < Elements(opts); i++) {
184       if (strstr(str, opts[i].name) || strcmp(str, "all") == 0)
185          MESA_VERBOSE |= opts[i].flag;
186    }
187 #endif
188 }
189
190
191 /**
192  * Set debugging flags.  When these flags are set, Mesa will do additional
193  * debug checks or actions.
194  * \param str  a comma-separated list of keywords
195  */
196 static void
197 set_debug_flags(const char *str)
198 {
199 #ifdef DEBUG
200    struct option {
201       const char *name;
202       GLbitfield flag;
203    };
204    static const struct option opts[] = {
205       { "silent", DEBUG_SILENT }, /* turn off debug messages */
206       { "flush", DEBUG_ALWAYS_FLUSH }, /* flush after each drawing command */
207       { "incomplete_tex", DEBUG_INCOMPLETE_TEXTURE },
208       { "incomplete_fbo", DEBUG_INCOMPLETE_FBO }
209    };
210    GLuint i;
211
212    if (!str)
213       return;
214
215    MESA_DEBUG_FLAGS = 0x0;
216    for (i = 0; i < Elements(opts); i++) {
217       if (strstr(str, opts[i].name))
218          MESA_DEBUG_FLAGS |= opts[i].flag;
219    }
220 #endif
221 }
222
223
224 /**
225  * Initialize debugging variables from env vars.
226  */
227 void 
228 _mesa_init_debug( struct gl_context *ctx )
229 {
230    set_debug_flags(_mesa_getenv("MESA_DEBUG"));
231    set_verbose_flags(_mesa_getenv("MESA_VERBOSE"));
232 }
233
234
235 /*
236  * Write ppm file
237  */
238 static void
239 write_ppm(const char *filename, const GLubyte *buffer, int width, int height,
240           int comps, int rcomp, int gcomp, int bcomp, GLboolean invert)
241 {
242    FILE *f = fopen( filename, "w" );
243    if (f) {
244       int x, y;
245       const GLubyte *ptr = buffer;
246       fprintf(f,"P6\n");
247       fprintf(f,"# ppm-file created by osdemo.c\n");
248       fprintf(f,"%i %i\n", width,height);
249       fprintf(f,"255\n");
250       fclose(f);
251       f = fopen( filename, "ab" );  /* reopen in binary append mode */
252       for (y=0; y < height; y++) {
253          for (x = 0; x < width; x++) {
254             int yy = invert ? (height - 1 - y) : y;
255             int i = (yy * width + x) * comps;
256             fputc(ptr[i+rcomp], f); /* write red */
257             fputc(ptr[i+gcomp], f); /* write green */
258             fputc(ptr[i+bcomp], f); /* write blue */
259          }
260       }
261       fclose(f);
262    }
263    else {
264       fprintf(stderr, "Unable to create %s in write_ppm()\n", filename);
265    }
266 }
267
268
269 /**
270  * Write a texture image to a ppm file.
271  * \param face  cube face in [0,5]
272  * \param level  mipmap level
273  */
274 static void
275 write_texture_image(struct gl_texture_object *texObj,
276                     GLuint face, GLuint level)
277 {
278    struct gl_texture_image *img = texObj->Image[face][level];
279    if (img) {
280       GET_CURRENT_CONTEXT(ctx);
281       struct gl_pixelstore_attrib store;
282       GLubyte *buffer;
283       char s[100];
284
285       buffer = malloc(img->Width * img->Height
286                                         * img->Depth * 4);
287
288       store = ctx->Pack; /* save */
289       ctx->Pack = ctx->DefaultPacking;
290
291       ctx->Driver.GetTexImage(ctx, GL_RGBA, GL_UNSIGNED_BYTE, buffer, img);
292
293       /* make filename */
294       _mesa_snprintf(s, sizeof(s), "/tmp/tex%u.l%u.f%u.ppm", texObj->Name, level, face);
295
296       printf("  Writing image level %u to %s\n", level, s);
297       write_ppm(s, buffer, img->Width, img->Height, 4, 0, 1, 2, GL_FALSE);
298
299       ctx->Pack = store; /* restore */
300
301       free(buffer);
302    }
303 }
304
305
306 /**
307  * Write renderbuffer image to a ppm file.
308  */
309 void
310 _mesa_write_renderbuffer_image(const struct gl_renderbuffer *rb)
311 {
312    GET_CURRENT_CONTEXT(ctx);
313    GLubyte *buffer;
314    char s[100];
315    GLenum format, type;
316
317    if (rb->_BaseFormat == GL_RGB || 
318        rb->_BaseFormat == GL_RGBA) {
319       format = GL_RGBA;
320       type = GL_UNSIGNED_BYTE;
321    }
322    else if (rb->_BaseFormat == GL_DEPTH_STENCIL) {
323       format = GL_DEPTH_STENCIL;
324       type = GL_UNSIGNED_INT_24_8;
325    }
326    else {
327       _mesa_debug(NULL,
328                   "Unsupported BaseFormat 0x%x in "
329                   "_mesa_write_renderbuffer_image()\n",
330                   rb->_BaseFormat);
331       return;
332    }
333
334    buffer = malloc(rb->Width * rb->Height * 4);
335
336    ctx->Driver.ReadPixels(ctx, 0, 0, rb->Width, rb->Height,
337                           format, type, &ctx->DefaultPacking, buffer);
338
339    /* make filename */
340    _mesa_snprintf(s, sizeof(s), "/tmp/renderbuffer%u.ppm", rb->Name);
341    _mesa_snprintf(s, sizeof(s), "C:\\renderbuffer%u.ppm", rb->Name);
342
343    printf("  Writing renderbuffer image to %s\n", s);
344
345    _mesa_debug(NULL, "  Writing renderbuffer image to %s\n", s);
346
347    write_ppm(s, buffer, rb->Width, rb->Height, 4, 0, 1, 2, GL_TRUE);
348
349    free(buffer);
350 }
351
352
353 /** How many texture images (mipmap levels, faces) to write to files */
354 #define WRITE_NONE 0
355 #define WRITE_ONE  1
356 #define WRITE_ALL  2
357
358 static GLuint WriteImages;
359
360
361 static void
362 dump_texture(struct gl_texture_object *texObj, GLuint writeImages)
363 {
364    const GLuint numFaces = texObj->Target == GL_TEXTURE_CUBE_MAP ? 6 : 1;
365    GLboolean written = GL_FALSE;
366    GLuint i, j;
367
368    printf("Texture %u\n", texObj->Name);
369    printf("  Target %s\n", tex_target_name(texObj->Target));
370    for (i = 0; i < MAX_TEXTURE_LEVELS; i++) {
371       for (j = 0; j < numFaces; j++) {
372          struct gl_texture_image *texImg = texObj->Image[j][i];
373          if (texImg) {
374             printf("  Face %u level %u: %d x %d x %d, format %s\n",
375                    j, i,
376                    texImg->Width, texImg->Height, texImg->Depth,
377                    _mesa_get_format_name(texImg->TexFormat));
378             if (writeImages == WRITE_ALL ||
379                 (writeImages == WRITE_ONE && !written)) {
380                write_texture_image(texObj, j, i);
381                written = GL_TRUE;
382             }
383          }
384       }
385    }
386 }
387
388
389 /**
390  * Dump a single texture.
391  */
392 void
393 _mesa_dump_texture(GLuint texture, GLuint writeImages)
394 {
395    GET_CURRENT_CONTEXT(ctx);
396    struct gl_texture_object *texObj = _mesa_lookup_texture(ctx, texture);
397    if (texObj) {
398       dump_texture(texObj, writeImages);
399    }
400 }
401
402
403 static void
404 dump_texture_cb(GLuint id, void *data, void *userData)
405 {
406    struct gl_texture_object *texObj = (struct gl_texture_object *) data;
407    (void) userData;
408    dump_texture(texObj, WriteImages);
409 }
410
411
412 /**
413  * Print basic info about all texture objext to stdout.
414  * If dumpImages is true, write PPM of level[0] image to a file.
415  */
416 void
417 _mesa_dump_textures(GLuint writeImages)
418 {
419    GET_CURRENT_CONTEXT(ctx);
420    WriteImages = writeImages;
421    _mesa_HashWalk(ctx->Shared->TexObjects, dump_texture_cb, ctx);
422 }
423
424
425 static void
426 dump_renderbuffer(const struct gl_renderbuffer *rb, GLboolean writeImage)
427 {
428    printf("Renderbuffer %u: %u x %u  IntFormat = %s\n",
429           rb->Name, rb->Width, rb->Height,
430           _mesa_lookup_enum_by_nr(rb->InternalFormat));
431    if (writeImage) {
432       _mesa_write_renderbuffer_image(rb);
433    }
434 }
435
436
437 static void
438 dump_renderbuffer_cb(GLuint id, void *data, void *userData)
439 {
440    const struct gl_renderbuffer *rb = (const struct gl_renderbuffer *) data;
441    (void) userData;
442    dump_renderbuffer(rb, WriteImages);
443 }
444
445
446 /**
447  * Print basic info about all renderbuffers to stdout.
448  * If dumpImages is true, write PPM of level[0] image to a file.
449  */
450 void
451 _mesa_dump_renderbuffers(GLboolean writeImages)
452 {
453    GET_CURRENT_CONTEXT(ctx);
454    WriteImages = writeImages;
455    _mesa_HashWalk(ctx->Shared->RenderBuffers, dump_renderbuffer_cb, ctx);
456 }
457
458
459
460 void
461 _mesa_dump_color_buffer(const char *filename)
462 {
463    GET_CURRENT_CONTEXT(ctx);
464    const GLuint w = ctx->DrawBuffer->Width;
465    const GLuint h = ctx->DrawBuffer->Height;
466    GLubyte *buf;
467
468    buf = malloc(w * h * 4);
469
470    _mesa_PushClientAttrib(GL_CLIENT_PIXEL_STORE_BIT);
471    _mesa_PixelStorei(GL_PACK_ALIGNMENT, 1);
472    _mesa_PixelStorei(GL_PACK_INVERT_MESA, GL_TRUE);
473
474    _mesa_ReadPixels(0, 0, w, h, GL_RGBA, GL_UNSIGNED_BYTE, buf);
475
476    printf("ReadBuffer %p 0x%x  DrawBuffer %p 0x%x\n",
477           (void *) ctx->ReadBuffer->_ColorReadBuffer,
478           ctx->ReadBuffer->ColorReadBuffer,
479           (void *) ctx->DrawBuffer->_ColorDrawBuffers[0],
480           ctx->DrawBuffer->ColorDrawBuffer[0]);
481    printf("Writing %d x %d color buffer to %s\n", w, h, filename);
482    write_ppm(filename, buf, w, h, 4, 0, 1, 2, GL_TRUE);
483
484    _mesa_PopClientAttrib();
485
486    free(buf);
487 }
488
489
490 void
491 _mesa_dump_depth_buffer(const char *filename)
492 {
493    GET_CURRENT_CONTEXT(ctx);
494    const GLuint w = ctx->DrawBuffer->Width;
495    const GLuint h = ctx->DrawBuffer->Height;
496    GLuint *buf;
497    GLubyte *buf2;
498    GLuint i;
499
500    buf = malloc(w * h * 4);  /* 4 bpp */
501    buf2 = malloc(w * h * 3); /* 3 bpp */
502
503    _mesa_PushClientAttrib(GL_CLIENT_PIXEL_STORE_BIT);
504    _mesa_PixelStorei(GL_PACK_ALIGNMENT, 1);
505    _mesa_PixelStorei(GL_PACK_INVERT_MESA, GL_TRUE);
506
507    _mesa_ReadPixels(0, 0, w, h, GL_DEPTH_COMPONENT, GL_UNSIGNED_INT, buf);
508
509    /* spread 24 bits of Z across R, G, B */
510    for (i = 0; i < w * h; i++) {
511       buf2[i*3+0] = (buf[i] >> 24) & 0xff;
512       buf2[i*3+1] = (buf[i] >> 16) & 0xff;
513       buf2[i*3+2] = (buf[i] >>  8) & 0xff;
514    }
515
516    printf("Writing %d x %d depth buffer to %s\n", w, h, filename);
517    write_ppm(filename, buf2, w, h, 3, 0, 1, 2, GL_TRUE);
518
519    _mesa_PopClientAttrib();
520
521    free(buf);
522    free(buf2);
523 }
524
525
526 void
527 _mesa_dump_stencil_buffer(const char *filename)
528 {
529    GET_CURRENT_CONTEXT(ctx);
530    const GLuint w = ctx->DrawBuffer->Width;
531    const GLuint h = ctx->DrawBuffer->Height;
532    GLubyte *buf;
533    GLubyte *buf2;
534    GLuint i;
535
536    buf = malloc(w * h);  /* 1 bpp */
537    buf2 = malloc(w * h * 3); /* 3 bpp */
538
539    _mesa_PushClientAttrib(GL_CLIENT_PIXEL_STORE_BIT);
540    _mesa_PixelStorei(GL_PACK_ALIGNMENT, 1);
541    _mesa_PixelStorei(GL_PACK_INVERT_MESA, GL_TRUE);
542
543    _mesa_ReadPixels(0, 0, w, h, GL_STENCIL_INDEX, GL_UNSIGNED_BYTE, buf);
544
545    for (i = 0; i < w * h; i++) {
546       buf2[i*3+0] = buf[i];
547       buf2[i*3+1] = (buf[i] & 127) * 2;
548       buf2[i*3+2] = (buf[i] - 128) * 2;
549    }
550
551    printf("Writing %d x %d stencil buffer to %s\n", w, h, filename);
552    write_ppm(filename, buf2, w, h, 3, 0, 1, 2, GL_TRUE);
553
554    _mesa_PopClientAttrib();
555
556    free(buf);
557    free(buf2);
558 }
559
560
561 void
562 _mesa_dump_image(const char *filename, const void *image, GLuint w, GLuint h,
563                  GLenum format, GLenum type)
564 {
565    GLboolean invert = GL_TRUE;
566
567    if (format == GL_RGBA && type == GL_UNSIGNED_BYTE) {
568       write_ppm(filename, image, w, h, 4, 0, 1, 2, invert);
569    }
570    else if (format == GL_BGRA && type == GL_UNSIGNED_BYTE) {
571       write_ppm(filename, image, w, h, 4, 2, 1, 0, invert);
572    }
573    else if (format == GL_LUMINANCE_ALPHA && type == GL_UNSIGNED_BYTE) {
574       write_ppm(filename, image, w, h, 2, 1, 0, 0, invert);
575    }
576    else if (format == GL_RED && type == GL_UNSIGNED_BYTE) {
577       write_ppm(filename, image, w, h, 1, 0, 0, 0, invert);
578    }
579    else if (format == GL_RGBA && type == GL_FLOAT) {
580       /* convert floats to ubyte */
581       GLubyte *buf = malloc(w * h * 4 * sizeof(GLubyte));
582       const GLfloat *f = (const GLfloat *) image;
583       GLuint i;
584       for (i = 0; i < w * h * 4; i++) {
585          UNCLAMPED_FLOAT_TO_UBYTE(buf[i], f[i]);
586       }
587       write_ppm(filename, buf, w, h, 4, 0, 1, 2, invert);
588       free(buf);
589    }
590    else if (format == GL_RED && type == GL_FLOAT) {
591       /* convert floats to ubyte */
592       GLubyte *buf = malloc(w * h * sizeof(GLubyte));
593       const GLfloat *f = (const GLfloat *) image;
594       GLuint i;
595       for (i = 0; i < w * h; i++) {
596          UNCLAMPED_FLOAT_TO_UBYTE(buf[i], f[i]);
597       }
598       write_ppm(filename, buf, w, h, 1, 0, 0, 0, invert);
599       free(buf);
600    }
601    else {
602       _mesa_problem(NULL,
603                  "Unsupported format 0x%x / type 0x%x in _mesa_dump_image()",
604                  format, type);
605    }
606 }
607
608
609 /**
610  * Quick and dirty function to "print" a texture to stdout.
611  */
612 void
613 _mesa_print_texture(struct gl_context *ctx, struct gl_texture_image *img)
614 {
615    const GLint slice = 0;
616    GLint srcRowStride;
617    GLuint i, j, c;
618    GLubyte *data;
619
620    ctx->Driver.MapTextureImage(ctx, img, slice,
621                                0, 0, img->Width, img->Height, GL_MAP_READ_BIT,
622                                &data, &srcRowStride);
623
624    if (!data) {
625       printf("No texture data\n");
626    }
627    else {
628       /* XXX add more formats or make into a new format utility function */
629       switch (img->TexFormat) {
630          case MESA_FORMAT_A8:
631          case MESA_FORMAT_L8:
632          case MESA_FORMAT_I8:
633             c = 1;
634             break;
635          case MESA_FORMAT_AL88:
636          case MESA_FORMAT_AL88_REV:
637             c = 2;
638             break;
639          case MESA_FORMAT_RGB888:
640          case MESA_FORMAT_BGR888:
641             c = 3;
642             break;
643          case MESA_FORMAT_RGBA8888:
644          case MESA_FORMAT_ARGB8888:
645             c = 4;
646             break;
647          default:
648             _mesa_problem(NULL, "error in PrintTexture\n");
649             return;
650       }
651
652       for (i = 0; i < img->Height; i++) {
653          for (j = 0; j < img->Width; j++) {
654             if (c==1)
655                printf("%02x  ", data[0]);
656             else if (c==2)
657                printf("%02x%02x  ", data[0], data[1]);
658             else if (c==3)
659                printf("%02x%02x%02x  ", data[0], data[1], data[2]);
660             else if (c==4)
661                printf("%02x%02x%02x%02x  ", data[0], data[1], data[2], data[3]);
662             data += (srcRowStride - img->Width) * c;
663          }
664          /* XXX use img->ImageStride here */
665          printf("\n");
666
667       }
668    }
669
670    ctx->Driver.UnmapTextureImage(ctx, img, slice);
671 }