bsp
jerror.h
00001 /*
00002  * jerror.h
00003  *
00004  * Copyright (C) 1994-1995, Thomas G. Lane.
00005  * This file is part of the Independent JPEG Group's software.
00006  * For conditions of distribution and use, see the accompanying README file.
00007  *
00008  * This file defines the error and message codes for the JPEG library.
00009  * Edit this file to add new codes, or to translate the message strings to
00010  * some other language.
00011  * A set of error-reporting macros are defined too.  Some applications using
00012  * the JPEG library may wish to include this file to get the error codes
00013  * and/or the macros.
00014  */
00015 
00016 /*
00017  * To define the enum list of message codes, include this file without
00018  * defining macro JMESSAGE.  To create a message string table, include it
00019  * again with a suitable JMESSAGE definition (see jerror.c for an example).
00020  */
00021 #ifndef JMESSAGE
00022 #ifndef JERROR_H
00023 /* First time through, define the enum list */
00024 #define JMAKE_ENUM_LIST
00025 #else
00026 /* Repeated inclusions of this file are no-ops unless JMESSAGE is defined */
00027 #define JMESSAGE(code,string)
00028 #endif /* JERROR_H */
00029 #endif /* JMESSAGE */
00030 
00031 #ifdef JMAKE_ENUM_LIST
00032 
00033 typedef enum
00034 {
00035 
00036 #define JMESSAGE(code,string)   code ,
00037 
00038 #endif /* JMAKE_ENUM_LIST */
00039 
00040     JMESSAGE(JMSG_NOMESSAGE, "Bogus message code %d") /* Must be first entry! */
00041 
00042     /* For maintenance convenience, list is alphabetical by message code name */
00043     JMESSAGE(JERR_ARITH_NOTIMPL,
00044              "Sorry, there are legal restrictions on arithmetic coding")
00045     JMESSAGE(JERR_BAD_ALIGN_TYPE, "ALIGN_TYPE is wrong, please fix")
00046     JMESSAGE(JERR_BAD_ALLOC_CHUNK, "MAX_ALLOC_CHUNK is wrong, please fix")
00047     JMESSAGE(JERR_BAD_BUFFER_MODE, "Bogus buffer control mode")
00048     JMESSAGE(JERR_BAD_COMPONENT_ID, "Invalid component ID %d in SOS")
00049     JMESSAGE(JERR_BAD_DCTSIZE, "IDCT output block size %d not supported")
00050     JMESSAGE(JERR_BAD_IN_COLORSPACE, "Bogus input colorspace")
00051     JMESSAGE(JERR_BAD_J_COLORSPACE, "Bogus JPEG colorspace")
00052     JMESSAGE(JERR_BAD_LENGTH, "Bogus marker length")
00053     JMESSAGE(JERR_BAD_MCU_SIZE, "Sampling factors too large for interleaved scan")
00054     JMESSAGE(JERR_BAD_POOL_ID, "Invalid memory pool code %d")
00055     JMESSAGE(JERR_BAD_PRECISION, "Unsupported JPEG data precision %d")
00056     JMESSAGE(JERR_BAD_PROGRESSION,
00057              "Invalid progressive parameters Ss=%d Se=%d Ah=%d Al=%d")
00058     JMESSAGE(JERR_BAD_PROG_SCRIPT,
00059              "Invalid progressive parameters at scan script entry %d")
00060     JMESSAGE(JERR_BAD_SAMPLING, "Bogus sampling factors")
00061     JMESSAGE(JERR_BAD_SCAN_SCRIPT, "Invalid scan script at entry %d")
00062     JMESSAGE(JERR_BAD_STATE, "Improper call to JPEG library in state %d")
00063     JMESSAGE(JERR_BAD_VIRTUAL_ACCESS, "Bogus virtual array access")
00064     JMESSAGE(JERR_BUFFER_SIZE, "Buffer passed to JPEG library is too small")
00065     JMESSAGE(JERR_CANT_SUSPEND, "Suspension not allowed here")
00066     JMESSAGE(JERR_CCIR601_NOTIMPL, "CCIR601 sampling not implemented yet")
00067     JMESSAGE(JERR_COMPONENT_COUNT, "Too many color components: %d, max %d")
00068     JMESSAGE(JERR_CONVERSION_NOTIMPL, "Unsupported color conversion request")
00069     JMESSAGE(JERR_DAC_INDEX, "Bogus DAC index %d")
00070     JMESSAGE(JERR_DAC_VALUE, "Bogus DAC value 0x%x")
00071     JMESSAGE(JERR_DHT_COUNTS, "Bogus DHT counts")
00072     JMESSAGE(JERR_DHT_INDEX, "Bogus DHT index %d")
00073     JMESSAGE(JERR_DQT_INDEX, "Bogus DQT index %d")
00074     JMESSAGE(JERR_EMPTY_IMAGE, "Empty JPEG image (DNL not supported)")
00075     JMESSAGE(JERR_EMS_READ, "Read from EMS failed")
00076     JMESSAGE(JERR_EMS_WRITE, "Write to EMS failed")
00077     JMESSAGE(JERR_EOI_EXPECTED, "Didn't expect more than one scan")
00078     JMESSAGE(JERR_FILE_READ, "Input file read error")
00079     JMESSAGE(JERR_FILE_WRITE, "Output file write error --- out of disk space?")
00080     JMESSAGE(JERR_FRACT_SAMPLE_NOTIMPL, "Fractional sampling not implemented yet")
00081     JMESSAGE(JERR_HUFF_CLEN_OVERFLOW, "Huffman code size table overflow")
00082     JMESSAGE(JERR_HUFF_MISSING_CODE, "Missing Huffman code table entry")
00083     JMESSAGE(JERR_IMAGE_TOO_BIG, "Maximum supported image dimension is %u pixels")
00084     JMESSAGE(JERR_INPUT_EMPTY, "Empty input file")
00085     JMESSAGE(JERR_INPUT_EOF, "Premature end of input file")
00086     JMESSAGE(JERR_MISMATCHED_QUANT_TABLE,
00087              "Cannot transcode due to multiple use of quantization table %d")
00088     JMESSAGE(JERR_MISSING_DATA, "Scan script does not transmit all data")
00089     JMESSAGE(JERR_MODE_CHANGE, "Invalid color quantization mode change")
00090     JMESSAGE(JERR_NOTIMPL, "Not implemented yet")
00091     JMESSAGE(JERR_NOT_COMPILED, "Requested feature was omitted at compile time")
00092     JMESSAGE(JERR_NO_BACKING_STORE, "Backing store not supported")
00093     JMESSAGE(JERR_NO_HUFF_TABLE, "Huffman table 0x%02x was not defined")
00094     JMESSAGE(JERR_NO_IMAGE, "JPEG datastream contains no image")
00095     JMESSAGE(JERR_NO_QUANT_TABLE, "Quantization table 0x%02x was not defined")
00096     JMESSAGE(JERR_NO_SOI, "Not a JPEG file: starts with 0x%02x 0x%02x")
00097     JMESSAGE(JERR_OUT_OF_MEMORY, "Insufficient memory (case %d)")
00098     JMESSAGE(JERR_QUANT_COMPONENTS,
00099              "Cannot quantize more than %d color components")
00100     JMESSAGE(JERR_QUANT_FEW_COLORS, "Cannot quantize to fewer than %d colors")
00101     JMESSAGE(JERR_QUANT_MANY_COLORS, "Cannot quantize to more than %d colors")
00102     JMESSAGE(JERR_SOF_DUPLICATE, "Invalid JPEG file structure: two SOF markers")
00103     JMESSAGE(JERR_SOF_NO_SOS, "Invalid JPEG file structure: missing SOS marker")
00104     JMESSAGE(JERR_SOF_UNSUPPORTED, "Unsupported JPEG process: SOF type 0x%02x")
00105     JMESSAGE(JERR_SOI_DUPLICATE, "Invalid JPEG file structure: two SOI markers")
00106     JMESSAGE(JERR_SOS_NO_SOF, "Invalid JPEG file structure: SOS before SOF")
00107     JMESSAGE(JERR_TFILE_CREATE, "Failed to create temporary file %s")
00108     JMESSAGE(JERR_TFILE_READ, "Read failed on temporary file")
00109     JMESSAGE(JERR_TFILE_SEEK, "Seek failed on temporary file")
00110     JMESSAGE(JERR_TFILE_WRITE,
00111              "Write failed on temporary file --- out of disk space?")
00112     JMESSAGE(JERR_TOO_LITTLE_DATA, "Application transferred too few scanlines")
00113     JMESSAGE(JERR_UNKNOWN_MARKER, "Unsupported marker type 0x%02x")
00114     JMESSAGE(JERR_VIRTUAL_BUG, "Virtual array controller messed up")
00115     JMESSAGE(JERR_WIDTH_OVERFLOW, "Image too wide for this implementation")
00116     JMESSAGE(JERR_XMS_READ, "Read from XMS failed")
00117     JMESSAGE(JERR_XMS_WRITE, "Write to XMS failed")
00118     JMESSAGE(JMSG_COPYRIGHT, JCOPYRIGHT)
00119     JMESSAGE(JMSG_VERSION, JVERSION)
00120     JMESSAGE(JTRC_16BIT_TABLES,
00121              "Caution: quantization tables are too coarse for baseline JPEG")
00122     JMESSAGE(JTRC_ADOBE,
00123              "Adobe APP14 marker: version %d, flags 0x%04x 0x%04x, transform %d")
00124     JMESSAGE(JTRC_APP0, "Unknown APP0 marker (not JFIF), length %u")
00125     JMESSAGE(JTRC_APP14, "Unknown APP14 marker (not Adobe), length %u")
00126     JMESSAGE(JTRC_DAC, "Define Arithmetic Table 0x%02x: 0x%02x")
00127     JMESSAGE(JTRC_DHT, "Define Huffman Table 0x%02x")
00128     JMESSAGE(JTRC_DQT, "Define Quantization Table %d  precision %d")
00129     JMESSAGE(JTRC_DRI, "Define Restart Interval %u")
00130     JMESSAGE(JTRC_EMS_CLOSE, "Freed EMS handle %u")
00131     JMESSAGE(JTRC_EMS_OPEN, "Obtained EMS handle %u")
00132     JMESSAGE(JTRC_EOI, "End Of Image")
00133     JMESSAGE(JTRC_HUFFBITS, "        %3d %3d %3d %3d %3d %3d %3d %3d")
00134     JMESSAGE(JTRC_JFIF, "JFIF APP0 marker, density %dx%d  %d")
00135     JMESSAGE(JTRC_JFIF_BADTHUMBNAILSIZE,
00136              "Warning: thumbnail image size does not match data length %u")
00137     JMESSAGE(JTRC_JFIF_MINOR, "Unknown JFIF minor revision number %d.%02d")
00138     JMESSAGE(JTRC_JFIF_THUMBNAIL, "    with %d x %d thumbnail image")
00139     JMESSAGE(JTRC_MISC_MARKER, "Skipping marker 0x%02x, length %u")
00140     JMESSAGE(JTRC_PARMLESS_MARKER, "Unexpected marker 0x%02x")
00141     JMESSAGE(JTRC_QUANTVALS, "        %4u %4u %4u %4u %4u %4u %4u %4u")
00142     JMESSAGE(JTRC_QUANT_3_NCOLORS, "Quantizing to %d = %d*%d*%d colors")
00143     JMESSAGE(JTRC_QUANT_NCOLORS, "Quantizing to %d colors")
00144     JMESSAGE(JTRC_QUANT_SELECTED, "Selected %d colors for quantization")
00145     JMESSAGE(JTRC_RECOVERY_ACTION, "At marker 0x%02x, recovery action %d")
00146     JMESSAGE(JTRC_RST, "RST%d")
00147     JMESSAGE(JTRC_SMOOTH_NOTIMPL,
00148              "Smoothing not supported with nonstandard sampling ratios")
00149     JMESSAGE(JTRC_SOF, "Start Of Frame 0x%02x: width=%u, height=%u, components=%d")
00150     JMESSAGE(JTRC_SOF_COMPONENT, "    Component %d: %dhx%dv q=%d")
00151     JMESSAGE(JTRC_SOI, "Start of Image")
00152     JMESSAGE(JTRC_SOS, "Start Of Scan: %d components")
00153     JMESSAGE(JTRC_SOS_COMPONENT, "    Component %d: dc=%d ac=%d")
00154     JMESSAGE(JTRC_SOS_PARAMS, "  Ss=%d, Se=%d, Ah=%d, Al=%d")
00155     JMESSAGE(JTRC_TFILE_CLOSE, "Closed temporary file %s")
00156     JMESSAGE(JTRC_TFILE_OPEN, "Opened temporary file %s")
00157     JMESSAGE(JTRC_UNKNOWN_IDS,
00158              "Unrecognized component IDs %d %d %d, assuming YCbCr")
00159     JMESSAGE(JTRC_XMS_CLOSE, "Freed XMS handle %u")
00160     JMESSAGE(JTRC_XMS_OPEN, "Obtained XMS handle %u")
00161     JMESSAGE(JWRN_ADOBE_XFORM, "Unknown Adobe color transform code %d")
00162     JMESSAGE(JWRN_BOGUS_PROGRESSION,
00163              "Inconsistent progression sequence for component %d coefficient %d")
00164     JMESSAGE(JWRN_EXTRANEOUS_DATA,
00165              "Corrupt JPEG data: %u extraneous bytes before marker 0x%02x")
00166     JMESSAGE(JWRN_HIT_MARKER, "Corrupt JPEG data: premature end of data segment")
00167     JMESSAGE(JWRN_HUFF_BAD_CODE, "Corrupt JPEG data: bad Huffman code")
00168     JMESSAGE(JWRN_JFIF_MAJOR, "Warning: unknown JFIF revision number %d.%02d")
00169     JMESSAGE(JWRN_JPEG_EOF, "Premature end of JPEG file")
00170     JMESSAGE(JWRN_MUST_RESYNC,
00171              "Corrupt JPEG data: found marker 0x%02x instead of RST%d")
00172     JMESSAGE(JWRN_NOT_SEQUENTIAL, "Invalid SOS parameters for sequential JPEG")
00173     JMESSAGE(JWRN_TOO_MUCH_DATA, "Application transferred too many scanlines")
00174 
00175 #ifdef JMAKE_ENUM_LIST
00176 
00177     JMSG_LASTMSGCODE
00178 } J_MESSAGE_CODE;
00179 
00180 #undef JMAKE_ENUM_LIST
00181 #endif /* JMAKE_ENUM_LIST */
00182 
00183 /* Zap JMESSAGE macro so that future re-inclusions do nothing by default */
00184 #undef JMESSAGE
00185 
00186 
00187 #ifndef JERROR_H
00188 #define JERROR_H
00189 
00190 /* Macros to simplify using the error and trace message stuff */
00191 /* The first parameter is either type of cinfo pointer */
00192 
00193 /* Fatal errors (print message and exit) */
00194 #define ERREXIT(cinfo,code)  \
00195   ((cinfo)->err->msg_code = (code), \
00196    (*(cinfo)->err->error_exit) ((j_common_ptr) (cinfo)))
00197 #define ERREXIT1(cinfo,code,p1)  \
00198   ((cinfo)->err->msg_code = (code), \
00199    (cinfo)->err->msg_parm.i[0] = (p1), \
00200    (*(cinfo)->err->error_exit) ((j_common_ptr) (cinfo)))
00201 #define ERREXIT2(cinfo,code,p1,p2)  \
00202   ((cinfo)->err->msg_code = (code), \
00203    (cinfo)->err->msg_parm.i[0] = (p1), \
00204    (cinfo)->err->msg_parm.i[1] = (p2), \
00205    (*(cinfo)->err->error_exit) ((j_common_ptr) (cinfo)))
00206 #define ERREXIT3(cinfo,code,p1,p2,p3)  \
00207   ((cinfo)->err->msg_code = (code), \
00208    (cinfo)->err->msg_parm.i[0] = (p1), \
00209    (cinfo)->err->msg_parm.i[1] = (p2), \
00210    (cinfo)->err->msg_parm.i[2] = (p3), \
00211    (*(cinfo)->err->error_exit) ((j_common_ptr) (cinfo)))
00212 #define ERREXIT4(cinfo,code,p1,p2,p3,p4)  \
00213   ((cinfo)->err->msg_code = (code), \
00214    (cinfo)->err->msg_parm.i[0] = (p1), \
00215    (cinfo)->err->msg_parm.i[1] = (p2), \
00216    (cinfo)->err->msg_parm.i[2] = (p3), \
00217    (cinfo)->err->msg_parm.i[3] = (p4), \
00218    (*(cinfo)->err->error_exit) ((j_common_ptr) (cinfo)))
00219 #define ERREXITS(cinfo,code,str)  \
00220   ((cinfo)->err->msg_code = (code), \
00221    strncpy((cinfo)->err->msg_parm.s, (str), JMSG_STR_PARM_MAX), \
00222    (*(cinfo)->err->error_exit) ((j_common_ptr) (cinfo)))
00223 
00224 #define MAKESTMT(stuff)         do { stuff } while (0)
00225 
00226 /* Nonfatal errors (we can keep going, but the data is probably corrupt) */
00227 #define WARNMS(cinfo,code)  \
00228   ((cinfo)->err->msg_code = (code), \
00229    (*(cinfo)->err->emit_message) ((j_common_ptr) (cinfo), -1))
00230 #define WARNMS1(cinfo,code,p1)  \
00231   ((cinfo)->err->msg_code = (code), \
00232    (cinfo)->err->msg_parm.i[0] = (p1), \
00233    (*(cinfo)->err->emit_message) ((j_common_ptr) (cinfo), -1))
00234 #define WARNMS2(cinfo,code,p1,p2)  \
00235   ((cinfo)->err->msg_code = (code), \
00236    (cinfo)->err->msg_parm.i[0] = (p1), \
00237    (cinfo)->err->msg_parm.i[1] = (p2), \
00238    (*(cinfo)->err->emit_message) ((j_common_ptr) (cinfo), -1))
00239 
00240 /* Informational/debugging messages */
00241 #define TRACEMS(cinfo,lvl,code)  \
00242   ((cinfo)->err->msg_code = (code), \
00243    (*(cinfo)->err->emit_message) ((j_common_ptr) (cinfo), (lvl)))
00244 #define TRACEMS1(cinfo,lvl,code,p1)  \
00245   ((cinfo)->err->msg_code = (code), \
00246    (cinfo)->err->msg_parm.i[0] = (p1), \
00247    (*(cinfo)->err->emit_message) ((j_common_ptr) (cinfo), (lvl)))
00248 #define TRACEMS2(cinfo,lvl,code,p1,p2)  \
00249   ((cinfo)->err->msg_code = (code), \
00250    (cinfo)->err->msg_parm.i[0] = (p1), \
00251    (cinfo)->err->msg_parm.i[1] = (p2), \
00252    (*(cinfo)->err->emit_message) ((j_common_ptr) (cinfo), (lvl)))
00253 #define TRACEMS3(cinfo,lvl,code,p1,p2,p3)  \
00254   MAKESTMT(int * _mp = (cinfo)->err->msg_parm.i; \
00255            _mp[0] = (p1); _mp[1] = (p2); _mp[2] = (p3); \
00256            (cinfo)->err->msg_code = (code); \
00257            (*(cinfo)->err->emit_message) ((j_common_ptr) (cinfo), (lvl)); )
00258 #define TRACEMS4(cinfo,lvl,code,p1,p2,p3,p4)  \
00259   MAKESTMT(int * _mp = (cinfo)->err->msg_parm.i; \
00260            _mp[0] = (p1); _mp[1] = (p2); _mp[2] = (p3); _mp[3] = (p4); \
00261            (cinfo)->err->msg_code = (code); \
00262            (*(cinfo)->err->emit_message) ((j_common_ptr) (cinfo), (lvl)); )
00263 #define TRACEMS8(cinfo,lvl,code,p1,p2,p3,p4,p5,p6,p7,p8)  \
00264   MAKESTMT(int * _mp = (cinfo)->err->msg_parm.i; \
00265            _mp[0] = (p1); _mp[1] = (p2); _mp[2] = (p3); _mp[3] = (p4); \
00266            _mp[4] = (p5); _mp[5] = (p6); _mp[6] = (p7); _mp[7] = (p8); \
00267            (cinfo)->err->msg_code = (code); \
00268            (*(cinfo)->err->emit_message) ((j_common_ptr) (cinfo), (lvl)); )
00269 #define TRACEMSS(cinfo,lvl,code,str)  \
00270   ((cinfo)->err->msg_code = (code), \
00271    strncpy((cinfo)->err->msg_parm.s, (str), JMSG_STR_PARM_MAX), \
00272    (*(cinfo)->err->emit_message) ((j_common_ptr) (cinfo), (lvl)))
00273 
00274 #endif /* JERROR_H */
 All Classes Functions