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