share/png/pngdebug.h

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