1 2 /* pngdebug.h - Debugging macros for libpng, also used in pngtest.c 3 * 4 * Copyright (c) 1998-2011 Glenn Randers-Pehrson 5 * (Version 0.96 Copyright (c) 1996, 1997 Andreas Dilger) 6 * (Version 0.88 Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.) 7 * 8 * Last changed in libpng 1.5.0 [January 6, 2011] 9 * 10 * This code is released under the libpng license. 11 * For conditions of distribution and use, see the disclaimer 12 * and license in png.h 13 */ 14 15 /* Define PNG_DEBUG at compile time for debugging information. Higher 16 * numbers for PNG_DEBUG mean more debugging information. This has 17 * only been added since version 0.95 so it is not implemented throughout 18 * libpng yet, but more support will be added as needed. 19 * 20 * png_debug[1-2]?(level, message ,arg{0-2}) 21 * Expands to a statement (either a simple expression or a compound 22 * do..while(0) statement) that outputs a message with parameter 23 * substitution if PNG_DEBUG is defined to 2 or more. If PNG_DEBUG 24 * is undefined, 0 or 1 every png_debug expands to a simple expression 25 * (actually ((void)0)). 26 * 27 * level: level of detail of message, starting at 0. A level 'n' 28 * message is preceded by 'n' tab characters (not implemented 29 * on Microsoft compilers unless PNG_DEBUG_FILE is also 30 * defined, to allow debug DLL compilation with no standard IO). 31 * message: a printf(3) style text string. A trailing '\n' is added 32 * to the message. 33 * arg: 0 to 2 arguments for printf(3) style substitution in message. 34 */ 35 #ifndef PNGDEBUG_H 36 #define PNGDEBUG_H 37 /* These settings control the formatting of messages in png.c and pngerror.c */ 38 /* Moved to pngdebug.h at 1.5.0 */ 39 # ifndef PNG_LITERAL_SHARP 40 # define PNG_LITERAL_SHARP 0x23 41 # endif 42 # ifndef PNG_LITERAL_LEFT_SQUARE_BRACKET 43 # define PNG_LITERAL_LEFT_SQUARE_BRACKET 0x5b 44 # endif 45 # ifndef PNG_LITERAL_RIGHT_SQUARE_BRACKET 46 # define PNG_LITERAL_RIGHT_SQUARE_BRACKET 0x5d 47 # endif 48 # ifndef PNG_STRING_NEWLINE 49 # define PNG_STRING_NEWLINE "\n" 50 # endif 51 52 #ifdef PNG_DEBUG 53 # if (PNG_DEBUG > 0) 54 # if !defined(PNG_DEBUG_FILE) && defined(_MSC_VER) 55 # include <crtdbg.h> 56 # if (PNG_DEBUG > 1) 57 # ifndef _DEBUG 58 # define _DEBUG 59 # endif 60 # ifndef png_debug 61 # define png_debug(l,m) _RPT0(_CRT_WARN,m PNG_STRING_NEWLINE) 62 # endif 63 # ifndef png_debug1 64 # define png_debug1(l,m,p1) _RPT1(_CRT_WARN,m PNG_STRING_NEWLINE,p1) 65 # endif 66 # ifndef png_debug2 67 # define png_debug2(l,m,p1,p2) \ 68 _RPT2(_CRT_WARN,m PNG_STRING_NEWLINE,p1,p2) 69 # endif 70 # endif 71 # else /* PNG_DEBUG_FILE || !_MSC_VER */ 72 # ifndef PNG_STDIO_SUPPORTED 73 # include <stdio.h> /* not included yet */ 74 # endif 75 # ifndef PNG_DEBUG_FILE 76 # define PNG_DEBUG_FILE stderr 77 # endif /* PNG_DEBUG_FILE */ 78 79 # if (PNG_DEBUG > 1) 80 /* Note: ["%s"m PNG_STRING_NEWLINE] probably does not work on 81 * non-ISO compilers 82 */ 83 # ifdef __STDC__ 84 # ifndef png_debug 85 # define png_debug(l,m) \ 86 do { \ 87 int num_tabs=l; \ 88 fprintf(PNG_DEBUG_FILE,"%s"m PNG_STRING_NEWLINE,(num_tabs==1 ? "\t" : \ 89 (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":"")))); \ 90 } while (0) 91 # endif 92 # ifndef png_debug1 93 # define png_debug1(l,m,p1) \ 94 do { \ 95 int num_tabs=l; \ 96 fprintf(PNG_DEBUG_FILE,"%s"m PNG_STRING_NEWLINE,(num_tabs==1 ? "\t" : \ 97 (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))),p1); \ 98 } while (0) 99 # endif 100 # ifndef png_debug2 101 # define png_debug2(l,m,p1,p2) \ 102 do { \ 103 int num_tabs=l; \ 104 fprintf(PNG_DEBUG_FILE,"%s"m PNG_STRING_NEWLINE,(num_tabs==1 ? "\t" : \ 105 (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))),p1,p2); \ 106 } while (0) 107 # endif 108 # else /* __STDC __ */ 109 # ifndef png_debug 110 # define png_debug(l,m) \ 111 do { \ 112 int num_tabs=l; \ 113 char format[256]; \ 114 snprintf(format,256,"%s%s%s",(num_tabs==1 ? "\t" : \ 115 (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))), \ 116 m,PNG_STRING_NEWLINE); \ 117 fprintf(PNG_DEBUG_FILE,format); \ 118 } while (0) 119 # endif 120 # ifndef png_debug1 121 # define png_debug1(l,m,p1) \ 122 do { \ 123 int num_tabs=l; \ 124 char format[256]; \ 125 snprintf(format,256,"%s%s%s",(num_tabs==1 ? "\t" : \ 126 (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))), \ 127 m,PNG_STRING_NEWLINE); \ 128 fprintf(PNG_DEBUG_FILE,format,p1); \ 129 } while (0) 130 # endif 131 # ifndef png_debug2 132 # define png_debug2(l,m,p1,p2) \ 133 do { \ 134 int num_tabs=l; \ 135 char format[256]; \ 136 snprintf(format,256,"%s%s%s",(num_tabs==1 ? "\t" : \ 137 (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))), \ 138 m,PNG_STRING_NEWLINE); \ 139 fprintf(PNG_DEBUG_FILE,format,p1,p2); \ 140 } while (0) 141 # endif 142 # endif /* __STDC __ */ 143 # endif /* (PNG_DEBUG > 1) */ 144 145 # endif /* _MSC_VER */ 146 # endif /* (PNG_DEBUG > 0) */ 147 #endif /* PNG_DEBUG */ 148 #ifndef png_debug 149 # define png_debug(l, m) ((void)0) 150 #endif 151 #ifndef png_debug1 152 # define png_debug1(l, m, p1) ((void)0) 153 #endif 154 #ifndef png_debug2 155 # define png_debug2(l, m, p1, p2) ((void)0) 156 #endif 157 #endif /* PNGDEBUG_H */ 158