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