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