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