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