cde/lib/DtHelp/jpeg/jerror.h

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