2 /* pngerror.c - stub functions for i/o and memory allocation
4 * libpng 1.2.0 - September 1, 2001
5 * For conditions of distribution and use, see copyright notice in png.h
6 * Copyright (c) 1998-2001 Glenn Randers-Pehrson
7 * (Version 0.96 Copyright (c) 1996, 1997 Andreas Dilger)
8 * (Version 0.88 Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.)
10 * This file provides a location for all error handling. Users who
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
19 static void /* PRIVATE */
20 png_default_error PNGARG((png_structp png_ptr,
21 png_const_charp message));
22 static void /* PRIVATE */
23 png_default_warning PNGARG((png_structp png_ptr,
24 png_const_charp message));
26 /* This function is called whenever there is a fatal error. This function
27 * should not be changed. If there is a need to handle errors differently,
28 * you should supply a replacement error function and use png_set_error_fn()
29 * to replace the error function at run-time.
32 png_error(png_structp png_ptr, png_const_charp message)
34 #ifdef PNG_ERROR_NUMBERS_SUPPORTED
36 if (png_ptr->flags&(PNG_FLAG_STRIP_ERROR_NUMBERS|PNG_FLAG_STRIP_ERROR_TEXT))
41 for (offset=1; offset<15; offset++)
42 if (*(message+offset) == ' ')
44 if (png_ptr->flags&PNG_FLAG_STRIP_ERROR_TEXT)
47 for (i=0; i<offset-1; i++)
57 if (png_ptr->flags&PNG_FLAG_STRIP_ERROR_TEXT)
66 if (png_ptr->error_fn != NULL)
67 (*(png_ptr->error_fn))(png_ptr, message);
69 /* if the following returns or doesn't exist, use the default function,
70 which will not return */
71 png_default_error(png_ptr, message);
74 /* This function is called whenever there is a non-fatal error. This function
75 * should not be changed. If there is a need to handle warnings differently,
76 * you should supply a replacement warning function and use
77 * png_set_error_fn() to replace the warning function at run-time.
80 png_warning(png_structp png_ptr, png_const_charp message)
83 #ifdef PNG_ERROR_NUMBERS_SUPPORTED
84 if (png_ptr->flags&(PNG_FLAG_STRIP_ERROR_NUMBERS|PNG_FLAG_STRIP_ERROR_TEXT))
89 for (offset=1; offset<15; offset++)
90 if (*(message+offset) == ' ')
94 if (png_ptr->warning_fn != NULL)
95 (*(png_ptr->warning_fn))(png_ptr, (png_const_charp)(message+offset));
97 png_default_warning(png_ptr, (png_const_charp)(message+offset));
100 /* These utilities are used internally to build an error message that relates
101 * to the current chunk. The chunk name comes from png_ptr->chunk_name,
102 * this is used to prefix the message. The message is limited in length
103 * to 63 bytes, the name characters are output as hex digits wrapped in []
104 * if the character is invalid.
106 #define isnonalpha(c) ((c) < 41 || (c) > 122 || ((c) > 90 && (c) < 97))
107 static PNG_CONST char png_digit[16] = {
108 '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E',
111 static void /* PRIVATE */
112 png_format_buffer(png_structp png_ptr, png_charp buffer, png_const_charp
115 int iout = 0, iin = 0;
119 int c = png_ptr->chunk_name[iin++];
122 buffer[iout++] = '[';
123 buffer[iout++] = png_digit[(c & 0xf0) >> 4];
124 buffer[iout++] = png_digit[c & 0x0f];
125 buffer[iout++] = ']';
129 buffer[iout++] = (png_byte)c;
137 buffer[iout++] = ':';
138 buffer[iout++] = ' ';
139 png_memcpy(buffer+iout, message, 64);
145 png_chunk_error(png_structp png_ptr, png_const_charp message)
148 png_format_buffer(png_ptr, msg, message);
149 png_error(png_ptr, msg);
153 png_chunk_warning(png_structp png_ptr, png_const_charp message)
156 png_format_buffer(png_ptr, msg, message);
157 png_warning(png_ptr, msg);
160 /* This is the default error handling function. Note that replacements for
161 * this function MUST NOT RETURN, or the program will likely crash. This
162 * function is used by default, or if the program supplies NULL for the
163 * error function pointer in png_set_error_fn().
165 static void /* PRIVATE */
166 png_default_error(png_structp png_ptr, png_const_charp message)
168 #ifndef PNG_NO_CONSOLE_IO
169 #ifdef PNG_ERROR_NUMBERS_SUPPORTED
173 char error_number[16];
174 for (offset=0; offset<15; offset++)
176 error_number[offset] = *(message+offset+1);
177 if (*(message+offset) == ' ')
180 if((offset > 1) && (offset < 15))
182 error_number[offset-1]='\0';
183 fprintf(stderr, "libpng error no. %s: %s\n", error_number, message+offset);
186 fprintf(stderr, "libpng error: %s, offset=%d\n", message,offset);
190 fprintf(stderr, "libpng error: %s\n", message);
193 /* make compiler happy */ ;
196 #ifdef PNG_SETJMP_SUPPORTED
197 # ifdef USE_FAR_KEYWORD
200 png_memcpy(jmpbuf,png_ptr->jmpbuf,sizeof(jmp_buf));
204 longjmp(png_ptr->jmpbuf, 1);
208 /* make compiler happy */ ;
213 /* This function is called when there is a warning, but the library thinks
214 * it can continue anyway. Replacement functions don't have to do anything
215 * here if you don't want them to. In the default configuration, png_ptr is
216 * not used, but it is passed in case it may be useful.
218 static void /* PRIVATE */
219 png_default_warning(png_structp png_ptr, png_const_charp message)
221 #ifndef PNG_NO_CONSOLE_IO
222 # ifdef PNG_ERROR_NUMBERS_SUPPORTED
226 char warning_number[16];
227 for (offset=0; offset<15; offset++)
229 warning_number[offset]=*(message+offset+1);
230 if (*(message+offset) == ' ')
233 if((offset > 1) && (offset < 15))
235 warning_number[offset-1]='\0';
236 fprintf(stderr, "libpng warning no. %s: %s\n", warning_number,
240 fprintf(stderr, "libpng warning: %s\n", message);
244 fprintf(stderr, "libpng warning: %s\n", message);
247 /* appease compiler */ ;
253 /* This function is called when the application wants to use another method
254 * of handling errors and warnings. Note that the error function MUST NOT
255 * return to the calling routine or serious problems will occur. The return
256 * method used in the default routine calls longjmp(png_ptr->jmpbuf, 1)
259 png_set_error_fn(png_structp png_ptr, png_voidp error_ptr,
260 png_error_ptr error_fn, png_error_ptr warning_fn)
262 png_ptr->error_ptr = error_ptr;
263 png_ptr->error_fn = error_fn;
264 png_ptr->warning_fn = warning_fn;
268 /* This function returns a pointer to the error_ptr associated with the user
269 * functions. The application should free any memory associated with this
270 * pointer before png_write_destroy and png_read_destroy are called.
273 png_get_error_ptr(png_structp png_ptr)
275 return ((png_voidp)png_ptr->error_ptr);
279 #ifdef PNG_ERROR_NUMBERS_SUPPORTED
281 png_set_strip_error_numbers(png_structp png_ptr, png_uint_32 strip_mode)
286 ((~(PNG_FLAG_STRIP_ERROR_NUMBERS|PNG_FLAG_STRIP_ERROR_TEXT))&strip_mode);