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