1 2/* pngdebug.h - Debugging macros for libpng, also used in pngtest.c 3 * 4 * Copyright (c) 1998-2013 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.6.8 [December 19, 2013] 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' 3-space indentations (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# ifdef __STDC__ 81# ifndef png_debug 82# define png_debug(l,m) \ 83 do { \ 84 int num_tabs=l; \ 85 fprintf(PNG_DEBUG_FILE,"%s" m PNG_STRING_NEWLINE,(num_tabs==1 ? " " : \ 86 (num_tabs==2 ? " " : (num_tabs>2 ? " " : "")))); \ 87 } while (0) 88# endif 89# ifndef png_debug1 90# define png_debug1(l,m,p1) \ 91 do { \ 92 int num_tabs=l; \ 93 fprintf(PNG_DEBUG_FILE,"%s" m PNG_STRING_NEWLINE,(num_tabs==1 ? " " : \ 94 (num_tabs==2 ? " " : (num_tabs>2 ? " " : ""))),p1); \ 95 } while (0) 96# endif 97# ifndef png_debug2 98# define png_debug2(l,m,p1,p2) \ 99 do { \ 100 int num_tabs=l; \ 101 fprintf(PNG_DEBUG_FILE,"%s" m PNG_STRING_NEWLINE,(num_tabs==1 ? " " : \ 102 (num_tabs==2 ? " " : (num_tabs>2 ? " " : ""))),p1,p2);\ 103 } while (0) 104# endif 105# else /* __STDC __ */ 106# ifndef png_debug 107# define png_debug(l,m) \ 108 do { \ 109 int num_tabs=l; \ 110 char format[256]; \ 111 snprintf(format,256,"%s%s%s",(num_tabs==1 ? "\t" : \ 112 (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))), \ 113 m,PNG_STRING_NEWLINE); \ 114 fprintf(PNG_DEBUG_FILE,format); \ 115 } while (0) 116# endif 117# ifndef png_debug1 118# define png_debug1(l,m,p1) \ 119 do { \ 120 int num_tabs=l; \ 121 char format[256]; \ 122 snprintf(format,256,"%s%s%s",(num_tabs==1 ? "\t" : \ 123 (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))), \ 124 m,PNG_STRING_NEWLINE); \ 125 fprintf(PNG_DEBUG_FILE,format,p1); \ 126 } while (0) 127# endif 128# ifndef png_debug2 129# define png_debug2(l,m,p1,p2) \ 130 do { \ 131 int num_tabs=l; \ 132 char format[256]; \ 133 snprintf(format,256,"%s%s%s",(num_tabs==1 ? "\t" : \ 134 (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))), \ 135 m,PNG_STRING_NEWLINE); \ 136 fprintf(PNG_DEBUG_FILE,format,p1,p2); \ 137 } while (0) 138# endif 139# endif /* __STDC __ */ 140# endif /* (PNG_DEBUG > 1) */ 141 142# endif /* _MSC_VER */ 143# endif /* (PNG_DEBUG > 0) */ 144#endif /* PNG_DEBUG */ 145#ifndef png_debug 146# define png_debug(l, m) ((void)0) 147#endif 148#ifndef png_debug1 149# define png_debug1(l, m, p1) ((void)0) 150#endif 151#ifndef png_debug2 152# define png_debug2(l, m, p1, p2) ((void)0) 153#endif 154#endif /* PNGDEBUG_H */ 155