1/*
2 * jerror.h
3 *
4 * This file was part of the Independent JPEG Group's software:
5 * Copyright (C) 1994-1997, Thomas G. Lane.
6 * Modified 1997-2009 by Guido Vollbeding.
7 * libjpeg-turbo Modifications:
8 * Copyright (C) 2014, 2017, D. R. Commander.
9 * For conditions of distribution and use, see the accompanying README.ijg
10 * file.
11 *
12 * This file defines the error and message codes for the JPEG library.
13 * Edit this file to add new codes, or to translate the message strings to
14 * some other language.
15 * A set of error-reporting macros are defined too. Some applications using
16 * the JPEG library may wish to include this file to get the error codes
17 * and/or the macros.
18 */
19
20/*
21 * To define the enum list of message codes, include this file without
22 * defining macro JMESSAGE. To create a message string table, include it
23 * again with a suitable JMESSAGE definition (see jerror.c for an example).
24 */
25#ifndef JMESSAGE
26#ifndef JERROR_H
27/* First time through, define the enum list */
28#define JMAKE_ENUM_LIST
29#else
30/* Repeated inclusions of this file are no-ops unless JMESSAGE is defined */
31#define JMESSAGE(code, string)
32#endif /* JERROR_H */
33#endif /* JMESSAGE */
34
35#ifdef JMAKE_ENUM_LIST
36
37typedef enum {
38
39#define JMESSAGE(code, string) code,
40
41#endif /* JMAKE_ENUM_LIST */
42
43JMESSAGE(JMSG_NOMESSAGE, "Bogus message code %d") /* Must be first entry! */
44
45/* For maintenance convenience, list is alphabetical by message code name */
46#if JPEG_LIB_VERSION < 70
47JMESSAGE(JERR_ARITH_NOTIMPL, "Sorry, arithmetic coding is not implemented")
48#endif
49JMESSAGE(JERR_BAD_ALIGN_TYPE, "ALIGN_TYPE is wrong, please fix")
50JMESSAGE(JERR_BAD_ALLOC_CHUNK, "MAX_ALLOC_CHUNK is wrong, please fix")
51JMESSAGE(JERR_BAD_BUFFER_MODE, "Bogus buffer control mode")
52JMESSAGE(JERR_BAD_COMPONENT_ID, "Invalid component ID %d in SOS")
53#if JPEG_LIB_VERSION >= 70
54JMESSAGE(JERR_BAD_CROP_SPEC, "Invalid crop request")
55#endif
56JMESSAGE(JERR_BAD_DCT_COEF, "DCT coefficient out of range")
57JMESSAGE(JERR_BAD_DCTSIZE, "IDCT output block size %d not supported")
58#if JPEG_LIB_VERSION >= 70
59JMESSAGE(JERR_BAD_DROP_SAMPLING,
60 "Component index %d: mismatching sampling ratio %d:%d, %d:%d, %c")
61#endif
62JMESSAGE(JERR_BAD_HUFF_TABLE, "Bogus Huffman table definition")
63JMESSAGE(JERR_BAD_IN_COLORSPACE, "Bogus input colorspace")
64JMESSAGE(JERR_BAD_J_COLORSPACE, "Bogus JPEG colorspace")
65JMESSAGE(JERR_BAD_LENGTH, "Bogus marker length")
66JMESSAGE(JERR_BAD_LIB_VERSION,
67 "Wrong JPEG library version: library is %d, caller expects %d")
68JMESSAGE(JERR_BAD_MCU_SIZE, "Sampling factors too large for interleaved scan")
69JMESSAGE(JERR_BAD_POOL_ID, "Invalid memory pool code %d")
70JMESSAGE(JERR_BAD_PRECISION, "Unsupported JPEG data precision %d")
71JMESSAGE(JERR_BAD_PROGRESSION,
72 "Invalid progressive parameters Ss=%d Se=%d Ah=%d Al=%d")
73JMESSAGE(JERR_BAD_PROG_SCRIPT,
74 "Invalid progressive parameters at scan script entry %d")
75JMESSAGE(JERR_BAD_SAMPLING, "Bogus sampling factors")
76JMESSAGE(JERR_BAD_SCAN_SCRIPT, "Invalid scan script at entry %d")
77JMESSAGE(JERR_BAD_STATE, "Improper call to JPEG library in state %d")
78JMESSAGE(JERR_BAD_STRUCT_SIZE,
79 "JPEG parameter struct mismatch: library thinks size is %u, caller expects %u")
80JMESSAGE(JERR_BAD_VIRTUAL_ACCESS, "Bogus virtual array access")
81JMESSAGE(JERR_BUFFER_SIZE, "Buffer passed to JPEG library is too small")
82JMESSAGE(JERR_CANT_SUSPEND, "Suspension not allowed here")
83JMESSAGE(JERR_CCIR601_NOTIMPL, "CCIR601 sampling not implemented yet")
84JMESSAGE(JERR_COMPONENT_COUNT, "Too many color components: %d, max %d")
85JMESSAGE(JERR_CONVERSION_NOTIMPL, "Unsupported color conversion request")
86JMESSAGE(JERR_DAC_INDEX, "Bogus DAC index %d")
87JMESSAGE(JERR_DAC_VALUE, "Bogus DAC value 0x%x")
88JMESSAGE(JERR_DHT_INDEX, "Bogus DHT index %d")
89JMESSAGE(JERR_DQT_INDEX, "Bogus DQT index %d")
90JMESSAGE(JERR_EMPTY_IMAGE, "Empty JPEG image (DNL not supported)")
91JMESSAGE(JERR_EMS_READ, "Read from EMS failed")
92JMESSAGE(JERR_EMS_WRITE, "Write to EMS failed")
93JMESSAGE(JERR_EOI_EXPECTED, "Didn't expect more than one scan")
94JMESSAGE(JERR_FILE_READ, "Input file read error")
95JMESSAGE(JERR_FILE_WRITE, "Output file write error --- out of disk space?")
96JMESSAGE(JERR_FRACT_SAMPLE_NOTIMPL, "Fractional sampling not implemented yet")
97JMESSAGE(JERR_HUFF_CLEN_OVERFLOW, "Huffman code size table overflow")
98JMESSAGE(JERR_HUFF_MISSING_CODE, "Missing Huffman code table entry")
99JMESSAGE(JERR_IMAGE_TOO_BIG, "Maximum supported image dimension is %u pixels")
100JMESSAGE(JERR_INPUT_EMPTY, "Empty input file")
101JMESSAGE(JERR_INPUT_EOF, "Premature end of input file")
102JMESSAGE(JERR_MISMATCHED_QUANT_TABLE,
103 "Cannot transcode due to multiple use of quantization table %d")
104JMESSAGE(JERR_MISSING_DATA, "Scan script does not transmit all data")
105JMESSAGE(JERR_MODE_CHANGE, "Invalid color quantization mode change")
106JMESSAGE(JERR_NOTIMPL, "Not implemented yet")
107JMESSAGE(JERR_NOT_COMPILED, "Requested feature was omitted at compile time")
108#if JPEG_LIB_VERSION >= 70
109JMESSAGE(JERR_NO_ARITH_TABLE, "Arithmetic table 0x%02x was not defined")
110#endif
111JMESSAGE(JERR_NO_BACKING_STORE, "Backing store not supported")
112JMESSAGE(JERR_NO_HUFF_TABLE, "Huffman table 0x%02x was not defined")
113JMESSAGE(JERR_NO_IMAGE, "JPEG datastream contains no image")
114JMESSAGE(JERR_NO_QUANT_TABLE, "Quantization table 0x%02x was not defined")
115JMESSAGE(JERR_NO_SOI, "Not a JPEG file: starts with 0x%02x 0x%02x")
116JMESSAGE(JERR_OUT_OF_MEMORY, "Insufficient memory (case %d)")
117JMESSAGE(JERR_QUANT_COMPONENTS,
118 "Cannot quantize more than %d color components")
119JMESSAGE(JERR_QUANT_FEW_COLORS, "Cannot quantize to fewer than %d colors")
120JMESSAGE(JERR_QUANT_MANY_COLORS, "Cannot quantize to more than %d colors")
121JMESSAGE(JERR_SOF_DUPLICATE, "Invalid JPEG file structure: two SOF markers")
122JMESSAGE(JERR_SOF_NO_SOS, "Invalid JPEG file structure: missing SOS marker")
123JMESSAGE(JERR_SOF_UNSUPPORTED, "Unsupported JPEG process: SOF type 0x%02x")
124JMESSAGE(JERR_SOI_DUPLICATE, "Invalid JPEG file structure: two SOI markers")
125JMESSAGE(JERR_SOS_NO_SOF, "Invalid JPEG file structure: SOS before SOF")
126JMESSAGE(JERR_TFILE_CREATE, "Failed to create temporary file %s")
127JMESSAGE(JERR_TFILE_READ, "Read failed on temporary file")
128JMESSAGE(JERR_TFILE_SEEK, "Seek failed on temporary file")
129JMESSAGE(JERR_TFILE_WRITE,
130 "Write failed on temporary file --- out of disk space?")
131JMESSAGE(JERR_TOO_LITTLE_DATA, "Application transferred too few scanlines")
132JMESSAGE(JERR_UNKNOWN_MARKER, "Unsupported marker type 0x%02x")
133JMESSAGE(JERR_VIRTUAL_BUG, "Virtual array controller messed up")
134JMESSAGE(JERR_WIDTH_OVERFLOW, "Image too wide for this implementation")
135JMESSAGE(JERR_XMS_READ, "Read from XMS failed")
136JMESSAGE(JERR_XMS_WRITE, "Write to XMS failed")
137JMESSAGE(JMSG_COPYRIGHT, JCOPYRIGHT_SHORT)
138JMESSAGE(JMSG_VERSION, JVERSION)
139JMESSAGE(JTRC_16BIT_TABLES,
140 "Caution: quantization tables are too coarse for baseline JPEG")
141JMESSAGE(JTRC_ADOBE,
142 "Adobe APP14 marker: version %d, flags 0x%04x 0x%04x, transform %d")
143JMESSAGE(JTRC_APP0, "Unknown APP0 marker (not JFIF), length %u")
144JMESSAGE(JTRC_APP14, "Unknown APP14 marker (not Adobe), length %u")
145JMESSAGE(JTRC_DAC, "Define Arithmetic Table 0x%02x: 0x%02x")
146JMESSAGE(JTRC_DHT, "Define Huffman Table 0x%02x")
147JMESSAGE(JTRC_DQT, "Define Quantization Table %d precision %d")
148JMESSAGE(JTRC_DRI, "Define Restart Interval %u")
149JMESSAGE(JTRC_EMS_CLOSE, "Freed EMS handle %u")
150JMESSAGE(JTRC_EMS_OPEN, "Obtained EMS handle %u")
151JMESSAGE(JTRC_EOI, "End Of Image")
152JMESSAGE(JTRC_HUFFBITS, " %3d %3d %3d %3d %3d %3d %3d %3d")
153JMESSAGE(JTRC_JFIF, "JFIF APP0 marker: version %d.%02d, density %dx%d %d")
154JMESSAGE(JTRC_JFIF_BADTHUMBNAILSIZE,
155 "Warning: thumbnail image size does not match data length %u")
156JMESSAGE(JTRC_JFIF_EXTENSION, "JFIF extension marker: type 0x%02x, length %u")
157JMESSAGE(JTRC_JFIF_THUMBNAIL, " with %d x %d thumbnail image")
158JMESSAGE(JTRC_MISC_MARKER, "Miscellaneous marker 0x%02x, length %u")
159JMESSAGE(JTRC_PARMLESS_MARKER, "Unexpected marker 0x%02x")
160JMESSAGE(JTRC_QUANTVALS, " %4u %4u %4u %4u %4u %4u %4u %4u")
161JMESSAGE(JTRC_QUANT_3_NCOLORS, "Quantizing to %d = %d*%d*%d colors")
162JMESSAGE(JTRC_QUANT_NCOLORS, "Quantizing to %d colors")
163JMESSAGE(JTRC_QUANT_SELECTED, "Selected %d colors for quantization")
164JMESSAGE(JTRC_RECOVERY_ACTION, "At marker 0x%02x, recovery action %d")
165JMESSAGE(JTRC_RST, "RST%d")
166JMESSAGE(JTRC_SMOOTH_NOTIMPL,
167 "Smoothing not supported with nonstandard sampling ratios")
168JMESSAGE(JTRC_SOF, "Start Of Frame 0x%02x: width=%u, height=%u, components=%d")
169JMESSAGE(JTRC_SOF_COMPONENT, " Component %d: %dhx%dv q=%d")
170JMESSAGE(JTRC_SOI, "Start of Image")
171JMESSAGE(JTRC_SOS, "Start Of Scan: %d components")
172JMESSAGE(JTRC_SOS_COMPONENT, " Component %d: dc=%d ac=%d")
173JMESSAGE(JTRC_SOS_PARAMS, " Ss=%d, Se=%d, Ah=%d, Al=%d")
174JMESSAGE(JTRC_TFILE_CLOSE, "Closed temporary file %s")
175JMESSAGE(JTRC_TFILE_OPEN, "Opened temporary file %s")
176JMESSAGE(JTRC_THUMB_JPEG,
177 "JFIF extension marker: JPEG-compressed thumbnail image, length %u")
178JMESSAGE(JTRC_THUMB_PALETTE,
179 "JFIF extension marker: palette thumbnail image, length %u")
180JMESSAGE(JTRC_THUMB_RGB,
181 "JFIF extension marker: RGB thumbnail image, length %u")
182JMESSAGE(JTRC_UNKNOWN_IDS,
183 "Unrecognized component IDs %d %d %d, assuming YCbCr")
184JMESSAGE(JTRC_XMS_CLOSE, "Freed XMS handle %u")
185JMESSAGE(JTRC_XMS_OPEN, "Obtained XMS handle %u")
186JMESSAGE(JWRN_ADOBE_XFORM, "Unknown Adobe color transform code %d")
187#if JPEG_LIB_VERSION >= 70
188JMESSAGE(JWRN_ARITH_BAD_CODE, "Corrupt JPEG data: bad arithmetic code")
189#endif
190JMESSAGE(JWRN_BOGUS_PROGRESSION,
191 "Inconsistent progression sequence for component %d coefficient %d")
192JMESSAGE(JWRN_EXTRANEOUS_DATA,
193 "Corrupt JPEG data: %u extraneous bytes before marker 0x%02x")
194JMESSAGE(JWRN_HIT_MARKER, "Corrupt JPEG data: premature end of data segment")
195JMESSAGE(JWRN_HUFF_BAD_CODE, "Corrupt JPEG data: bad Huffman code")
196JMESSAGE(JWRN_JFIF_MAJOR, "Warning: unknown JFIF revision number %d.%02d")
197JMESSAGE(JWRN_JPEG_EOF, "Premature end of JPEG file")
198JMESSAGE(JWRN_MUST_RESYNC,
199 "Corrupt JPEG data: found marker 0x%02x instead of RST%d")
200JMESSAGE(JWRN_NOT_SEQUENTIAL, "Invalid SOS parameters for sequential JPEG")
201JMESSAGE(JWRN_TOO_MUCH_DATA, "Application transferred too many scanlines")
202#if JPEG_LIB_VERSION < 70
203JMESSAGE(JERR_BAD_CROP_SPEC, "Invalid crop request")
204#if defined(C_ARITH_CODING_SUPPORTED) || defined(D_ARITH_CODING_SUPPORTED)
205JMESSAGE(JERR_NO_ARITH_TABLE, "Arithmetic table 0x%02x was not defined")
206JMESSAGE(JWRN_ARITH_BAD_CODE, "Corrupt JPEG data: bad arithmetic code")
207#endif
208#endif
209JMESSAGE(JWRN_BOGUS_ICC, "Corrupt JPEG data: bad ICC marker")
210#if JPEG_LIB_VERSION < 70
211JMESSAGE(JERR_BAD_DROP_SAMPLING,
212 "Component index %d: mismatching sampling ratio %d:%d, %d:%d, %c")
213#endif
214
215#ifdef JMAKE_ENUM_LIST
216
217 JMSG_LASTMSGCODE
218} J_MESSAGE_CODE;
219
220#undef JMAKE_ENUM_LIST
221#endif /* JMAKE_ENUM_LIST */
222
223/* Zap JMESSAGE macro so that future re-inclusions do nothing by default */
224#undef JMESSAGE
225
226
227#ifndef JERROR_H
228#define JERROR_H
229
230/* Macros to simplify using the error and trace message stuff */
231/* The first parameter is either type of cinfo pointer */
232
233/* Fatal errors (print message and exit) */
234#define ERREXIT(cinfo, code) \
235 ((cinfo)->err->msg_code = (code), \
236 (*(cinfo)->err->error_exit) ((j_common_ptr)(cinfo)))
237#define ERREXIT1(cinfo, code, p1) \
238 ((cinfo)->err->msg_code = (code), \
239 (cinfo)->err->msg_parm.i[0] = (p1), \
240 (*(cinfo)->err->error_exit) ((j_common_ptr)(cinfo)))
241#define ERREXIT2(cinfo, code, p1, p2) \
242 ((cinfo)->err->msg_code = (code), \
243 (cinfo)->err->msg_parm.i[0] = (p1), \
244 (cinfo)->err->msg_parm.i[1] = (p2), \
245 (*(cinfo)->err->error_exit) ((j_common_ptr)(cinfo)))
246#define ERREXIT3(cinfo, code, p1, p2, p3) \
247 ((cinfo)->err->msg_code = (code), \
248 (cinfo)->err->msg_parm.i[0] = (p1), \
249 (cinfo)->err->msg_parm.i[1] = (p2), \
250 (cinfo)->err->msg_parm.i[2] = (p3), \
251 (*(cinfo)->err->error_exit) ((j_common_ptr)(cinfo)))
252#define ERREXIT4(cinfo, code, p1, p2, p3, p4) \
253 ((cinfo)->err->msg_code = (code), \
254 (cinfo)->err->msg_parm.i[0] = (p1), \
255 (cinfo)->err->msg_parm.i[1] = (p2), \
256 (cinfo)->err->msg_parm.i[2] = (p3), \
257 (cinfo)->err->msg_parm.i[3] = (p4), \
258 (*(cinfo)->err->error_exit) ((j_common_ptr)(cinfo)))
259#define ERREXIT6(cinfo, code, p1, p2, p3, p4, p5, p6) \
260 ((cinfo)->err->msg_code = (code), \
261 (cinfo)->err->msg_parm.i[0] = (p1), \
262 (cinfo)->err->msg_parm.i[1] = (p2), \
263 (cinfo)->err->msg_parm.i[2] = (p3), \
264 (cinfo)->err->msg_parm.i[3] = (p4), \
265 (cinfo)->err->msg_parm.i[4] = (p5), \
266 (cinfo)->err->msg_parm.i[5] = (p6), \
267 (*(cinfo)->err->error_exit) ((j_common_ptr)(cinfo)))
268#define ERREXITS(cinfo, code, str) \
269 ((cinfo)->err->msg_code = (code), \
270 strncpy((cinfo)->err->msg_parm.s, (str), JMSG_STR_PARM_MAX), \
271 (*(cinfo)->err->error_exit) ((j_common_ptr)(cinfo)))
272
273#define MAKESTMT(stuff) do { stuff } while (0)
274
275/* Nonfatal errors (we can keep going, but the data is probably corrupt) */
276#define WARNMS(cinfo, code) \
277 ((cinfo)->err->msg_code = (code), \
278 (*(cinfo)->err->emit_message) ((j_common_ptr)(cinfo), -1))
279#define WARNMS1(cinfo, code, p1) \
280 ((cinfo)->err->msg_code = (code), \
281 (cinfo)->err->msg_parm.i[0] = (p1), \
282 (*(cinfo)->err->emit_message) ((j_common_ptr)(cinfo), -1))
283#define WARNMS2(cinfo, code, p1, p2) \
284 ((cinfo)->err->msg_code = (code), \
285 (cinfo)->err->msg_parm.i[0] = (p1), \
286 (cinfo)->err->msg_parm.i[1] = (p2), \
287 (*(cinfo)->err->emit_message) ((j_common_ptr)(cinfo), -1))
288
289/* Informational/debugging messages */
290#define TRACEMS(cinfo, lvl, code) \
291 ((cinfo)->err->msg_code = (code), \
292 (*(cinfo)->err->emit_message) ((j_common_ptr)(cinfo), (lvl)))
293#define TRACEMS1(cinfo, lvl, code, p1) \
294 ((cinfo)->err->msg_code = (code), \
295 (cinfo)->err->msg_parm.i[0] = (p1), \
296 (*(cinfo)->err->emit_message) ((j_common_ptr)(cinfo), (lvl)))
297#define TRACEMS2(cinfo, lvl, code, p1, p2) \
298 ((cinfo)->err->msg_code = (code), \
299 (cinfo)->err->msg_parm.i[0] = (p1), \
300 (cinfo)->err->msg_parm.i[1] = (p2), \
301 (*(cinfo)->err->emit_message) ((j_common_ptr)(cinfo), (lvl)))
302#define TRACEMS3(cinfo, lvl, code, p1, p2, p3) \
303 MAKESTMT(int *_mp = (cinfo)->err->msg_parm.i; \
304 _mp[0] = (p1); _mp[1] = (p2); _mp[2] = (p3); \
305 (cinfo)->err->msg_code = (code); \
306 (*(cinfo)->err->emit_message) ((j_common_ptr)(cinfo), (lvl)); )
307#define TRACEMS4(cinfo, lvl, code, p1, p2, p3, p4) \
308 MAKESTMT(int *_mp = (cinfo)->err->msg_parm.i; \
309 _mp[0] = (p1); _mp[1] = (p2); _mp[2] = (p3); _mp[3] = (p4); \
310 (cinfo)->err->msg_code = (code); \
311 (*(cinfo)->err->emit_message) ((j_common_ptr)(cinfo), (lvl)); )
312#define TRACEMS5(cinfo, lvl, code, p1, p2, p3, p4, p5) \
313 MAKESTMT(int *_mp = (cinfo)->err->msg_parm.i; \
314 _mp[0] = (p1); _mp[1] = (p2); _mp[2] = (p3); _mp[3] = (p4); \
315 _mp[4] = (p5); \
316 (cinfo)->err->msg_code = (code); \
317 (*(cinfo)->err->emit_message) ((j_common_ptr)(cinfo), (lvl)); )
318#define TRACEMS8(cinfo, lvl, code, p1, p2, p3, p4, p5, p6, p7, p8) \
319 MAKESTMT(int *_mp = (cinfo)->err->msg_parm.i; \
320 _mp[0] = (p1); _mp[1] = (p2); _mp[2] = (p3); _mp[3] = (p4); \
321 _mp[4] = (p5); _mp[5] = (p6); _mp[6] = (p7); _mp[7] = (p8); \
322 (cinfo)->err->msg_code = (code); \
323 (*(cinfo)->err->emit_message) ((j_common_ptr)(cinfo), (lvl)); )
324#define TRACEMSS(cinfo, lvl, code, str) \
325 ((cinfo)->err->msg_code = (code), \
326 strncpy((cinfo)->err->msg_parm.s, (str), JMSG_STR_PARM_MAX), \
327 (*(cinfo)->err->emit_message) ((j_common_ptr)(cinfo), (lvl)))
328
329#endif /* JERROR_H */
330

source code of include/jerror.h