Quake-III-Arena

Quake III Arena GPL Source Release
Log | Files | Refs

jpeglib.h (44448B)


      1 /*
      2  * jpeglib.h
      3  *
      4  * Copyright (C) 1991-1995, Thomas G. Lane.
      5  * This file is part of the Independent JPEG Group's software.
      6  * For conditions of distribution and use, see the accompanying README file.
      7  *
      8  * This file defines the application interface for the JPEG library.
      9  * Most applications using the library need only include this file,
     10  * and perhaps jerror.h if they want to know the exact error codes.
     11  */
     12 
     13 #ifndef JPEGLIB_H
     14 #define JPEGLIB_H
     15 
     16 #ifdef __cplusplus
     17 extern "C"
     18 {
     19 #endif
     20 
     21 
     22 
     23 #ifdef __MACOS__
     24 
     25 // JDC: stuff to make mac version compile
     26 #define	boolean	qboolean
     27 #define	register
     28 #define	INT32	int
     29 
     30 #endif
     31 
     32 // rad additions
     33 // 11.29.99
     34 
     35 //#include "cmdlib.h"
     36 #ifdef _WIN32
     37 #include "windows.h"
     38 #include "stdio.h"
     39 #endif
     40 
     41 #ifndef INT32
     42 #define	INT32	int
     43 #endif
     44 
     45 extern void LoadJPGBuff(unsigned char *fbuffer, unsigned char **pic, int *width, int *height );
     46 // rad end
     47 
     48 
     49 /*
     50  * First we include the configuration files that record how this
     51  * installation of the JPEG library is set up.  jconfig.h can be
     52  * generated automatically for many systems.  jmorecfg.h contains
     53  * manual configuration options that most people need not worry about.
     54  */
     55 
     56 #ifndef JCONFIG_INCLUDED	/* in case jinclude.h already did */
     57 #include "jpeg6/jconfig.h"		/* widely used configuration options */
     58 #endif
     59 #include "jpeg6/jmorecfg.h"		/* seldom changed options */
     60 
     61 
     62 /* Version ID for the JPEG library.
     63  * Might be useful for tests like "#if JPEG_LIB_VERSION >= 60".
     64  */
     65 
     66 #define JPEG_LIB_VERSION  60	/* Version 6 */
     67 
     68 
     69 /* Various constants determining the sizes of things.
     70  * All of these are specified by the JPEG standard, so don't change them
     71  * if you want to be compatible.
     72  */
     73 
     74 #define DCTSIZE		    8	/* The basic DCT block is 8x8 samples */
     75 #define DCTSIZE2	    64	/* DCTSIZE squared; # of elements in a block */
     76 #define NUM_QUANT_TBLS      4	/* Quantization tables are numbered 0..3 */
     77 #define NUM_HUFF_TBLS       4	/* Huffman tables are numbered 0..3 */
     78 #define NUM_ARITH_TBLS      16	/* Arith-coding tables are numbered 0..15 */
     79 #define MAX_COMPS_IN_SCAN   4	/* JPEG limit on # of components in one scan */
     80 #define MAX_SAMP_FACTOR     4	/* JPEG limit on sampling factors */
     81 /* Unfortunately, some bozo at Adobe saw no reason to be bound by the standard;
     82  * the PostScript DCT filter can emit files with many more than 10 blocks/MCU.
     83  * If you happen to run across such a file, you can up D_MAX_BLOCKS_IN_MCU
     84  * to handle it.  We even let you do this from the jconfig.h file.  However,
     85  * we strongly discourage changing C_MAX_BLOCKS_IN_MCU; just because Adobe
     86  * sometimes emits noncompliant files doesn't mean you should too.
     87  */
     88 #define C_MAX_BLOCKS_IN_MCU   10 /* compressor's limit on blocks per MCU */
     89 #ifndef D_MAX_BLOCKS_IN_MCU
     90 #define D_MAX_BLOCKS_IN_MCU   10 /* decompressor's limit on blocks per MCU */
     91 #endif
     92 
     93 
     94 /* This macro is used to declare a "method", that is, a function pointer.
     95  * We want to supply prototype parameters if the compiler can cope.
     96  * Note that the arglist parameter must be parenthesized!
     97  */
     98 
     99 #ifdef HAVE_PROTOTYPES
    100 #define JMETHOD(type,methodname,arglist)  type (*methodname) arglist
    101 #else
    102 #define JMETHOD(type,methodname,arglist)  type (*methodname) ()
    103 #endif
    104 
    105 
    106 /* Data structures for images (arrays of samples and of DCT coefficients).
    107  * On 80x86 machines, the image arrays are too big for near pointers,
    108  * but the pointer arrays can fit in near memory.
    109  */
    110 
    111 typedef JSAMPLE FAR *JSAMPROW;	/* ptr to one image row of pixel samples. */
    112 typedef JSAMPROW *JSAMPARRAY;	/* ptr to some rows (a 2-D sample array) */
    113 typedef JSAMPARRAY *JSAMPIMAGE;	/* a 3-D sample array: top index is color */
    114 
    115 typedef JCOEF JBLOCK[DCTSIZE2];	/* one block of coefficients */
    116 typedef JBLOCK FAR *JBLOCKROW;	/* pointer to one row of coefficient blocks */
    117 typedef JBLOCKROW *JBLOCKARRAY;		/* a 2-D array of coefficient blocks */
    118 typedef JBLOCKARRAY *JBLOCKIMAGE;	/* a 3-D array of coefficient blocks */
    119 
    120 typedef JCOEF FAR *JCOEFPTR;	/* useful in a couple of places */
    121 
    122 
    123 /* Types for JPEG compression parameters and working tables. */
    124 
    125 
    126 /* DCT coefficient quantization tables. */
    127 
    128 typedef struct {
    129   /* This field directly represents the contents of a JPEG DQT marker.
    130    * Note: the values are always given in zigzag order.
    131    */
    132   UINT16 quantval[DCTSIZE2];	/* quantization step for each coefficient */
    133   /* This field is used only during compression.  It's initialized FALSE when
    134    * the table is created, and set TRUE when it's been output to the file.
    135    * You could suppress output of a table by setting this to TRUE.
    136    * (See jpeg_suppress_tables for an example.)
    137    */
    138   boolean sent_table;		/* TRUE when table has been output */
    139 } JQUANT_TBL;
    140 
    141 
    142 /* Huffman coding tables. */
    143 
    144 typedef struct {
    145   /* These two fields directly represent the contents of a JPEG DHT marker */
    146   UINT8 bits[17];		/* bits[k] = # of symbols with codes of */
    147 				/* length k bits; bits[0] is unused */
    148   UINT8 huffval[256];		/* The symbols, in order of incr code length */
    149   /* This field is used only during compression.  It's initialized FALSE when
    150    * the table is created, and set TRUE when it's been output to the file.
    151    * You could suppress output of a table by setting this to TRUE.
    152    * (See jpeg_suppress_tables for an example.)
    153    */
    154   boolean sent_table;		/* TRUE when table has been output */
    155 } JHUFF_TBL;
    156 
    157 
    158 /* Basic info about one component (color channel). */
    159 
    160 typedef struct {
    161   /* These values are fixed over the whole image. */
    162   /* For compression, they must be supplied by parameter setup; */
    163   /* for decompression, they are read from the SOF marker. */
    164   int component_id;		/* identifier for this component (0..255) */
    165   int component_index;		/* its index in SOF or cinfo->comp_info[] */
    166   int h_samp_factor;		/* horizontal sampling factor (1..4) */
    167   int v_samp_factor;		/* vertical sampling factor (1..4) */
    168   int quant_tbl_no;		/* quantization table selector (0..3) */
    169   /* These values may vary between scans. */
    170   /* For compression, they must be supplied by parameter setup; */
    171   /* for decompression, they are read from the SOS marker. */
    172   /* The decompressor output side may not use these variables. */
    173   int dc_tbl_no;		/* DC entropy table selector (0..3) */
    174   int ac_tbl_no;		/* AC entropy table selector (0..3) */
    175   
    176   /* Remaining fields should be treated as private by applications. */
    177   
    178   /* These values are computed during compression or decompression startup: */
    179   /* Component's size in DCT blocks.
    180    * Any dummy blocks added to complete an MCU are not counted; therefore
    181    * these values do not depend on whether a scan is interleaved or not.
    182    */
    183   JDIMENSION width_in_blocks;
    184   JDIMENSION height_in_blocks;
    185   /* Size of a DCT block in samples.  Always DCTSIZE for compression.
    186    * For decompression this is the size of the output from one DCT block,
    187    * reflecting any scaling we choose to apply during the IDCT step.
    188    * Values of 1,2,4,8 are likely to be supported.  Note that different
    189    * components may receive different IDCT scalings.
    190    */
    191   int DCT_scaled_size;
    192   /* The downsampled dimensions are the component's actual, unpadded number
    193    * of samples at the main buffer (preprocessing/compression interface), thus
    194    * downsampled_width = ceil(image_width * Hi/Hmax)
    195    * and similarly for height.  For decompression, IDCT scaling is included, so
    196    * downsampled_width = ceil(image_width * Hi/Hmax * DCT_scaled_size/DCTSIZE)
    197    */
    198   JDIMENSION downsampled_width;	 /* actual width in samples */
    199   JDIMENSION downsampled_height; /* actual height in samples */
    200   /* This flag is used only for decompression.  In cases where some of the
    201    * components will be ignored (eg grayscale output from YCbCr image),
    202    * we can skip most computations for the unused components.
    203    */
    204   boolean component_needed;	/* do we need the value of this component? */
    205 
    206   /* These values are computed before starting a scan of the component. */
    207   /* The decompressor output side may not use these variables. */
    208   int MCU_width;		/* number of blocks per MCU, horizontally */
    209   int MCU_height;		/* number of blocks per MCU, vertically */
    210   int MCU_blocks;		/* MCU_width * MCU_height */
    211   int MCU_sample_width;		/* MCU width in samples, MCU_width*DCT_scaled_size */
    212   int last_col_width;		/* # of non-dummy blocks across in last MCU */
    213   int last_row_height;		/* # of non-dummy blocks down in last MCU */
    214 
    215   /* Saved quantization table for component; NULL if none yet saved.
    216    * See jdinput.c comments about the need for this information.
    217    * This field is not currently used by the compressor.
    218    */
    219   JQUANT_TBL * quant_table;
    220 
    221   /* Private per-component storage for DCT or IDCT subsystem. */
    222   void * dct_table;
    223 } jpeg_component_info;
    224 
    225 
    226 /* The script for encoding a multiple-scan file is an array of these: */
    227 
    228 typedef struct {
    229   int comps_in_scan;		/* number of components encoded in this scan */
    230   int component_index[MAX_COMPS_IN_SCAN]; /* their SOF/comp_info[] indexes */
    231   int Ss, Se;			/* progressive JPEG spectral selection parms */
    232   int Ah, Al;			/* progressive JPEG successive approx. parms */
    233 } jpeg_scan_info;
    234 
    235 
    236 /* Known color spaces. */
    237 
    238 typedef enum {
    239 	JCS_UNKNOWN,		/* error/unspecified */
    240 	JCS_GRAYSCALE,		/* monochrome */
    241 	JCS_RGB,		/* red/green/blue */
    242 	JCS_YCbCr,		/* Y/Cb/Cr (also known as YUV) */
    243 	JCS_CMYK,		/* C/M/Y/K */
    244 	JCS_YCCK		/* Y/Cb/Cr/K */
    245 } J_COLOR_SPACE;
    246 
    247 /* DCT/IDCT algorithm options. */
    248 
    249 typedef enum {
    250 	JDCT_ISLOW,		/* slow but accurate integer algorithm */
    251 	JDCT_IFAST,		/* faster, less accurate integer method */
    252 	JDCT_FLOAT		/* floating-point: accurate, fast on fast HW */
    253 } J_DCT_METHOD;
    254 
    255 #ifndef JDCT_DEFAULT		/* may be overridden in jconfig.h */
    256 #define JDCT_DEFAULT  JDCT_ISLOW
    257 #endif
    258 #ifndef JDCT_FASTEST		/* may be overridden in jconfig.h */
    259 #define JDCT_FASTEST  JDCT_IFAST
    260 #endif
    261 
    262 /* Dithering options for decompression. */
    263 
    264 typedef enum {
    265 	JDITHER_NONE,		/* no dithering */
    266 	JDITHER_ORDERED,	/* simple ordered dither */
    267 	JDITHER_FS		/* Floyd-Steinberg error diffusion dither */
    268 } J_DITHER_MODE;
    269 
    270 
    271 /* Common fields between JPEG compression and decompression master structs. */
    272 
    273 #define jpeg_common_fields \
    274   struct jpeg_error_mgr * err;	/* Error handler module */\
    275   struct jpeg_memory_mgr * mem;	/* Memory manager module */\
    276   struct jpeg_progress_mgr * progress; /* Progress monitor, or NULL if none */\
    277   boolean is_decompressor;	/* so common code can tell which is which */\
    278   int global_state		/* for checking call sequence validity */
    279 
    280 /* Routines that are to be used by both halves of the library are declared
    281  * to receive a pointer to this structure.  There are no actual instances of
    282  * jpeg_common_struct, only of jpeg_compress_struct and jpeg_decompress_struct.
    283  */
    284 struct jpeg_common_struct {
    285   jpeg_common_fields;		/* Fields common to both master struct types */
    286   /* Additional fields follow in an actual jpeg_compress_struct or
    287    * jpeg_decompress_struct.  All three structs must agree on these
    288    * initial fields!  (This would be a lot cleaner in C++.)
    289    */
    290 };
    291 
    292 typedef struct jpeg_common_struct * j_common_ptr;
    293 typedef struct jpeg_compress_struct * j_compress_ptr;
    294 typedef struct jpeg_decompress_struct * j_decompress_ptr;
    295 
    296 
    297 /* Master record for a compression instance */
    298 
    299 struct jpeg_compress_struct {
    300   jpeg_common_fields;		/* Fields shared with jpeg_decompress_struct */
    301 
    302   /* Destination for compressed data */
    303   struct jpeg_destination_mgr * dest;
    304 
    305   /* Description of source image --- these fields must be filled in by
    306    * outer application before starting compression.  in_color_space must
    307    * be correct before you can even call jpeg_set_defaults().
    308    */
    309 
    310   JDIMENSION image_width;	/* input image width */
    311   JDIMENSION image_height;	/* input image height */
    312   int input_components;		/* # of color components in input image */
    313   J_COLOR_SPACE in_color_space;	/* colorspace of input image */
    314 
    315   double input_gamma;		/* image gamma of input image */
    316 
    317   /* Compression parameters --- these fields must be set before calling
    318    * jpeg_start_compress().  We recommend calling jpeg_set_defaults() to
    319    * initialize everything to reasonable defaults, then changing anything
    320    * the application specifically wants to change.  That way you won't get
    321    * burnt when new parameters are added.  Also note that there are several
    322    * helper routines to simplify changing parameters.
    323    */
    324 
    325   int data_precision;		/* bits of precision in image data */
    326 
    327   int num_components;		/* # of color components in JPEG image */
    328   J_COLOR_SPACE jpeg_color_space; /* colorspace of JPEG image */
    329 
    330   jpeg_component_info * comp_info;
    331   /* comp_info[i] describes component that appears i'th in SOF */
    332   
    333   JQUANT_TBL * quant_tbl_ptrs[NUM_QUANT_TBLS];
    334   /* ptrs to coefficient quantization tables, or NULL if not defined */
    335   
    336   JHUFF_TBL * dc_huff_tbl_ptrs[NUM_HUFF_TBLS];
    337   JHUFF_TBL * ac_huff_tbl_ptrs[NUM_HUFF_TBLS];
    338   /* ptrs to Huffman coding tables, or NULL if not defined */
    339   
    340   UINT8 arith_dc_L[NUM_ARITH_TBLS]; /* L values for DC arith-coding tables */
    341   UINT8 arith_dc_U[NUM_ARITH_TBLS]; /* U values for DC arith-coding tables */
    342   UINT8 arith_ac_K[NUM_ARITH_TBLS]; /* Kx values for AC arith-coding tables */
    343 
    344   int num_scans;		/* # of entries in scan_info array */
    345   const jpeg_scan_info * scan_info; /* script for multi-scan file, or NULL */
    346   /* The default value of scan_info is NULL, which causes a single-scan
    347    * sequential JPEG file to be emitted.  To create a multi-scan file,
    348    * set num_scans and scan_info to point to an array of scan definitions.
    349    */
    350 
    351   boolean raw_data_in;		/* TRUE=caller supplies downsampled data */
    352   boolean arith_code;		/* TRUE=arithmetic coding, FALSE=Huffman */
    353   boolean optimize_coding;	/* TRUE=optimize entropy encoding parms */
    354   boolean CCIR601_sampling;	/* TRUE=first samples are cosited */
    355   int smoothing_factor;		/* 1..100, or 0 for no input smoothing */
    356   J_DCT_METHOD dct_method;	/* DCT algorithm selector */
    357 
    358   /* The restart interval can be specified in absolute MCUs by setting
    359    * restart_interval, or in MCU rows by setting restart_in_rows
    360    * (in which case the correct restart_interval will be figured
    361    * for each scan).
    362    */
    363   unsigned int restart_interval; /* MCUs per restart, or 0 for no restart */
    364   int restart_in_rows;		/* if > 0, MCU rows per restart interval */
    365 
    366   /* Parameters controlling emission of special markers. */
    367 
    368   boolean write_JFIF_header;	/* should a JFIF marker be written? */
    369   /* These three values are not used by the JPEG code, merely copied */
    370   /* into the JFIF APP0 marker.  density_unit can be 0 for unknown, */
    371   /* 1 for dots/inch, or 2 for dots/cm.  Note that the pixel aspect */
    372   /* ratio is defined by X_density/Y_density even when density_unit=0. */
    373   UINT8 density_unit;		/* JFIF code for pixel size units */
    374   UINT16 X_density;		/* Horizontal pixel density */
    375   UINT16 Y_density;		/* Vertical pixel density */
    376   boolean write_Adobe_marker;	/* should an Adobe marker be written? */
    377   
    378   /* State variable: index of next scanline to be written to
    379    * jpeg_write_scanlines().  Application may use this to control its
    380    * processing loop, e.g., "while (next_scanline < image_height)".
    381    */
    382 
    383   JDIMENSION next_scanline;	/* 0 .. image_height-1  */
    384 
    385   /* Remaining fields are known throughout compressor, but generally
    386    * should not be touched by a surrounding application.
    387    */
    388 
    389   /*
    390    * These fields are computed during compression startup
    391    */
    392   boolean progressive_mode;	/* TRUE if scan script uses progressive mode */
    393   int max_h_samp_factor;	/* largest h_samp_factor */
    394   int max_v_samp_factor;	/* largest v_samp_factor */
    395 
    396   JDIMENSION total_iMCU_rows;	/* # of iMCU rows to be input to coef ctlr */
    397   /* The coefficient controller receives data in units of MCU rows as defined
    398    * for fully interleaved scans (whether the JPEG file is interleaved or not).
    399    * There are v_samp_factor * DCTSIZE sample rows of each component in an
    400    * "iMCU" (interleaved MCU) row.
    401    */
    402   
    403   /*
    404    * These fields are valid during any one scan.
    405    * They describe the components and MCUs actually appearing in the scan.
    406    */
    407   int comps_in_scan;		/* # of JPEG components in this scan */
    408   jpeg_component_info * cur_comp_info[MAX_COMPS_IN_SCAN];
    409   /* *cur_comp_info[i] describes component that appears i'th in SOS */
    410   
    411   JDIMENSION MCUs_per_row;	/* # of MCUs across the image */
    412   JDIMENSION MCU_rows_in_scan;	/* # of MCU rows in the image */
    413   
    414   int blocks_in_MCU;		/* # of DCT blocks per MCU */
    415   int MCU_membership[C_MAX_BLOCKS_IN_MCU];
    416   /* MCU_membership[i] is index in cur_comp_info of component owning */
    417   /* i'th block in an MCU */
    418 
    419   int Ss, Se, Ah, Al;		/* progressive JPEG parameters for scan */
    420 
    421   /*
    422    * Links to compression subobjects (methods and private variables of modules)
    423    */
    424   struct jpeg_comp_master * master;
    425   struct jpeg_c_main_controller * main;
    426   struct jpeg_c_prep_controller * prep;
    427   struct jpeg_c_coef_controller * coef;
    428   struct jpeg_marker_writer * marker;
    429   struct jpeg_color_converter * cconvert;
    430   struct jpeg_downsampler * downsample;
    431   struct jpeg_forward_dct * fdct;
    432   struct jpeg_entropy_encoder * entropy;
    433 };
    434 
    435 
    436 /* Master record for a decompression instance */
    437 
    438 struct jpeg_decompress_struct {
    439   jpeg_common_fields;		/* Fields shared with jpeg_compress_struct */
    440 
    441   /* Source of compressed data */
    442   struct jpeg_source_mgr * src;
    443 
    444   /* Basic description of image --- filled in by jpeg_read_header(). */
    445   /* Application may inspect these values to decide how to process image. */
    446 
    447   JDIMENSION image_width;	/* nominal image width (from SOF marker) */
    448   JDIMENSION image_height;	/* nominal image height */
    449   int num_components;		/* # of color components in JPEG image */
    450   J_COLOR_SPACE jpeg_color_space; /* colorspace of JPEG image */
    451 
    452   /* Decompression processing parameters --- these fields must be set before
    453    * calling jpeg_start_decompress().  Note that jpeg_read_header() initializes
    454    * them to default values.
    455    */
    456 
    457   J_COLOR_SPACE out_color_space; /* colorspace for output */
    458 
    459   unsigned int scale_num, scale_denom; /* fraction by which to scale image */
    460 
    461   double output_gamma;		/* image gamma wanted in output */
    462 
    463   boolean buffered_image;	/* TRUE=multiple output passes */
    464   boolean raw_data_out;		/* TRUE=downsampled data wanted */
    465 
    466   J_DCT_METHOD dct_method;	/* IDCT algorithm selector */
    467   boolean do_fancy_upsampling;	/* TRUE=apply fancy upsampling */
    468   boolean do_block_smoothing;	/* TRUE=apply interblock smoothing */
    469 
    470   boolean quantize_colors;	/* TRUE=colormapped output wanted */
    471   /* the following are ignored if not quantize_colors: */
    472   J_DITHER_MODE dither_mode;	/* type of color dithering to use */
    473   boolean two_pass_quantize;	/* TRUE=use two-pass color quantization */
    474   int desired_number_of_colors;	/* max # colors to use in created colormap */
    475   /* these are significant only in buffered-image mode: */
    476   boolean enable_1pass_quant;	/* enable future use of 1-pass quantizer */
    477   boolean enable_external_quant;/* enable future use of external colormap */
    478   boolean enable_2pass_quant;	/* enable future use of 2-pass quantizer */
    479 
    480   /* Description of actual output image that will be returned to application.
    481    * These fields are computed by jpeg_start_decompress().
    482    * You can also use jpeg_calc_output_dimensions() to determine these values
    483    * in advance of calling jpeg_start_decompress().
    484    */
    485 
    486   JDIMENSION output_width;	/* scaled image width */
    487   JDIMENSION output_height;	/* scaled image height */
    488   int out_color_components;	/* # of color components in out_color_space */
    489   int output_components;	/* # of color components returned */
    490   /* output_components is 1 (a colormap index) when quantizing colors;
    491    * otherwise it equals out_color_components.
    492    */
    493   int rec_outbuf_height;	/* min recommended height of scanline buffer */
    494   /* If the buffer passed to jpeg_read_scanlines() is less than this many rows
    495    * high, space and time will be wasted due to unnecessary data copying.
    496    * Usually rec_outbuf_height will be 1 or 2, at most 4.
    497    */
    498 
    499   /* When quantizing colors, the output colormap is described by these fields.
    500    * The application can supply a colormap by setting colormap non-NULL before
    501    * calling jpeg_start_decompress; otherwise a colormap is created during
    502    * jpeg_start_decompress or jpeg_start_output.
    503    * The map has out_color_components rows and actual_number_of_colors columns.
    504    */
    505   int actual_number_of_colors;	/* number of entries in use */
    506   JSAMPARRAY colormap;		/* The color map as a 2-D pixel array */
    507 
    508   /* State variables: these variables indicate the progress of decompression.
    509    * The application may examine these but must not modify them.
    510    */
    511 
    512   /* Row index of next scanline to be read from jpeg_read_scanlines().
    513    * Application may use this to control its processing loop, e.g.,
    514    * "while (output_scanline < output_height)".
    515    */
    516   JDIMENSION output_scanline;	/* 0 .. output_height-1  */
    517 
    518   /* Current input scan number and number of iMCU rows completed in scan.
    519    * These indicate the progress of the decompressor input side.
    520    */
    521   int input_scan_number;	/* Number of SOS markers seen so far */
    522   JDIMENSION input_iMCU_row;	/* Number of iMCU rows completed */
    523 
    524   /* The "output scan number" is the notional scan being displayed by the
    525    * output side.  The decompressor will not allow output scan/row number
    526    * to get ahead of input scan/row, but it can fall arbitrarily far behind.
    527    */
    528   int output_scan_number;	/* Nominal scan number being displayed */
    529   JDIMENSION output_iMCU_row;	/* Number of iMCU rows read */
    530 
    531   /* Current progression status.  coef_bits[c][i] indicates the precision
    532    * with which component c's DCT coefficient i (in zigzag order) is known.
    533    * It is -1 when no data has yet been received, otherwise it is the point
    534    * transform (shift) value for the most recent scan of the coefficient
    535    * (thus, 0 at completion of the progression).
    536    * This pointer is NULL when reading a non-progressive file.
    537    */
    538   int (*coef_bits)[DCTSIZE2];	/* -1 or current Al value for each coef */
    539 
    540   /* Internal JPEG parameters --- the application usually need not look at
    541    * these fields.  Note that the decompressor output side may not use
    542    * any parameters that can change between scans.
    543    */
    544 
    545   /* Quantization and Huffman tables are carried forward across input
    546    * datastreams when processing abbreviated JPEG datastreams.
    547    */
    548 
    549   JQUANT_TBL * quant_tbl_ptrs[NUM_QUANT_TBLS];
    550   /* ptrs to coefficient quantization tables, or NULL if not defined */
    551 
    552   JHUFF_TBL * dc_huff_tbl_ptrs[NUM_HUFF_TBLS];
    553   JHUFF_TBL * ac_huff_tbl_ptrs[NUM_HUFF_TBLS];
    554   /* ptrs to Huffman coding tables, or NULL if not defined */
    555 
    556   /* These parameters are never carried across datastreams, since they
    557    * are given in SOF/SOS markers or defined to be reset by SOI.
    558    */
    559 
    560   int data_precision;		/* bits of precision in image data */
    561 
    562   jpeg_component_info * comp_info;
    563   /* comp_info[i] describes component that appears i'th in SOF */
    564 
    565   boolean progressive_mode;	/* TRUE if SOFn specifies progressive mode */
    566   boolean arith_code;		/* TRUE=arithmetic coding, FALSE=Huffman */
    567 
    568   UINT8 arith_dc_L[NUM_ARITH_TBLS]; /* L values for DC arith-coding tables */
    569   UINT8 arith_dc_U[NUM_ARITH_TBLS]; /* U values for DC arith-coding tables */
    570   UINT8 arith_ac_K[NUM_ARITH_TBLS]; /* Kx values for AC arith-coding tables */
    571 
    572   unsigned int restart_interval; /* MCUs per restart interval, or 0 for no restart */
    573 
    574   /* These fields record data obtained from optional markers recognized by
    575    * the JPEG library.
    576    */
    577   boolean saw_JFIF_marker;	/* TRUE iff a JFIF APP0 marker was found */
    578   /* Data copied from JFIF marker: */
    579   UINT8 density_unit;		/* JFIF code for pixel size units */
    580   UINT16 X_density;		/* Horizontal pixel density */
    581   UINT16 Y_density;		/* Vertical pixel density */
    582   boolean saw_Adobe_marker;	/* TRUE iff an Adobe APP14 marker was found */
    583   UINT8 Adobe_transform;	/* Color transform code from Adobe marker */
    584 
    585   boolean CCIR601_sampling;	/* TRUE=first samples are cosited */
    586 
    587   /* Remaining fields are known throughout decompressor, but generally
    588    * should not be touched by a surrounding application.
    589    */
    590 
    591   /*
    592    * These fields are computed during decompression startup
    593    */
    594   int max_h_samp_factor;	/* largest h_samp_factor */
    595   int max_v_samp_factor;	/* largest v_samp_factor */
    596 
    597   int min_DCT_scaled_size;	/* smallest DCT_scaled_size of any component */
    598 
    599   JDIMENSION total_iMCU_rows;	/* # of iMCU rows in image */
    600   /* The coefficient controller's input and output progress is measured in
    601    * units of "iMCU" (interleaved MCU) rows.  These are the same as MCU rows
    602    * in fully interleaved JPEG scans, but are used whether the scan is
    603    * interleaved or not.  We define an iMCU row as v_samp_factor DCT block
    604    * rows of each component.  Therefore, the IDCT output contains
    605    * v_samp_factor*DCT_scaled_size sample rows of a component per iMCU row.
    606    */
    607 
    608   JSAMPLE * sample_range_limit; /* table for fast range-limiting */
    609 
    610   /*
    611    * These fields are valid during any one scan.
    612    * They describe the components and MCUs actually appearing in the scan.
    613    * Note that the decompressor output side must not use these fields.
    614    */
    615   int comps_in_scan;		/* # of JPEG components in this scan */
    616   jpeg_component_info * cur_comp_info[MAX_COMPS_IN_SCAN];
    617   /* *cur_comp_info[i] describes component that appears i'th in SOS */
    618 
    619   JDIMENSION MCUs_per_row;	/* # of MCUs across the image */
    620   JDIMENSION MCU_rows_in_scan;	/* # of MCU rows in the image */
    621 
    622   int blocks_in_MCU;		/* # of DCT blocks per MCU */
    623   int MCU_membership[D_MAX_BLOCKS_IN_MCU];
    624   /* MCU_membership[i] is index in cur_comp_info of component owning */
    625   /* i'th block in an MCU */
    626 
    627   int Ss, Se, Ah, Al;		/* progressive JPEG parameters for scan */
    628 
    629   /* This field is shared between entropy decoder and marker parser.
    630    * It is either zero or the code of a JPEG marker that has been
    631    * read from the data source, but has not yet been processed.
    632    */
    633   int unread_marker;
    634 
    635   /*
    636    * Links to decompression subobjects (methods, private variables of modules)
    637    */
    638   struct jpeg_decomp_master * master;
    639   struct jpeg_d_main_controller * main;
    640   struct jpeg_d_coef_controller * coef;
    641   struct jpeg_d_post_controller * post;
    642   struct jpeg_input_controller * inputctl;
    643   struct jpeg_marker_reader * marker;
    644   struct jpeg_entropy_decoder * entropy;
    645   struct jpeg_inverse_dct * idct;
    646   struct jpeg_upsampler * upsample;
    647   struct jpeg_color_deconverter * cconvert;
    648   struct jpeg_color_quantizer * cquantize;
    649 };
    650 
    651 
    652 /* "Object" declarations for JPEG modules that may be supplied or called
    653  * directly by the surrounding application.
    654  * As with all objects in the JPEG library, these structs only define the
    655  * publicly visible methods and state variables of a module.  Additional
    656  * private fields may exist after the public ones.
    657  */
    658 
    659 
    660 /* Error handler object */
    661 
    662 struct jpeg_error_mgr {
    663   /* Error exit handler: does not return to caller */
    664   JMETHOD(void, error_exit, (j_common_ptr cinfo));
    665   /* Conditionally emit a trace or warning message */
    666   JMETHOD(void, emit_message, (j_common_ptr cinfo, int msg_level));
    667   /* Routine that actually outputs a trace or error message */
    668   JMETHOD(void, output_message, (j_common_ptr cinfo));
    669   /* Format a message string for the most recent JPEG error or message */
    670   JMETHOD(void, format_message, (j_common_ptr cinfo, char * buffer));
    671 #define JMSG_LENGTH_MAX  200	/* recommended size of format_message buffer */
    672   /* Reset error state variables at start of a new image */
    673   JMETHOD(void, reset_error_mgr, (j_common_ptr cinfo));
    674   
    675   /* The message ID code and any parameters are saved here.
    676    * A message can have one string parameter or up to 8 int parameters.
    677    */
    678   int msg_code;
    679 #define JMSG_STR_PARM_MAX  80
    680   union {
    681     int i[8];
    682     char s[JMSG_STR_PARM_MAX];
    683   } msg_parm;
    684   
    685   /* Standard state variables for error facility */
    686   
    687   int trace_level;		/* max msg_level that will be displayed */
    688   
    689   /* For recoverable corrupt-data errors, we emit a warning message,
    690    * but keep going unless emit_message chooses to abort.  emit_message
    691    * should count warnings in num_warnings.  The surrounding application
    692    * can check for bad data by seeing if num_warnings is nonzero at the
    693    * end of processing.
    694    */
    695   long num_warnings;		/* number of corrupt-data warnings */
    696 
    697   /* These fields point to the table(s) of error message strings.
    698    * An application can change the table pointer to switch to a different
    699    * message list (typically, to change the language in which errors are
    700    * reported).  Some applications may wish to add additional error codes
    701    * that will be handled by the JPEG library error mechanism; the second
    702    * table pointer is used for this purpose.
    703    *
    704    * First table includes all errors generated by JPEG library itself.
    705    * Error code 0 is reserved for a "no such error string" message.
    706    */
    707   const char * const * jpeg_message_table; /* Library errors */
    708   int last_jpeg_message;    /* Table contains strings 0..last_jpeg_message */
    709   /* Second table can be added by application (see cjpeg/djpeg for example).
    710    * It contains strings numbered first_addon_message..last_addon_message.
    711    */
    712   const char * const * addon_message_table; /* Non-library errors */
    713   int first_addon_message;	/* code for first string in addon table */
    714   int last_addon_message;	/* code for last string in addon table */
    715 };
    716 
    717 
    718 /* Progress monitor object */
    719 
    720 struct jpeg_progress_mgr {
    721   JMETHOD(void, progress_monitor, (j_common_ptr cinfo));
    722 
    723   long pass_counter;		/* work units completed in this pass */
    724   long pass_limit;		/* total number of work units in this pass */
    725   int completed_passes;		/* passes completed so far */
    726   int total_passes;		/* total number of passes expected */
    727 };
    728 
    729 
    730 /* Data destination object for compression */
    731 
    732 struct jpeg_destination_mgr {
    733   JOCTET * next_output_byte;	/* => next byte to write in buffer */
    734   size_t free_in_buffer;	/* # of byte spaces remaining in buffer */
    735 
    736   JMETHOD(void, init_destination, (j_compress_ptr cinfo));
    737   JMETHOD(boolean, empty_output_buffer, (j_compress_ptr cinfo));
    738   JMETHOD(void, term_destination, (j_compress_ptr cinfo));
    739 };
    740 
    741 
    742 /* Data source object for decompression */
    743 
    744 struct jpeg_source_mgr {
    745   const JOCTET * next_input_byte; /* => next byte to read from buffer */
    746   size_t bytes_in_buffer;	/* # of bytes remaining in buffer */
    747 
    748   JMETHOD(void, init_source, (j_decompress_ptr cinfo));
    749   JMETHOD(boolean, fill_input_buffer, (j_decompress_ptr cinfo));
    750   JMETHOD(void, skip_input_data, (j_decompress_ptr cinfo, long num_bytes));
    751   JMETHOD(boolean, resync_to_restart, (j_decompress_ptr cinfo, int desired));
    752   JMETHOD(void, term_source, (j_decompress_ptr cinfo));
    753 };
    754 
    755 
    756 /* Memory manager object.
    757  * Allocates "small" objects (a few K total), "large" objects (tens of K),
    758  * and "really big" objects (virtual arrays with backing store if needed).
    759  * The memory manager does not allow individual objects to be freed; rather,
    760  * each created object is assigned to a pool, and whole pools can be freed
    761  * at once.  This is faster and more convenient than remembering exactly what
    762  * to free, especially where malloc()/free() are not too speedy.
    763  * NB: alloc routines never return NULL.  They exit to error_exit if not
    764  * successful.
    765  */
    766 
    767 #define JPOOL_PERMANENT	0	/* lasts until master record is destroyed */
    768 #define JPOOL_IMAGE	1	/* lasts until done with image/datastream */
    769 #define JPOOL_NUMPOOLS	2
    770 
    771 typedef struct jvirt_sarray_control * jvirt_sarray_ptr;
    772 typedef struct jvirt_barray_control * jvirt_barray_ptr;
    773 
    774 
    775 struct jpeg_memory_mgr {
    776   /* Method pointers */
    777   JMETHOD(void *, alloc_small, (j_common_ptr cinfo, int pool_id,
    778 				size_t sizeofobject));
    779   JMETHOD(void FAR *, alloc_large, (j_common_ptr cinfo, int pool_id,
    780 				     size_t sizeofobject));
    781   JMETHOD(JSAMPARRAY, alloc_sarray, (j_common_ptr cinfo, int pool_id,
    782 				     JDIMENSION samplesperrow,
    783 				     JDIMENSION numrows));
    784   JMETHOD(JBLOCKARRAY, alloc_barray, (j_common_ptr cinfo, int pool_id,
    785 				      JDIMENSION blocksperrow,
    786 				      JDIMENSION numrows));
    787   JMETHOD(jvirt_sarray_ptr, request_virt_sarray, (j_common_ptr cinfo,
    788 						  int pool_id,
    789 						  boolean pre_zero,
    790 						  JDIMENSION samplesperrow,
    791 						  JDIMENSION numrows,
    792 						  JDIMENSION maxaccess));
    793   JMETHOD(jvirt_barray_ptr, request_virt_barray, (j_common_ptr cinfo,
    794 						  int pool_id,
    795 						  boolean pre_zero,
    796 						  JDIMENSION blocksperrow,
    797 						  JDIMENSION numrows,
    798 						  JDIMENSION maxaccess));
    799   JMETHOD(void, realize_virt_arrays, (j_common_ptr cinfo));
    800   JMETHOD(JSAMPARRAY, access_virt_sarray, (j_common_ptr cinfo,
    801 					   jvirt_sarray_ptr ptr,
    802 					   JDIMENSION start_row,
    803 					   JDIMENSION num_rows,
    804 					   boolean writable));
    805   JMETHOD(JBLOCKARRAY, access_virt_barray, (j_common_ptr cinfo,
    806 					    jvirt_barray_ptr ptr,
    807 					    JDIMENSION start_row,
    808 					    JDIMENSION num_rows,
    809 					    boolean writable));
    810   JMETHOD(void, free_pool, (j_common_ptr cinfo, int pool_id));
    811   JMETHOD(void, self_destruct, (j_common_ptr cinfo));
    812 
    813   /* Limit on memory allocation for this JPEG object.  (Note that this is
    814    * merely advisory, not a guaranteed maximum; it only affects the space
    815    * used for virtual-array buffers.)  May be changed by outer application
    816    * after creating the JPEG object.
    817    */
    818   long max_memory_to_use;
    819 };
    820 
    821 
    822 /* Routine signature for application-supplied marker processing methods.
    823  * Need not pass marker code since it is stored in cinfo->unread_marker.
    824  */
    825 typedef JMETHOD(boolean, jpeg_marker_parser_method, (j_decompress_ptr cinfo));
    826 
    827 
    828 /* Declarations for routines called by application.
    829  * The JPP macro hides prototype parameters from compilers that can't cope.
    830  * Note JPP requires double parentheses.
    831  */
    832 
    833 #ifdef HAVE_PROTOTYPES
    834 #define JPP(arglist)	arglist
    835 #else
    836 #define JPP(arglist)	()
    837 #endif
    838 
    839 
    840 /* Short forms of external names for systems with brain-damaged linkers.
    841  * We shorten external names to be unique in the first six letters, which
    842  * is good enough for all known systems.
    843  * (If your compiler itself needs names to be unique in less than 15 
    844  * characters, you are out of luck.  Get a better compiler.)
    845  */
    846 
    847 #ifdef NEED_SHORT_EXTERNAL_NAMES
    848 #define jpeg_std_error		jStdError
    849 #define jpeg_create_compress	jCreaCompress
    850 #define jpeg_create_decompress	jCreaDecompress
    851 #define jpeg_destroy_compress	jDestCompress
    852 #define jpeg_destroy_decompress	jDestDecompress
    853 #define jpeg_stdio_dest		jStdDest
    854 #define jpeg_stdio_src		jStdSrc
    855 #define jpeg_set_defaults	jSetDefaults
    856 #define jpeg_set_colorspace	jSetColorspace
    857 #define jpeg_default_colorspace	jDefColorspace
    858 #define jpeg_set_quality	jSetQuality
    859 #define jpeg_set_linear_quality	jSetLQuality
    860 #define jpeg_add_quant_table	jAddQuantTable
    861 #define jpeg_quality_scaling	jQualityScaling
    862 #define jpeg_simple_progression	jSimProgress
    863 #define jpeg_suppress_tables	jSuppressTables
    864 #define jpeg_alloc_quant_table	jAlcQTable
    865 #define jpeg_alloc_huff_table	jAlcHTable
    866 #define jpeg_start_compress	jStrtCompress
    867 #define jpeg_write_scanlines	jWrtScanlines
    868 #define jpeg_finish_compress	jFinCompress
    869 #define jpeg_write_raw_data	jWrtRawData
    870 #define jpeg_write_marker	jWrtMarker
    871 #define jpeg_write_tables	jWrtTables
    872 #define jpeg_read_header	jReadHeader
    873 #define jpeg_start_decompress	jStrtDecompress
    874 #define jpeg_read_scanlines	jReadScanlines
    875 #define jpeg_finish_decompress	jFinDecompress
    876 #define jpeg_read_raw_data	jReadRawData
    877 #define jpeg_has_multiple_scans	jHasMultScn
    878 #define jpeg_start_output	jStrtOutput
    879 #define jpeg_finish_output	jFinOutput
    880 #define jpeg_input_complete	jInComplete
    881 #define jpeg_new_colormap	jNewCMap
    882 #define jpeg_consume_input	jConsumeInput
    883 #define jpeg_calc_output_dimensions	jCalcDimensions
    884 #define jpeg_set_marker_processor	jSetMarker
    885 #define jpeg_read_coefficients	jReadCoefs
    886 #define jpeg_write_coefficients	jWrtCoefs
    887 #define jpeg_copy_critical_parameters	jCopyCrit
    888 #define jpeg_abort_compress	jAbrtCompress
    889 #define jpeg_abort_decompress	jAbrtDecompress
    890 #define jpeg_abort		jAbort
    891 #define jpeg_destroy		jDestroy
    892 #define jpeg_resync_to_restart	jResyncRestart
    893 #endif /* NEED_SHORT_EXTERNAL_NAMES */
    894 
    895 
    896 /* Default error-management setup */
    897 EXTERN struct jpeg_error_mgr *jpeg_std_error JPP((struct jpeg_error_mgr *err));
    898 
    899 /* Initialization and destruction of JPEG compression objects */
    900 /* NB: you must set up the error-manager BEFORE calling jpeg_create_xxx */
    901 EXTERN void jpeg_create_compress JPP((j_compress_ptr cinfo));
    902 EXTERN void jpeg_create_decompress JPP((j_decompress_ptr cinfo));
    903 EXTERN void jpeg_destroy_compress JPP((j_compress_ptr cinfo));
    904 EXTERN void jpeg_destroy_decompress JPP((j_decompress_ptr cinfo));
    905 
    906 /* Standard data source and destination managers: stdio streams. */
    907 /* Caller is responsible for opening the file before and closing after. */
    908 EXTERN void jpeg_stdio_dest JPP((j_compress_ptr cinfo, FILE * outfile));
    909 EXTERN void jpeg_stdio_src JPP((j_decompress_ptr cinfo, unsigned char *infile));
    910 
    911 /* Default parameter setup for compression */
    912 EXTERN void jpeg_set_defaults JPP((j_compress_ptr cinfo));
    913 /* Compression parameter setup aids */
    914 EXTERN void jpeg_set_colorspace JPP((j_compress_ptr cinfo,
    915 				     J_COLOR_SPACE colorspace));
    916 EXTERN void jpeg_default_colorspace JPP((j_compress_ptr cinfo));
    917 EXTERN void jpeg_set_quality JPP((j_compress_ptr cinfo, int quality,
    918 				  boolean force_baseline));
    919 EXTERN void jpeg_set_linear_quality JPP((j_compress_ptr cinfo,
    920 					 int scale_factor,
    921 					 boolean force_baseline));
    922 EXTERN void jpeg_add_quant_table JPP((j_compress_ptr cinfo, int which_tbl,
    923 				      const unsigned int *basic_table,
    924 				      int scale_factor,
    925 				      boolean force_baseline));
    926 EXTERN int jpeg_quality_scaling JPP((int quality));
    927 EXTERN void jpeg_simple_progression JPP((j_compress_ptr cinfo));
    928 EXTERN void jpeg_suppress_tables JPP((j_compress_ptr cinfo,
    929 				      boolean suppress));
    930 EXTERN JQUANT_TBL * jpeg_alloc_quant_table JPP((j_common_ptr cinfo));
    931 EXTERN JHUFF_TBL * jpeg_alloc_huff_table JPP((j_common_ptr cinfo));
    932 
    933 /* Main entry points for compression */
    934 EXTERN void jpeg_start_compress JPP((j_compress_ptr cinfo,
    935 				     boolean write_all_tables));
    936 EXTERN JDIMENSION jpeg_write_scanlines JPP((j_compress_ptr cinfo,
    937 					    JSAMPARRAY scanlines,
    938 					    JDIMENSION num_lines));
    939 EXTERN void jpeg_finish_compress JPP((j_compress_ptr cinfo));
    940 
    941 /* Replaces jpeg_write_scanlines when writing raw downsampled data. */
    942 EXTERN JDIMENSION jpeg_write_raw_data JPP((j_compress_ptr cinfo,
    943 					   JSAMPIMAGE data,
    944 					   JDIMENSION num_lines));
    945 
    946 /* Write a special marker.  See libjpeg.doc concerning safe usage. */
    947 EXTERN void jpeg_write_marker JPP((j_compress_ptr cinfo, int marker,
    948 				   const JOCTET *dataptr, unsigned int datalen));
    949 
    950 /* Alternate compression function: just write an abbreviated table file */
    951 EXTERN void jpeg_write_tables JPP((j_compress_ptr cinfo));
    952 
    953 /* Decompression startup: read start of JPEG datastream to see what's there */
    954 EXTERN int jpeg_read_header JPP((j_decompress_ptr cinfo,
    955 				 boolean require_image));
    956 /* Return value is one of: */
    957 #define JPEG_SUSPENDED		0 /* Suspended due to lack of input data */
    958 #define JPEG_HEADER_OK		1 /* Found valid image datastream */
    959 #define JPEG_HEADER_TABLES_ONLY	2 /* Found valid table-specs-only datastream */
    960 /* If you pass require_image = TRUE (normal case), you need not check for
    961  * a TABLES_ONLY return code; an abbreviated file will cause an error exit.
    962  * JPEG_SUSPENDED is only possible if you use a data source module that can
    963  * give a suspension return (the stdio source module doesn't).
    964  */
    965 
    966 /* Main entry points for decompression */
    967 EXTERN boolean jpeg_start_decompress JPP((j_decompress_ptr cinfo));
    968 EXTERN JDIMENSION jpeg_read_scanlines JPP((j_decompress_ptr cinfo,
    969 					   JSAMPARRAY scanlines,
    970 					   JDIMENSION max_lines));
    971 EXTERN boolean jpeg_finish_decompress JPP((j_decompress_ptr cinfo));
    972 
    973 /* Replaces jpeg_read_scanlines when reading raw downsampled data. */
    974 EXTERN JDIMENSION jpeg_read_raw_data JPP((j_decompress_ptr cinfo,
    975 					  JSAMPIMAGE data,
    976 					  JDIMENSION max_lines));
    977 
    978 /* Additional entry points for buffered-image mode. */
    979 EXTERN boolean jpeg_has_multiple_scans JPP((j_decompress_ptr cinfo));
    980 EXTERN boolean jpeg_start_output JPP((j_decompress_ptr cinfo,
    981 				      int scan_number));
    982 EXTERN boolean jpeg_finish_output JPP((j_decompress_ptr cinfo));
    983 EXTERN boolean jpeg_input_complete JPP((j_decompress_ptr cinfo));
    984 EXTERN void jpeg_new_colormap JPP((j_decompress_ptr cinfo));
    985 EXTERN int jpeg_consume_input JPP((j_decompress_ptr cinfo));
    986 /* Return value is one of: */
    987 /* #define JPEG_SUSPENDED	0    Suspended due to lack of input data */
    988 #define JPEG_REACHED_SOS	1 /* Reached start of new scan */
    989 #define JPEG_REACHED_EOI	2 /* Reached end of image */
    990 #define JPEG_ROW_COMPLETED	3 /* Completed one iMCU row */
    991 #define JPEG_SCAN_COMPLETED	4 /* Completed last iMCU row of a scan */
    992 
    993 /* Precalculate output dimensions for current decompression parameters. */
    994 EXTERN void jpeg_calc_output_dimensions JPP((j_decompress_ptr cinfo));
    995 
    996 /* Install a special processing method for COM or APPn markers. */
    997 EXTERN void jpeg_set_marker_processor JPP((j_decompress_ptr cinfo,
    998 					   int marker_code,
    999 					   jpeg_marker_parser_method routine));
   1000 
   1001 /* Read or write raw DCT coefficients --- useful for lossless transcoding. */
   1002 EXTERN jvirt_barray_ptr * jpeg_read_coefficients JPP((j_decompress_ptr cinfo));
   1003 EXTERN void jpeg_write_coefficients JPP((j_compress_ptr cinfo,
   1004 					 jvirt_barray_ptr * coef_arrays));
   1005 EXTERN void jpeg_copy_critical_parameters JPP((j_decompress_ptr srcinfo,
   1006 					       j_compress_ptr dstinfo));
   1007 
   1008 /* If you choose to abort compression or decompression before completing
   1009  * jpeg_finish_(de)compress, then you need to clean up to release memory,
   1010  * temporary files, etc.  You can just call jpeg_destroy_(de)compress
   1011  * if you're done with the JPEG object, but if you want to clean it up and
   1012  * reuse it, call this:
   1013  */
   1014 EXTERN void jpeg_abort_compress JPP((j_compress_ptr cinfo));
   1015 EXTERN void jpeg_abort_decompress JPP((j_decompress_ptr cinfo));
   1016 
   1017 /* Generic versions of jpeg_abort and jpeg_destroy that work on either
   1018  * flavor of JPEG object.  These may be more convenient in some places.
   1019  */
   1020 EXTERN void jpeg_abort JPP((j_common_ptr cinfo));
   1021 EXTERN void jpeg_destroy JPP((j_common_ptr cinfo));
   1022 
   1023 /* Default restart-marker-resync procedure for use by data source modules */
   1024 EXTERN boolean jpeg_resync_to_restart JPP((j_decompress_ptr cinfo,
   1025 					   int desired));
   1026 
   1027 
   1028 /* These marker codes are exported since applications and data source modules
   1029  * are likely to want to use them.
   1030  */
   1031 
   1032 #define JPEG_RST0	0xD0	/* RST0 marker code */
   1033 #define JPEG_EOI	0xD9	/* EOI marker code */
   1034 #define JPEG_APP0	0xE0	/* APP0 marker code */
   1035 #define JPEG_COM	0xFE	/* COM marker code */
   1036 
   1037 
   1038 /* If we have a brain-damaged compiler that emits warnings (or worse, errors)
   1039  * for structure definitions that are never filled in, keep it quiet by
   1040  * supplying dummy definitions for the various substructures.
   1041  */
   1042 
   1043 #ifdef INCOMPLETE_TYPES_BROKEN
   1044 #ifndef JPEG_INTERNALS		/* will be defined in jpegint.h */
   1045 struct jvirt_sarray_control { long dummy; };
   1046 struct jvirt_barray_control { long dummy; };
   1047 struct jpeg_comp_master { long dummy; };
   1048 struct jpeg_c_main_controller { long dummy; };
   1049 struct jpeg_c_prep_controller { long dummy; };
   1050 struct jpeg_c_coef_controller { long dummy; };
   1051 struct jpeg_marker_writer { long dummy; };
   1052 struct jpeg_color_converter { long dummy; };
   1053 struct jpeg_downsampler { long dummy; };
   1054 struct jpeg_forward_dct { long dummy; };
   1055 struct jpeg_entropy_encoder { long dummy; };
   1056 struct jpeg_decomp_master { long dummy; };
   1057 struct jpeg_d_main_controller { long dummy; };
   1058 struct jpeg_d_coef_controller { long dummy; };
   1059 struct jpeg_d_post_controller { long dummy; };
   1060 struct jpeg_input_controller { long dummy; };
   1061 struct jpeg_marker_reader { long dummy; };
   1062 struct jpeg_entropy_decoder { long dummy; };
   1063 struct jpeg_inverse_dct { long dummy; };
   1064 struct jpeg_upsampler { long dummy; };
   1065 struct jpeg_color_deconverter { long dummy; };
   1066 struct jpeg_color_quantizer { long dummy; };
   1067 #endif /* JPEG_INTERNALS */
   1068 #endif /* INCOMPLETE_TYPES_BROKEN */
   1069 
   1070 
   1071 /*
   1072  * The JPEG library modules define JPEG_INTERNALS before including this file.
   1073  * The internal structure declarations are read only when that is true.
   1074  * Applications using the library should not include jpegint.h, but may wish
   1075  * to include jerror.h.
   1076  */
   1077 
   1078 #ifdef JPEG_INTERNALS
   1079 #include "jpegint.h"		/* fetch private declarations */
   1080 #include "jerror.h"		/* fetch error codes too */
   1081 #endif
   1082 
   1083 #ifdef __cplusplus
   1084 }
   1085 #endif
   1086 
   1087 #endif /* JPEGLIB_H */