JPEGINT.H
上传用户:wep9318
上传日期:2007-01-07
资源大小:893k
文件大小:14k
源码类别:

图片显示

开发平台:

Visual C++

  1. /*
  2.  * jpegint.h
  3.  *
  4.  * Copyright (C) 1991-1994, 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 provides common declarations for the various JPEG modules.
  9.  * These declarations are considered internal to the JPEG library; most
  10.  * applications using the library shouldn't need to include this file.
  11.  */
  12. /* Declarations for both compression & decompression */
  13. typedef enum { /* Operating modes for buffer controllers */
  14. JBUF_PASS_THRU, /* Plain stripwise operation */
  15. JBUF_CRANK_SOURCE, /* Run source subobject, no output expected */
  16. /* Remaining modes require a full-image buffer to have been created */
  17. JBUF_SAVE_SOURCE, /* Run source subobject only, save output */
  18. JBUF_CRANK_DEST, /* Run dest subobject only, using saved data */
  19. JBUF_SAVE_AND_PASS /* Run both subobjects, save output */
  20. } J_BUF_MODE;
  21. /* Values of global_state field */
  22. #define CSTATE_START 100 /* after create_compress */
  23. #define CSTATE_SCANNING 101 /* start_compress done, write_scanlines OK */
  24. #define CSTATE_RAW_OK 102 /* start_compress done, write_raw_data OK */
  25. #define DSTATE_START 200 /* after create_decompress */
  26. #define DSTATE_INHEADER 201 /* read_header initialized but not done */
  27. #define DSTATE_READY 202 /* read_header done, found image */
  28. #define DSTATE_SCANNING 203 /* start_decompress done, read_scanlines OK */
  29. #define DSTATE_RAW_OK 204 /* start_decompress done, read_raw_data OK */
  30. #define DSTATE_STOPPING 205 /* done reading data, looking for EOI */
  31. /* Declarations for compression modules */
  32. /* Master control module */
  33. struct jpeg_comp_master {
  34.   JMETHOD(void, prepare_for_pass, (j_compress_ptr cinfo));
  35.   JMETHOD(void, pass_startup, (j_compress_ptr cinfo));
  36.   JMETHOD(void, finish_pass, (j_compress_ptr cinfo));
  37.   /* State variables made visible to other modules */
  38.   boolean call_pass_startup; /* True if pass_startup must be called */
  39.   boolean is_last_pass; /* True during last pass */
  40. };
  41. /* Main buffer control (downsampled-data buffer) */
  42. struct jpeg_c_main_controller {
  43.   JMETHOD(void, start_pass, (j_compress_ptr cinfo, J_BUF_MODE pass_mode));
  44.   JMETHOD(void, process_data, (j_compress_ptr cinfo,
  45.        JSAMPARRAY input_buf, JDIMENSION *in_row_ctr,
  46.        JDIMENSION in_rows_avail));
  47. };
  48. /* Compression preprocessing (downsampling input buffer control) */
  49. struct jpeg_c_prep_controller {
  50.   JMETHOD(void, start_pass, (j_compress_ptr cinfo, J_BUF_MODE pass_mode));
  51.   JMETHOD(void, pre_process_data, (j_compress_ptr cinfo,
  52.    JSAMPARRAY input_buf,
  53.    JDIMENSION *in_row_ctr,
  54.    JDIMENSION in_rows_avail,
  55.    JSAMPIMAGE output_buf,
  56.    JDIMENSION *out_row_group_ctr,
  57.    JDIMENSION out_row_groups_avail));
  58. };
  59. /* Coefficient buffer control */
  60. struct jpeg_c_coef_controller {
  61.   JMETHOD(void, start_pass, (j_compress_ptr cinfo, J_BUF_MODE pass_mode));
  62.   JMETHOD(void, compress_data, (j_compress_ptr cinfo,
  63. JSAMPIMAGE input_buf,
  64. JDIMENSION *in_mcu_ctr));
  65. };
  66. /* Colorspace conversion */
  67. struct jpeg_color_converter {
  68.   JMETHOD(void, start_pass, (j_compress_ptr cinfo));
  69.   JMETHOD(void, color_convert, (j_compress_ptr cinfo,
  70. JSAMPARRAY input_buf, JSAMPIMAGE output_buf,
  71. JDIMENSION output_row, int num_rows));
  72. };
  73. /* Downsampling */
  74. struct jpeg_downsampler {
  75.   JMETHOD(void, start_pass, (j_compress_ptr cinfo));
  76.   JMETHOD(void, downsample, (j_compress_ptr cinfo,
  77.      JSAMPIMAGE input_buf, JDIMENSION in_row_index,
  78.      JSAMPIMAGE output_buf,
  79.      JDIMENSION out_row_group_index));
  80.   boolean need_context_rows; /* TRUE if need rows above & below */
  81. };
  82. /* Forward DCT (also controls coefficient quantization) */
  83. struct jpeg_forward_dct {
  84.   JMETHOD(void, start_pass, (j_compress_ptr cinfo));
  85.   /* perhaps this should be an array??? */
  86.   JMETHOD(void, forward_DCT, (j_compress_ptr cinfo,
  87.       jpeg_component_info * compptr,
  88.       JSAMPARRAY sample_data, JBLOCKROW coef_blocks,
  89.       JDIMENSION start_row, JDIMENSION start_col,
  90.       JDIMENSION num_blocks));
  91. };
  92. /* Entropy encoding */
  93. struct jpeg_entropy_encoder {
  94.   JMETHOD(void, start_pass, (j_compress_ptr cinfo, boolean gather_statistics));
  95.   JMETHOD(boolean, encode_mcu, (j_compress_ptr cinfo, JBLOCKROW *MCU_data));
  96.   JMETHOD(void, finish_pass, (j_compress_ptr cinfo));
  97. };
  98. /* Marker writing */
  99. struct jpeg_marker_writer {
  100.   /* write_any_marker is exported for use by applications */
  101.   /* Probably only COM and APPn markers should be written */
  102.   JMETHOD(void, write_any_marker, (j_compress_ptr cinfo, int marker,
  103.    const JOCTET *dataptr, unsigned int datalen));
  104.   JMETHOD(void, write_file_header, (j_compress_ptr cinfo));
  105.   JMETHOD(void, write_frame_header, (j_compress_ptr cinfo));
  106.   JMETHOD(void, write_scan_header, (j_compress_ptr cinfo));
  107.   JMETHOD(void, write_file_trailer, (j_compress_ptr cinfo));
  108.   JMETHOD(void, write_tables_only, (j_compress_ptr cinfo));
  109. };
  110. /* Declarations for decompression modules */
  111. /* Master control module */
  112. struct jpeg_decomp_master {
  113.   JMETHOD(void, prepare_for_pass, (j_decompress_ptr cinfo));
  114.   JMETHOD(void, finish_pass, (j_decompress_ptr cinfo));
  115.   /* State variables made visible to other modules */
  116.   boolean is_last_pass; /* True during last pass */
  117.   boolean eoi_processed; /* True if EOI marker already read */
  118. };
  119. /* Main buffer control (downsampled-data buffer) */
  120. struct jpeg_d_main_controller {
  121.   JMETHOD(void, start_pass, (j_decompress_ptr cinfo, J_BUF_MODE pass_mode));
  122.   JMETHOD(void, process_data, (j_decompress_ptr cinfo,
  123.        JSAMPARRAY output_buf, JDIMENSION *out_row_ctr,
  124.        JDIMENSION out_rows_avail));
  125.   /* During input-only passes, output_buf and out_rows_avail are ignored.
  126.    * out_row_ctr is incremented towards the limit num_chunks.
  127.    */
  128.   JDIMENSION num_chunks; /* number of chunks to be processed in pass */
  129. };
  130. /* Coefficient buffer control */
  131. struct jpeg_d_coef_controller {
  132.   JMETHOD(void, start_pass, (j_decompress_ptr cinfo, J_BUF_MODE pass_mode));
  133.   JMETHOD(boolean, decompress_data, (j_decompress_ptr cinfo,
  134.      JSAMPIMAGE output_buf));
  135. };
  136. /* Decompression postprocessing (color quantization buffer control) */
  137. struct jpeg_d_post_controller {
  138.   JMETHOD(void, start_pass, (j_decompress_ptr cinfo, J_BUF_MODE pass_mode));
  139.   JMETHOD(void, post_process_data, (j_decompress_ptr cinfo,
  140.     JSAMPIMAGE input_buf,
  141.     JDIMENSION *in_row_group_ctr,
  142.     JDIMENSION in_row_groups_avail,
  143.     JSAMPARRAY output_buf,
  144.     JDIMENSION *out_row_ctr,
  145.     JDIMENSION out_rows_avail));
  146. };
  147. /* Marker reading & parsing */
  148. struct jpeg_marker_reader {
  149.   JMETHOD(void, reset_marker_reader, (j_decompress_ptr cinfo));
  150.   /* Read markers until SOS or EOI.
  151.    * Returns same codes as are defined for jpeg_read_header,
  152.    * but HEADER_OK and HEADER_TABLES_ONLY merely indicate which marker type
  153.    * stopped the scan --- further validation is needed to declare file OK.
  154.    */
  155.   JMETHOD(int, read_markers, (j_decompress_ptr cinfo));
  156.   /* Read a restart marker --- exported for use by entropy decoder only */
  157.   jpeg_marker_parser_method read_restart_marker;
  158.   /* Application-overridable marker processing methods */
  159.   jpeg_marker_parser_method process_COM;
  160.   jpeg_marker_parser_method process_APPn[16];
  161.   /* State of marker reader --- nominally internal, but applications
  162.    * supplying COM or APPn handlers might like to know the state.
  163.    */
  164.   boolean saw_SOI; /* found SOI? */
  165.   boolean saw_SOF; /* found SOF? */
  166.   int next_restart_num; /* next restart number expected (0-7) */
  167.   unsigned int discarded_bytes; /* # of bytes skipped looking for a marker */
  168. };
  169. /* Entropy decoding */
  170. struct jpeg_entropy_decoder {
  171.   JMETHOD(void, start_pass, (j_decompress_ptr cinfo));
  172.   JMETHOD(boolean, decode_mcu, (j_decompress_ptr cinfo,
  173. JBLOCKROW *MCU_data));
  174. };
  175. /* Inverse DCT (also performs dequantization) */
  176. typedef JMETHOD(void, inverse_DCT_method_ptr,
  177. (j_decompress_ptr cinfo, jpeg_component_info * compptr,
  178.  JCOEFPTR coef_block,
  179.  JSAMPARRAY output_buf, JDIMENSION output_col));
  180. struct jpeg_inverse_dct {
  181.   JMETHOD(void, start_input_pass, (j_decompress_ptr cinfo));
  182.   JMETHOD(void, start_output_pass, (j_decompress_ptr cinfo));
  183.   /* It is useful to allow each component to have a separate IDCT method. */
  184.   inverse_DCT_method_ptr inverse_DCT[MAX_COMPONENTS];
  185. };
  186. /* Upsampling (note that upsampler must also call color converter) */
  187. struct jpeg_upsampler {
  188.   JMETHOD(void, start_pass, (j_decompress_ptr cinfo));
  189.   JMETHOD(void, upsample, (j_decompress_ptr cinfo,
  190.    JSAMPIMAGE input_buf,
  191.    JDIMENSION *in_row_group_ctr,
  192.    JDIMENSION in_row_groups_avail,
  193.    JSAMPARRAY output_buf,
  194.    JDIMENSION *out_row_ctr,
  195.    JDIMENSION out_rows_avail));
  196.   boolean need_context_rows; /* TRUE if need rows above & below */
  197. };
  198. /* Colorspace conversion */
  199. struct jpeg_color_deconverter {
  200.   JMETHOD(void, start_pass, (j_decompress_ptr cinfo));
  201.   JMETHOD(void, color_convert, (j_decompress_ptr cinfo,
  202. JSAMPIMAGE input_buf, JDIMENSION input_row,
  203. JSAMPARRAY output_buf, int num_rows));
  204. };
  205. /* Color quantization or color precision reduction */
  206. struct jpeg_color_quantizer {
  207.   JMETHOD(void, start_pass, (j_decompress_ptr cinfo, boolean is_pre_scan));
  208.   JMETHOD(void, color_quantize, (j_decompress_ptr cinfo,
  209.  JSAMPARRAY input_buf, JSAMPARRAY output_buf,
  210.  int num_rows));
  211.   JMETHOD(void, finish_pass, (j_decompress_ptr cinfo));
  212. };
  213. /* Miscellaneous useful macros */
  214. #undef MAX
  215. #define MAX(a,b) ((a) > (b) ? (a) : (b))
  216. #undef MIN
  217. #define MIN(a,b) ((a) < (b) ? (a) : (b))
  218. /* We assume that right shift corresponds to signed division by 2 with
  219.  * rounding towards minus infinity.  This is correct for typical "arithmetic
  220.  * shift" instructions that shift in copies of the sign bit.  But some
  221.  * C compilers implement >> with an unsigned shift.  For these machines you
  222.  * must define RIGHT_SHIFT_IS_UNSIGNED.
  223.  * RIGHT_SHIFT provides a proper signed right shift of an INT32 quantity.
  224.  * It is only applied with constant shift counts.  SHIFT_TEMPS must be
  225.  * included in the variables of any routine using RIGHT_SHIFT.
  226.  */
  227. #ifdef RIGHT_SHIFT_IS_UNSIGNED
  228. #define SHIFT_TEMPS INT32 shift_temp;
  229. #define RIGHT_SHIFT(x,shft)  
  230. ((shift_temp = (x)) < 0 ? 
  231.  (shift_temp >> (shft)) | ((~((INT32) 0)) << (32-(shft))) : 
  232.  (shift_temp >> (shft)))
  233. #else
  234. #define SHIFT_TEMPS
  235. #define RIGHT_SHIFT(x,shft) ((x) >> (shft))
  236. #endif
  237. /* Short forms of external names for systems with brain-damaged linkers. */
  238. #ifdef NEED_SHORT_EXTERNAL_NAMES
  239. #define jinit_master_compress jICMaster
  240. #define jinit_c_main_controller jICMainC
  241. #define jinit_c_prep_controller jICPrepC
  242. #define jinit_c_coef_controller jICCoefC
  243. #define jinit_color_converter jICColor
  244. #define jinit_downsampler jIDownsampler
  245. #define jinit_forward_dct jIFDCT
  246. #define jinit_huff_encoder jIHEncoder
  247. #define jinit_marker_writer jIMWriter
  248. #define jinit_master_decompress jIDMaster
  249. #define jinit_d_main_controller jIDMainC
  250. #define jinit_d_coef_controller jIDCoefC
  251. #define jinit_d_post_controller jIDPostC
  252. #define jinit_marker_reader jIMReader
  253. #define jinit_huff_decoder jIHDecoder
  254. #define jinit_inverse_dct jIIDCT
  255. #define jinit_upsampler jIUpsampler
  256. #define jinit_color_deconverter jIDColor
  257. #define jinit_1pass_quantizer jI1Quant
  258. #define jinit_2pass_quantizer jI2Quant
  259. #define jinit_merged_upsampler jIMUpsampler
  260. #define jinit_memory_mgr jIMemMgr
  261. #define jdiv_round_up jDivRound
  262. #define jround_up jRound
  263. #define jcopy_sample_rows jCopySamples
  264. #define jcopy_block_row jCopyBlocks
  265. #define jzero_far jZeroFar
  266. #endif /* NEED_SHORT_EXTERNAL_NAMES */
  267. /* Compression module initialization routines */
  268. EXTERN void jinit_master_compress JPP((j_compress_ptr cinfo));
  269. EXTERN void jinit_c_main_controller JPP((j_compress_ptr cinfo,
  270.  boolean need_full_buffer));
  271. EXTERN void jinit_c_prep_controller JPP((j_compress_ptr cinfo,
  272.  boolean need_full_buffer));
  273. EXTERN void jinit_c_coef_controller JPP((j_compress_ptr cinfo,
  274.  boolean need_full_buffer));
  275. EXTERN void jinit_color_converter JPP((j_compress_ptr cinfo));
  276. EXTERN void jinit_downsampler JPP((j_compress_ptr cinfo));
  277. EXTERN void jinit_forward_dct JPP((j_compress_ptr cinfo));
  278. EXTERN void jinit_huff_encoder JPP((j_compress_ptr cinfo));
  279. EXTERN void jinit_marker_writer JPP((j_compress_ptr cinfo));
  280. /* Decompression module initialization routines */
  281. EXTERN void jinit_master_decompress JPP((j_decompress_ptr cinfo));
  282. EXTERN void jinit_d_main_controller JPP((j_decompress_ptr cinfo,
  283.  boolean need_full_buffer));
  284. EXTERN void jinit_d_coef_controller JPP((j_decompress_ptr cinfo,
  285.  boolean need_full_buffer));
  286. EXTERN void jinit_d_post_controller JPP((j_decompress_ptr cinfo,
  287.  boolean need_full_buffer));
  288. EXTERN void jinit_marker_reader JPP((j_decompress_ptr cinfo));
  289. EXTERN void jinit_huff_decoder JPP((j_decompress_ptr cinfo));
  290. EXTERN void jinit_inverse_dct JPP((j_decompress_ptr cinfo));
  291. EXTERN void jinit_upsampler JPP((j_decompress_ptr cinfo));
  292. EXTERN void jinit_color_deconverter JPP((j_decompress_ptr cinfo));
  293. EXTERN void jinit_1pass_quantizer JPP((j_decompress_ptr cinfo));
  294. EXTERN void jinit_2pass_quantizer JPP((j_decompress_ptr cinfo));
  295. EXTERN void jinit_merged_upsampler JPP((j_decompress_ptr cinfo));
  296. /* Memory manager initialization */
  297. EXTERN void jinit_memory_mgr JPP((j_common_ptr cinfo));
  298. /* Utility routines in jutils.c */
  299. EXTERN long jdiv_round_up JPP((long a, long b));
  300. EXTERN long jround_up JPP((long a, long b));
  301. EXTERN void jcopy_sample_rows JPP((JSAMPARRAY input_array, int source_row,
  302.    JSAMPARRAY output_array, int dest_row,
  303.    int num_rows, JDIMENSION num_cols));
  304. EXTERN void jcopy_block_row JPP((JBLOCKROW input_row, JBLOCKROW output_row,
  305.  JDIMENSION num_blocks));
  306. EXTERN void jzero_far JPP((void FAR * target, size_t bytestozero));
  307. /* Suppress undefined-structure complaints if necessary. */
  308. #ifdef INCOMPLETE_TYPES_BROKEN
  309. #ifndef AM_MEMORY_MANAGER /* only jmemmgr.c defines these */
  310. struct jvirt_sarray_control { long dummy; };
  311. struct jvirt_barray_control { long dummy; };
  312. #endif
  313. #endif /* INCOMPLETE_TYPES_BROKEN */