[DEVENUM]
[reactos.git] / reactos / dll / 3rdparty / libpng / pngdebug.h
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 */