1/*
2 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
3 *
4 * This code is free software; you can redistribute it and/or modify it
5 * under the terms of the GNU General Public License version 2 only, as
6 * published by the Free Software Foundation.  Oracle designates this
7 * particular file as subject to the "Classpath" exception as provided
8 * by Oracle in the LICENSE file that accompanied this code.
9 *
10 * This code is distributed in the hope that it will be useful, but WITHOUT
11 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
13 * version 2 for more details (a copy is included in the LICENSE file that
14 * accompanied this code).
15 *
16 * You should have received a copy of the GNU General Public License version
17 * 2 along with this work; if not, write to the Free Software Foundation,
18 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
19 *
20 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
21 * or visit www.oracle.com if you need additional information or have any
22 * questions.
23 */
24
25/* pngdebug.h - Debugging macros for libpng, also used in pngtest.c
26 *
27 * This file is available under and governed by the GNU General Public
28 * License version 2 only, as published by the Free Software Foundation.
29 * However, the following notice accompanied the original version of this
30 * file and, per its terms, should not be removed:
31 *
32 * Last changed in libpng 1.6.8 [December 19, 2013]
33 * Copyright (c) 1998-2002,2004,2006-2013 Glenn Randers-Pehrson
34 * (Version 0.96 Copyright (c) 1996, 1997 Andreas Dilger)
35 * (Version 0.88 Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.)
36 *
37 * This code is released under the libpng license.
38 * For conditions of distribution and use, see the disclaimer
39 * and license in png.h
40 */
41
42/* Define PNG_DEBUG at compile time for debugging information.  Higher
43 * numbers for PNG_DEBUG mean more debugging information.  This has
44 * only been added since version 0.95 so it is not implemented throughout
45 * libpng yet, but more support will be added as needed.
46 *
47 * png_debug[1-2]?(level, message ,arg{0-2})
48 *   Expands to a statement (either a simple expression or a compound
49 *   do..while(0) statement) that outputs a message with parameter
50 *   substitution if PNG_DEBUG is defined to 2 or more.  If PNG_DEBUG
51 *   is undefined, 0 or 1 every png_debug expands to a simple expression
52 *   (actually ((void)0)).
53 *
54 *   level: level of detail of message, starting at 0.  A level 'n'
55 *          message is preceded by 'n' 3-space indentations (not implemented
56 *          on Microsoft compilers unless PNG_DEBUG_FILE is also
57 *          defined, to allow debug DLL compilation with no standard IO).
58 *   message: a printf(3) style text string.  A trailing '\n' is added
59 *            to the message.
60 *   arg: 0 to 2 arguments for printf(3) style substitution in message.
61 */
62#ifndef PNGDEBUG_H
63#define PNGDEBUG_H
64/* These settings control the formatting of messages in png.c and pngerror.c */
65/* Moved to pngdebug.h at 1.5.0 */
66#  ifndef PNG_LITERAL_SHARP
67#    define PNG_LITERAL_SHARP 0x23
68#  endif
69#  ifndef PNG_LITERAL_LEFT_SQUARE_BRACKET
70#    define PNG_LITERAL_LEFT_SQUARE_BRACKET 0x5b
71#  endif
72#  ifndef PNG_LITERAL_RIGHT_SQUARE_BRACKET
73#    define PNG_LITERAL_RIGHT_SQUARE_BRACKET 0x5d
74#  endif
75#  ifndef PNG_STRING_NEWLINE
76#    define PNG_STRING_NEWLINE "\n"
77#  endif
78
79#ifdef PNG_DEBUG
80#  if (PNG_DEBUG > 0)
81#    if !defined(PNG_DEBUG_FILE) && defined(_MSC_VER)
82#      include <crtdbg.h>
83#      if (PNG_DEBUG > 1)
84#        ifndef _DEBUG
85#          define _DEBUG
86#        endif
87#        ifndef png_debug
88#          define png_debug(l,m)  _RPT0(_CRT_WARN,m PNG_STRING_NEWLINE)
89#        endif
90#        ifndef png_debug1
91#          define png_debug1(l,m,p1)  _RPT1(_CRT_WARN,m PNG_STRING_NEWLINE,p1)
92#        endif
93#        ifndef png_debug2
94#          define png_debug2(l,m,p1,p2) \
95             _RPT2(_CRT_WARN,m PNG_STRING_NEWLINE,p1,p2)
96#        endif
97#      endif
98#    else /* PNG_DEBUG_FILE || !_MSC_VER */
99#      ifndef PNG_STDIO_SUPPORTED
100#        include <stdio.h> /* not included yet */
101#      endif
102#      ifndef PNG_DEBUG_FILE
103#        define PNG_DEBUG_FILE stderr
104#      endif /* PNG_DEBUG_FILE */
105
106#      if (PNG_DEBUG > 1)
107#        ifdef __STDC__
108#          ifndef png_debug
109#            define png_debug(l,m) \
110       do { \
111       int num_tabs=l; \
112       fprintf(PNG_DEBUG_FILE,"%s" m PNG_STRING_NEWLINE,(num_tabs==1 ? "   " : \
113         (num_tabs==2 ? "      " : (num_tabs>2 ? "         " : "")))); \
114       } while (0)
115#          endif
116#          ifndef png_debug1
117#            define png_debug1(l,m,p1) \
118       do { \
119       int num_tabs=l; \
120       fprintf(PNG_DEBUG_FILE,"%s" m PNG_STRING_NEWLINE,(num_tabs==1 ? "   " : \
121         (num_tabs==2 ? "      " : (num_tabs>2 ? "         " : ""))),p1); \
122       } while (0)
123#          endif
124#          ifndef png_debug2
125#            define png_debug2(l,m,p1,p2) \
126       do { \
127       int num_tabs=l; \
128       fprintf(PNG_DEBUG_FILE,"%s" m PNG_STRING_NEWLINE,(num_tabs==1 ? "   " : \
129         (num_tabs==2 ? "      " : (num_tabs>2 ? "         " : ""))),p1,p2);\
130       } while (0)
131#          endif
132#        else /* __STDC __ */
133#          ifndef png_debug
134#            define png_debug(l,m) \
135       do { \
136       int num_tabs=l; \
137       char format[256]; \
138       snprintf(format,256,"%s%s%s",(num_tabs==1 ? "\t" : \
139         (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))), \
140         m,PNG_STRING_NEWLINE); \
141       fprintf(PNG_DEBUG_FILE,format); \
142       } while (0)
143#          endif
144#          ifndef png_debug1
145#            define png_debug1(l,m,p1) \
146       do { \
147       int num_tabs=l; \
148       char format[256]; \
149       snprintf(format,256,"%s%s%s",(num_tabs==1 ? "\t" : \
150         (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))), \
151         m,PNG_STRING_NEWLINE); \
152       fprintf(PNG_DEBUG_FILE,format,p1); \
153       } while (0)
154#          endif
155#          ifndef png_debug2
156#            define png_debug2(l,m,p1,p2) \
157       do { \
158       int num_tabs=l; \
159       char format[256]; \
160       snprintf(format,256,"%s%s%s",(num_tabs==1 ? "\t" : \
161         (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))), \
162         m,PNG_STRING_NEWLINE); \
163       fprintf(PNG_DEBUG_FILE,format,p1,p2); \
164       } while (0)
165#          endif
166#        endif /* __STDC __ */
167#      endif /* (PNG_DEBUG > 1) */
168
169#    endif /* _MSC_VER */
170#  endif /* (PNG_DEBUG > 0) */
171#endif /* PNG_DEBUG */
172#ifndef png_debug
173#  define png_debug(l, m) ((void)0)
174#endif
175#ifndef png_debug1
176#  define png_debug1(l, m, p1) ((void)0)
177#endif
178#ifndef png_debug2
179#  define png_debug2(l, m, p1, p2) ((void)0)
180#endif
181#endif /* PNGDEBUG_H */
182