| 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 | |
