]> git.saurik.com Git - wxWidgets.git/blame - src/png/pngerror.c
Added wxUSE_DC_CACHEING and associated code to wxMSW
[wxWidgets.git] / src / png / pngerror.c
CommitLineData
c801d85f
KB
1
2/* pngerror.c - stub functions for i/o and memory allocation
3 *
a626cc03 4 * libpng 1.0.3 - January 14, 1999
c801d85f
KB
5 * For conditions of distribution and use, see copyright notice in png.h
6 * Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.
7 * Copyright (c) 1996, 1997 Andreas Dilger
a626cc03 8 * Copyright (c) 1998, 1999 Glenn Randers-Pehrson
c801d85f 9 *
a626cc03 10 * This file provides a location for all error handling. Users who
c801d85f
KB
11 * need special error handling are expected to write replacement functions
12 * and use png_set_error_fn() to use those functions. See the instructions
13 * at each function.
14 */
15
16#define PNG_INTERNAL
a626cc03 17#include "png.h"
c801d85f
KB
18
19static void png_default_error PNGARG((png_structp png_ptr,
20 png_const_charp message));
21static void png_default_warning PNGARG((png_structp png_ptr,
22 png_const_charp message));
23
24/* This function is called whenever there is a fatal error. This function
25 * should not be changed. If there is a need to handle errors differently,
26 * you should supply a replacement error function and use png_set_error_fn()
27 * to replace the error function at run-time.
28 */
29void
30png_error(png_structp png_ptr, png_const_charp message)
31{
32 if (png_ptr->error_fn != NULL)
33 (*(png_ptr->error_fn))(png_ptr, message);
34
35 /* if the following returns or doesn't exist, use the default function,
36 which will not return */
37 png_default_error(png_ptr, message);
38}
39
40/* This function is called whenever there is a non-fatal error. This function
41 * should not be changed. If there is a need to handle warnings differently,
42 * you should supply a replacement warning function and use
43 * png_set_error_fn() to replace the warning function at run-time.
44 */
45void
46png_warning(png_structp png_ptr, png_const_charp message)
47{
48 if (png_ptr->warning_fn != NULL)
49 (*(png_ptr->warning_fn))(png_ptr, message);
50 else
51 png_default_warning(png_ptr, message);
52}
53
a626cc03 54/* These utilities are used internally to build an error message that relates
c801d85f
KB
55 * to the current chunk. The chunk name comes from png_ptr->chunk_name,
56 * this is used to prefix the message. The message is limited in length
57 * to 63 bytes, the name characters are output as hex digits wrapped in []
58 * if the character is invalid.
59 */
60#define isnonalpha(c) ((c) < 41 || (c) > 122 || ((c) > 90 && (c) < 97))
61static PNG_CONST char png_digit[16] = {
62 '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'
63};
64
65static void
66png_format_buffer(png_structp png_ptr, png_charp buffer, png_const_charp message)
67{
68 int iout = 0, iin = 0;
69
70 while (iin < 4) {
71 int c = png_ptr->chunk_name[iin++];
72 if (isnonalpha(c)) {
73 buffer[iout++] = '[';
74 buffer[iout++] = png_digit[(c & 0xf0) >> 4];
75 buffer[iout++] = png_digit[c & 0xf];
76 buffer[iout++] = ']';
77 } else {
78 buffer[iout++] = c;
79 }
80 }
81
82 if (message == NULL)
83 buffer[iout] = 0;
84 else {
85 buffer[iout++] = ':';
86 buffer[iout++] = ' ';
87 png_memcpy(buffer+iout, message, 64);
88 buffer[iout+63] = 0;
89 }
90}
91
92void
93png_chunk_error(png_structp png_ptr, png_const_charp message)
94{
95 char msg[16+64];
96 png_format_buffer(png_ptr, msg, message);
97 png_error(png_ptr, msg);
98}
99
100void
101png_chunk_warning(png_structp png_ptr, png_const_charp message)
102{
103 char msg[16+64];
104 png_format_buffer(png_ptr, msg, message);
105 png_warning(png_ptr, msg);
106}
107
108/* This is the default error handling function. Note that replacements for
109 * this function MUST NOT RETURN, or the program will likely crash. This
110 * function is used by default, or if the program supplies NULL for the
111 * error function pointer in png_set_error_fn().
112 */
113static void
114png_default_error(png_structp png_ptr, png_const_charp message)
115{
a626cc03 116#ifndef PNG_NO_CONSOLE_IO
c801d85f
KB
117 fprintf(stderr, "libpng error: %s\n", message);
118#endif
119
120#ifdef USE_FAR_KEYWORD
121 {
122 jmp_buf jmpbuf;
123 png_memcpy(jmpbuf,png_ptr->jmpbuf,sizeof(jmp_buf));
124 longjmp(jmpbuf, 1);
125 }
126#else
127 longjmp(png_ptr->jmpbuf, 1);
128#endif
129}
130
131/* This function is called when there is a warning, but the library thinks
132 * it can continue anyway. Replacement functions don't have to do anything
a626cc03 133 * here if you don't want them to. In the default configuration, png_ptr is
c801d85f
KB
134 * not used, but it is passed in case it may be useful.
135 */
136static void
137png_default_warning(png_structp png_ptr, png_const_charp message)
138{
a626cc03 139#ifndef PNG_NO_CONSOLE_IO
c801d85f
KB
140 fprintf(stderr, "libpng warning: %s\n", message);
141#endif
a626cc03
RR
142 if (png_ptr == NULL)
143 return;
c801d85f
KB
144}
145
146/* This function is called when the application wants to use another method
147 * of handling errors and warnings. Note that the error function MUST NOT
148 * return to the calling routine or serious problems will occur. The return
149 * method used in the default routine calls longjmp(png_ptr->jmpbuf, 1)
150 */
151void
152png_set_error_fn(png_structp png_ptr, png_voidp error_ptr,
153 png_error_ptr error_fn, png_error_ptr warning_fn)
154{
155 png_ptr->error_ptr = error_ptr;
156 png_ptr->error_fn = error_fn;
157 png_ptr->warning_fn = warning_fn;
158}
159
160
161/* This function returns a pointer to the error_ptr associated with the user
162 * functions. The application should free any memory associated with this
163 * pointer before png_write_destroy and png_read_destroy are called.
164 */
165png_voidp
166png_get_error_ptr(png_structp png_ptr)
167{
168 return ((png_voidp)png_ptr->error_ptr);
169}
170
171
172