jpegint.h
上传用户:hmc_gdtv
上传日期:2013-08-04
资源大小:798k
文件大小:16k
源码类别:

Windows Mobile

开发平台:

Visual C++

  1. /*
  2.  * jpegint.h
  3.  *
  4.  * Copyright (C) 1991-1997, 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. /* Remaining modes require a full-image buffer to have been created */
  16. JBUF_SAVE_SOURCE, /* Run source subobject only, save output */
  17. JBUF_CRANK_DEST, /* Run dest subobject only, using saved data */
  18. JBUF_SAVE_AND_PASS /* Run both subobjects, save output */
  19. } J_BUF_MODE;
  20. /* Values of global_state field (jdapi.c has some dependencies on ordering!) */
  21. #define CSTATE_START 100 /* after create_compress */
  22. #define CSTATE_SCANNING 101 /* start_compress done, write_scanlines OK */
  23. #define CSTATE_RAW_OK 102 /* start_compress done, write_raw_data OK */
  24. #define CSTATE_WRCOEFS 103 /* jpeg_write_coefficients done */
  25. #define DSTATE_START 200 /* after create_decompress */
  26. #define DSTATE_INHEADER 201 /* reading header markers, no SOS yet */
  27. #define DSTATE_READY 202 /* found SOS, ready for start_decompress */
  28. #define DSTATE_PRELOAD 203 /* reading multiscan file in start_decompress*/
  29. #define DSTATE_PRESCAN 204 /* performing dummy pass for 2-pass quant */
  30. #define DSTATE_SCANNING 205 /* start_decompress done, read_scanlines OK */
  31. #define DSTATE_RAW_OK 206 /* start_decompress done, read_raw_data OK */
  32. #define DSTATE_BUFIMAGE 207 /* expecting jpeg_start_output */
  33. #define DSTATE_BUFPOST 208 /* looking for SOS/EOI in jpeg_finish_output */
  34. #define DSTATE_RDCOEFS 209 /* reading file in jpeg_read_coefficients */
  35. #define DSTATE_STOPPING 210 /* looking for EOI in jpeg_finish_decompress */
  36. /* Declarations for compression modules */
  37. /* Master control module */
  38. struct jpeg_comp_master {
  39.   JMETHOD(void, prepare_for_pass, (j_compress_ptr cinfo));
  40.   JMETHOD(void, pass_startup, (j_compress_ptr cinfo));
  41.   JMETHOD(void, finish_pass, (j_compress_ptr cinfo));
  42.   /* State variables made visible to other modules */
  43.   boolean call_pass_startup; /* True if pass_startup must be called */
  44.   boolean is_last_pass; /* True during last pass */
  45. };
  46. /* Main buffer control (downsampled-data buffer) */
  47. struct jpeg_c_main_controller {
  48.   JMETHOD(void, start_pass, (j_compress_ptr cinfo, J_BUF_MODE pass_mode));
  49.   JMETHOD(void, process_data, (j_compress_ptr cinfo,
  50.        JSAMPARRAY input_buf, JDIMENSION *in_row_ctr,
  51.        JDIMENSION in_rows_avail));
  52. };
  53. /* Compression preprocessing (downsampling input buffer control) */
  54. struct jpeg_c_prep_controller {
  55.   JMETHOD(void, start_pass, (j_compress_ptr cinfo, J_BUF_MODE pass_mode));
  56.   JMETHOD(void, pre_process_data, (j_compress_ptr cinfo,
  57.    JSAMPARRAY input_buf,
  58.    JDIMENSION *in_row_ctr,
  59.    JDIMENSION in_rows_avail,
  60.    JSAMPIMAGE output_buf,
  61.    JDIMENSION *out_row_group_ctr,
  62.    JDIMENSION out_row_groups_avail));
  63. };
  64. /* Coefficient buffer control */
  65. struct jpeg_c_coef_controller {
  66.   JMETHOD(void, start_pass, (j_compress_ptr cinfo, J_BUF_MODE pass_mode));
  67.   JMETHOD(boolean, compress_data, (j_compress_ptr cinfo,
  68.    JSAMPIMAGE input_buf));
  69. };
  70. /* Colorspace conversion */
  71. struct jpeg_color_converter {
  72.   JMETHOD(void, start_pass, (j_compress_ptr cinfo));
  73.   JMETHOD(void, color_convert, (j_compress_ptr cinfo,
  74. JSAMPARRAY input_buf, JSAMPIMAGE output_buf,
  75. JDIMENSION output_row, int num_rows));
  76. };
  77. /* Downsampling */
  78. struct jpeg_downsampler {
  79.   JMETHOD(void, start_pass, (j_compress_ptr cinfo));
  80.   JMETHOD(void, downsample, (j_compress_ptr cinfo,
  81.      JSAMPIMAGE input_buf, JDIMENSION in_row_index,
  82.      JSAMPIMAGE output_buf,
  83.      JDIMENSION out_row_group_index));
  84.   boolean need_context_rows; /* TRUE if need rows above & below */
  85. };
  86. /* Forward DCT (also controls coefficient quantization) */
  87. struct jpeg_forward_dct {
  88.   JMETHOD(void, start_pass, (j_compress_ptr cinfo));
  89.   /* perhaps this should be an array??? */
  90.   JMETHOD(void, forward_DCT, (j_compress_ptr cinfo,
  91.       jpeg_component_info * compptr,
  92.       JSAMPARRAY sample_data, JBLOCKROW coef_blocks,
  93.       JDIMENSION start_row, JDIMENSION start_col,
  94.       JDIMENSION num_blocks));
  95. };
  96. /* Entropy encoding */
  97. struct jpeg_entropy_encoder {
  98.   JMETHOD(void, start_pass, (j_compress_ptr cinfo, boolean gather_statistics));
  99.   JMETHOD(boolean, encode_mcu, (j_compress_ptr cinfo, JBLOCKROW *MCU_data));
  100.   JMETHOD(void, finish_pass, (j_compress_ptr cinfo));
  101. };
  102. /* Marker writing */
  103. struct jpeg_marker_writer {
  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.   /* These routines are exported to allow insertion of extra markers */
  110.   /* Probably only COM and APPn markers should be written this way */
  111.   JMETHOD(void, write_marker_header, (j_compress_ptr cinfo, int marker,
  112.       unsigned int datalen));
  113.   JMETHOD(void, write_marker_byte, (j_compress_ptr cinfo, int val));
  114. };
  115. /* Declarations for decompression modules */
  116. /* Master control module */
  117. struct jpeg_decomp_master {
  118.   JMETHOD(void, prepare_for_output_pass, (j_decompress_ptr cinfo));
  119.   JMETHOD(void, finish_output_pass, (j_decompress_ptr cinfo));
  120.   /* State variables made visible to other modules */
  121.   boolean is_dummy_pass; /* True during 1st pass for 2-pass quant */
  122. };
  123. /* Input control module */
  124. struct jpeg_input_controller {
  125.   JMETHOD(int, consume_input, (j_decompress_ptr cinfo));
  126.   JMETHOD(void, reset_input_controller, (j_decompress_ptr cinfo));
  127.   JMETHOD(void, start_input_pass, (j_decompress_ptr cinfo));
  128.   JMETHOD(void, finish_input_pass, (j_decompress_ptr cinfo));
  129.   /* State variables made visible to other modules */
  130.   boolean has_multiple_scans; /* True if file has multiple scans */
  131.   boolean eoi_reached; /* True when EOI has been consumed */
  132. };
  133. /* Main buffer control (downsampled-data buffer) */
  134. struct jpeg_d_main_controller {
  135.   JMETHOD(void, start_pass, (j_decompress_ptr cinfo, J_BUF_MODE pass_mode));
  136.   JMETHOD(void, process_data, (j_decompress_ptr cinfo,
  137.        JSAMPARRAY output_buf, JDIMENSION *out_row_ctr,
  138.        JDIMENSION out_rows_avail));
  139. };
  140. /* Coefficient buffer control */
  141. struct jpeg_d_coef_controller {
  142.   JMETHOD(void, start_input_pass, (j_decompress_ptr cinfo));
  143.   JMETHOD(int, consume_data, (j_decompress_ptr cinfo));
  144.   JMETHOD(void, start_output_pass, (j_decompress_ptr cinfo));
  145.   JMETHOD(int, decompress_data, (j_decompress_ptr cinfo,
  146.  JSAMPIMAGE output_buf));
  147.   /* Pointer to array of coefficient virtual arrays, or NULL if none */
  148.   jvirt_barray_ptr *coef_arrays;
  149. };
  150. /* Decompression postprocessing (color quantization buffer control) */
  151. struct jpeg_d_post_controller {
  152.   JMETHOD(void, start_pass, (j_decompress_ptr cinfo, J_BUF_MODE pass_mode));
  153.   JMETHOD(void, post_process_data, (j_decompress_ptr cinfo,
  154.     JSAMPIMAGE input_buf,
  155.     JDIMENSION *in_row_group_ctr,
  156.     JDIMENSION in_row_groups_avail,
  157.     JSAMPARRAY output_buf,
  158.     JDIMENSION *out_row_ctr,
  159.     JDIMENSION out_rows_avail));
  160. };
  161. /* Marker reading & parsing */
  162. struct jpeg_marker_reader {
  163.   JMETHOD(void, reset_marker_reader, (j_decompress_ptr cinfo));
  164.   /* Read markers until SOS or EOI.
  165.    * Returns same codes as are defined for jpeg_consume_input:
  166.    * JPEG_SUSPENDED, JPEG_REACHED_SOS, or JPEG_REACHED_EOI.
  167.    */
  168.   JMETHOD(int, read_markers, (j_decompress_ptr cinfo));
  169.   /* Read a restart marker --- exported for use by entropy decoder only */
  170.   jpeg_marker_parser_method read_restart_marker;
  171.   /* State of marker reader --- nominally internal, but applications
  172.    * supplying COM or APPn handlers might like to know the state.
  173.    */
  174.   boolean saw_SOI; /* found SOI? */
  175.   boolean saw_SOF; /* found SOF? */
  176.   int next_restart_num; /* next restart number expected (0-7) */
  177.   unsigned int discarded_bytes; /* # of bytes skipped looking for a marker */
  178. };
  179. /* Entropy decoding */
  180. struct jpeg_entropy_decoder {
  181.   JMETHOD(void, start_pass, (j_decompress_ptr cinfo));
  182.   JMETHOD(boolean, decode_mcu, (j_decompress_ptr cinfo,
  183. JBLOCKROW *MCU_data));
  184.   /* This is here to share code between baseline and progressive decoders; */
  185.   /* other modules probably should not use it */
  186.   boolean insufficient_data; /* set TRUE after emitting warning */
  187. };
  188. /* Inverse DCT (also performs dequantization) */
  189. typedef JMETHOD(void, inverse_DCT_method_ptr,
  190. (j_decompress_ptr cinfo, jpeg_component_info * compptr,
  191.  JCOEFPTR coef_block,
  192.  JSAMPARRAY output_buf, JDIMENSION output_col));
  193. struct jpeg_inverse_dct {
  194.   JMETHOD(void, start_pass, (j_decompress_ptr cinfo));
  195.   /* It is useful to allow each component to have a separate IDCT method. */
  196.   inverse_DCT_method_ptr inverse_DCT[MAX_COMPONENTS];
  197. };
  198. /* Upsampling (note that upsampler must also call color converter) */
  199. struct jpeg_upsampler {
  200.   JMETHOD(void, start_pass, (j_decompress_ptr cinfo));
  201.   JMETHOD(void, upsample, (j_decompress_ptr cinfo,
  202.    JSAMPIMAGE input_buf,
  203.    JDIMENSION *in_row_group_ctr,
  204.    JDIMENSION in_row_groups_avail,
  205.    JSAMPARRAY output_buf,
  206.    JDIMENSION *out_row_ctr,
  207.    JDIMENSION out_rows_avail));
  208.   boolean need_context_rows; /* TRUE if need rows above & below */
  209. };
  210. /* Colorspace conversion */
  211. struct jpeg_color_deconverter {
  212.   JMETHOD(void, start_pass, (j_decompress_ptr cinfo));
  213.   JMETHOD(void, color_convert, (j_decompress_ptr cinfo,
  214. JSAMPIMAGE input_buf, JDIMENSION input_row,
  215. JSAMPARRAY output_buf, int num_rows));
  216. };
  217. /* Color quantization or color precision reduction */
  218. struct jpeg_color_quantizer {
  219.   JMETHOD(void, start_pass, (j_decompress_ptr cinfo, boolean is_pre_scan));
  220.   JMETHOD(void, color_quantize, (j_decompress_ptr cinfo,
  221.  JSAMPARRAY input_buf, JSAMPARRAY output_buf,
  222.  int num_rows));
  223.   JMETHOD(void, finish_pass, (j_decompress_ptr cinfo));
  224.   JMETHOD(void, new_color_map, (j_decompress_ptr cinfo));
  225. };
  226. /* Miscellaneous useful macros */
  227. #undef MAX
  228. #define MAX(a,b) ((a) > (b) ? (a) : (b))
  229. #undef MIN
  230. #define MIN(a,b) ((a) < (b) ? (a) : (b))
  231. /* We assume that right shift corresponds to signed division by 2 with
  232.  * rounding towards minus infinity.  This is correct for typical "arithmetic
  233.  * shift" instructions that shift in copies of the sign bit.  But some
  234.  * C compilers implement >> with an unsigned shift.  For these machines you
  235.  * must define RIGHT_SHIFT_IS_UNSIGNED.
  236.  * RIGHT_SHIFT provides a proper signed right shift of an INT32 quantity.
  237.  * It is only applied with constant shift counts.  SHIFT_TEMPS must be
  238.  * included in the variables of any routine using RIGHT_SHIFT.
  239.  */
  240. #ifdef RIGHT_SHIFT_IS_UNSIGNED
  241. #define SHIFT_TEMPS INT32 shift_temp;
  242. #define RIGHT_SHIFT(x,shft)  
  243. ((shift_temp = (x)) < 0 ? 
  244.  (shift_temp >> (shft)) | ((~((INT32) 0)) << (32-(shft))) : 
  245.  (shift_temp >> (shft)))
  246. #else
  247. #define SHIFT_TEMPS
  248. #define RIGHT_SHIFT(x,shft) ((x) >> (shft))
  249. #endif
  250. /* Short forms of external names for systems with brain-damaged linkers. */
  251. #ifdef NEED_SHORT_EXTERNAL_NAMES
  252. #define jinit_compress_master jICompress
  253. #define jinit_c_master_control jICMaster
  254. #define jinit_c_main_controller jICMainC
  255. #define jinit_c_prep_controller jICPrepC
  256. #define jinit_c_coef_controller jICCoefC
  257. #define jinit_color_converter jICColor
  258. #define jinit_downsampler jIDownsampler
  259. #define jinit_forward_dct jIFDCT
  260. #define jinit_huff_encoder jIHEncoder
  261. #define jinit_phuff_encoder jIPHEncoder
  262. #define jinit_marker_writer jIMWriter
  263. #define jinit_master_decompress jIDMaster
  264. #define jinit_d_main_controller jIDMainC
  265. #define jinit_d_coef_controller jIDCoefC
  266. #define jinit_d_post_controller jIDPostC
  267. #define jinit_input_controller jIInCtlr
  268. #define jinit_marker_reader jIMReader
  269. #define jinit_huff_decoder jIHDecoder
  270. #define jinit_phuff_decoder jIPHDecoder
  271. #define jinit_inverse_dct jIIDCT
  272. #define jinit_upsampler jIUpsampler
  273. #define jinit_color_deconverter jIDColor
  274. #define jinit_1pass_quantizer jI1Quant
  275. #define jinit_2pass_quantizer jI2Quant
  276. #define jinit_merged_upsampler jIMUpsampler
  277. #define jinit_memory_mgr jIMemMgr
  278. #define jdiv_round_up jDivRound
  279. #define jround_up jRound
  280. #define jcopy_sample_rows jCopySamples
  281. #define jcopy_block_row jCopyBlocks
  282. #define jzero_far jZeroFar
  283. #define jpeg_zigzag_order jZIGTable
  284. #define jpeg_natural_order jZAGTable
  285. #endif /* NEED_SHORT_EXTERNAL_NAMES */
  286. /* Compression module initialization routines */
  287. EXTERN(void) jinit_compress_master JPP((j_compress_ptr cinfo));
  288. EXTERN(void) jinit_c_master_control JPP((j_compress_ptr cinfo,
  289.  boolean transcode_only));
  290. EXTERN(void) jinit_c_main_controller JPP((j_compress_ptr cinfo,
  291.   boolean need_full_buffer));
  292. EXTERN(void) jinit_c_prep_controller JPP((j_compress_ptr cinfo,
  293.   boolean need_full_buffer));
  294. EXTERN(void) jinit_c_coef_controller JPP((j_compress_ptr cinfo,
  295.   boolean need_full_buffer));
  296. EXTERN(void) jinit_color_converter JPP((j_compress_ptr cinfo));
  297. EXTERN(void) jinit_downsampler JPP((j_compress_ptr cinfo));
  298. EXTERN(void) jinit_forward_dct JPP((j_compress_ptr cinfo));
  299. EXTERN(void) jinit_huff_encoder JPP((j_compress_ptr cinfo));
  300. EXTERN(void) jinit_phuff_encoder JPP((j_compress_ptr cinfo));
  301. EXTERN(void) jinit_marker_writer JPP((j_compress_ptr cinfo));
  302. /* Decompression module initialization routines */
  303. EXTERN(void) jinit_master_decompress JPP((j_decompress_ptr cinfo));
  304. EXTERN(void) jinit_d_main_controller JPP((j_decompress_ptr cinfo,
  305.   boolean need_full_buffer));
  306. EXTERN(void) jinit_d_coef_controller JPP((j_decompress_ptr cinfo,
  307.   boolean need_full_buffer));
  308. EXTERN(void) jinit_d_post_controller JPP((j_decompress_ptr cinfo,
  309.   boolean need_full_buffer));
  310. EXTERN(void) jinit_input_controller JPP((j_decompress_ptr cinfo));
  311. EXTERN(void) jinit_marker_reader JPP((j_decompress_ptr cinfo));
  312. EXTERN(void) jinit_huff_decoder JPP((j_decompress_ptr cinfo));
  313. EXTERN(void) jinit_phuff_decoder JPP((j_decompress_ptr cinfo));
  314. EXTERN(void) jinit_inverse_dct JPP((j_decompress_ptr cinfo));
  315. EXTERN(void) jinit_upsampler JPP((j_decompress_ptr cinfo));
  316. EXTERN(void) jinit_color_deconverter JPP((j_decompress_ptr cinfo));
  317. EXTERN(void) jinit_1pass_quantizer JPP((j_decompress_ptr cinfo));
  318. EXTERN(void) jinit_2pass_quantizer JPP((j_decompress_ptr cinfo));
  319. EXTERN(void) jinit_merged_upsampler JPP((j_decompress_ptr cinfo));
  320. /* Memory manager initialization */
  321. EXTERN(void) jinit_memory_mgr JPP((j_common_ptr cinfo));
  322. /* Utility routines in jutils.c */
  323. EXTERN(long) jdiv_round_up JPP((long a, long b));
  324. EXTERN(long) jround_up JPP((long a, long b));
  325. EXTERN(void) jcopy_sample_rows JPP((JSAMPARRAY input_array, int source_row,
  326.     JSAMPARRAY output_array, int dest_row,
  327.     int num_rows, JDIMENSION num_cols));
  328. EXTERN(void) jcopy_block_row JPP((JBLOCKROW input_row, JBLOCKROW output_row,
  329.   JDIMENSION num_blocks));
  330. EXTERN(void) jzero_far JPP((void FAR * target, size_t bytestozero));
  331. /* Constant tables in jutils.c */
  332. #if 0 /* This table is not actually needed in v6a */
  333. extern const int jpeg_zigzag_order[]; /* natural coef order to zigzag order */
  334. #endif
  335. extern const int jpeg_natural_order[]; /* zigzag coef order to natural order */
  336. /* Suppress undefined-structure complaints if necessary. */
  337. #ifdef INCOMPLETE_TYPES_BROKEN
  338. #ifndef AM_MEMORY_MANAGER /* only jmemmgr.c defines these */
  339. struct jvirt_sarray_control { long dummy; };
  340. struct jvirt_barray_control { long dummy; };
  341. #endif
  342. #endif /* INCOMPLETE_TYPES_BROKEN */