jerror.h 14 KB

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