jcphuff.c
上传用户:tongfa
上传日期:2007-01-06
资源大小:1071k
文件大小:25k
源码类别:

图片显示

开发平台:

WINDOWS

  1. /*
  2.  * jcphuff.c
  3.  *
  4.  * Copyright (C) 1995-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 contains Huffman entropy encoding routines for progressive JPEG.
  9.  *
  10.  * We do not support output suspension in this module, since the library
  11.  * currently does not allow multiple-scan files to be written with output
  12.  * suspension.
  13.  */
  14. #define JPEG_INTERNALS
  15. #include "jinclude.h"
  16. #include "jpeglib.h"
  17. #include "jchuff.h" /* Declarations shared with jchuff.c */
  18. #ifdef C_PROGRESSIVE_SUPPORTED
  19. /* Expanded entropy encoder object for progressive Huffman encoding. */
  20. typedef struct {
  21.   struct jpeg_entropy_encoder pub; /* public fields */
  22.   /* Mode flag: TRUE for optimization, FALSE for actual data output */
  23.   boolean gather_statistics;
  24.   /* Bit-level coding status.
  25.    * next_output_byte/free_in_buffer are local copies of cinfo->dest fields.
  26.    */
  27.   JOCTET * next_output_byte; /* => next byte to write in buffer */
  28.   size_t free_in_buffer; /* # of byte spaces remaining in buffer */
  29.   INT32 put_buffer; /* current bit-accumulation buffer */
  30.   int put_bits; /* # of bits now in it */
  31.   j_compress_ptr cinfo; /* link to cinfo (needed for dump_buffer) */
  32.   /* Coding status for DC components */
  33.   int last_dc_val[MAX_COMPS_IN_SCAN]; /* last DC coef for each component */
  34.   /* Coding status for AC components */
  35.   int ac_tbl_no; /* the table number of the single component */
  36.   unsigned int EOBRUN; /* run length of EOBs */
  37.   unsigned int BE; /* # of buffered correction bits before MCU */
  38.   char * bit_buffer; /* buffer for correction bits (1 per char) */
  39.   /* packing correction bits tightly would save some space but cost time... */
  40.   unsigned int restarts_to_go; /* MCUs left in this restart interval */
  41.   int next_restart_num; /* next restart number to write (0-7) */
  42.   /* Pointers to derived tables (these workspaces have image lifespan).
  43.    * Since any one scan codes only DC or only AC, we only need one set
  44.    * of tables, not one for DC and one for AC.
  45.    */
  46.   c_derived_tbl * derived_tbls[NUM_HUFF_TBLS];
  47.   /* Statistics tables for optimization; again, one set is enough */
  48.   long * count_ptrs[NUM_HUFF_TBLS];
  49. } phuff_entropy_encoder;
  50. typedef phuff_entropy_encoder * phuff_entropy_ptr;
  51. /* MAX_CORR_BITS is the number of bits the AC refinement correction-bit
  52.  * buffer can hold.  Larger sizes may slightly improve compression, but
  53.  * 1000 is already well into the realm of overkill.
  54.  * The minimum safe size is 64 bits.
  55.  */
  56. #define MAX_CORR_BITS  1000 /* Max # of correction bits I can buffer */
  57. /* IRIGHT_SHIFT is like RIGHT_SHIFT, but works on int rather than INT32.
  58.  * We assume that int right shift is unsigned if INT32 right shift is,
  59.  * which should be safe.
  60.  */
  61. #ifdef RIGHT_SHIFT_IS_UNSIGNED
  62. #define ISHIFT_TEMPS int ishift_temp;
  63. #define IRIGHT_SHIFT(x,shft)  
  64. ((ishift_temp = (x)) < 0 ? 
  65.  (ishift_temp >> (shft)) | ((~0) << (16-(shft))) : 
  66.  (ishift_temp >> (shft)))
  67. #else
  68. #define ISHIFT_TEMPS
  69. #define IRIGHT_SHIFT(x,shft) ((x) >> (shft))
  70. #endif
  71. /* Forward declarations */
  72. METHODDEF(boolean) encode_mcu_DC_first JPP((j_compress_ptr cinfo,
  73.     JBLOCKROW *MCU_data));
  74. METHODDEF(boolean) encode_mcu_AC_first JPP((j_compress_ptr cinfo,
  75.     JBLOCKROW *MCU_data));
  76. METHODDEF(boolean) encode_mcu_DC_refine JPP((j_compress_ptr cinfo,
  77.      JBLOCKROW *MCU_data));
  78. METHODDEF(boolean) encode_mcu_AC_refine JPP((j_compress_ptr cinfo,
  79.      JBLOCKROW *MCU_data));
  80. METHODDEF(void) finish_pass_phuff JPP((j_compress_ptr cinfo));
  81. METHODDEF(void) finish_pass_gather_phuff JPP((j_compress_ptr cinfo));
  82. /*
  83.  * Initialize for a Huffman-compressed scan using progressive JPEG.
  84.  */
  85. METHODDEF(void)
  86. start_pass_phuff (j_compress_ptr cinfo, boolean gather_statistics)
  87. {  
  88.   phuff_entropy_ptr entropy = (phuff_entropy_ptr) cinfo->entropy;
  89.   boolean is_DC_band;
  90.   int ci, tbl;
  91.   jpeg_component_info * compptr;
  92.   entropy->cinfo = cinfo;
  93.   entropy->gather_statistics = gather_statistics;
  94.   is_DC_band = (cinfo->Ss == 0);
  95.   /* We assume jcmaster.c already validated the scan parameters. */
  96.   /* Select execution routines */
  97.   if (cinfo->Ah == 0) {
  98.     if (is_DC_band)
  99.       entropy->pub.encode_mcu = encode_mcu_DC_first;
  100.     else
  101.       entropy->pub.encode_mcu = encode_mcu_AC_first;
  102.   } else {
  103.     if (is_DC_band)
  104.       entropy->pub.encode_mcu = encode_mcu_DC_refine;
  105.     else {
  106.       entropy->pub.encode_mcu = encode_mcu_AC_refine;
  107.       /* AC refinement needs a correction bit buffer */
  108.       if (entropy->bit_buffer == NULL)
  109. entropy->bit_buffer = (char *)
  110.   (*cinfo->mem->alloc_small) ((j_common_ptr) cinfo, JPOOL_IMAGE,
  111.       MAX_CORR_BITS * SIZEOF(char));
  112.     }
  113.   }
  114.   if (gather_statistics)
  115.     entropy->pub.finish_pass = finish_pass_gather_phuff;
  116.   else
  117.     entropy->pub.finish_pass = finish_pass_phuff;
  118.   /* Only DC coefficients may be interleaved, so cinfo->comps_in_scan = 1
  119.    * for AC coefficients.
  120.    */
  121.   for (ci = 0; ci < cinfo->comps_in_scan; ci++) {
  122.     compptr = cinfo->cur_comp_info[ci];
  123.     /* Initialize DC predictions to 0 */
  124.     entropy->last_dc_val[ci] = 0;
  125.     /* Get table index */
  126.     if (is_DC_band) {
  127.       if (cinfo->Ah != 0) /* DC refinement needs no table */
  128. continue;
  129.       tbl = compptr->dc_tbl_no;
  130.     } else {
  131.       entropy->ac_tbl_no = tbl = compptr->ac_tbl_no;
  132.     }
  133.     if (gather_statistics) {
  134.       /* Check for invalid table index */
  135.       /* (make_c_derived_tbl does this in the other path) */
  136.       if (tbl < 0 || tbl >= NUM_HUFF_TBLS)
  137.         ERREXIT1(cinfo, JERR_NO_HUFF_TABLE, tbl);
  138.       /* Allocate and zero the statistics tables */
  139.       /* Note that jpeg_gen_optimal_table expects 257 entries in each table! */
  140.       if (entropy->count_ptrs[tbl] == NULL)
  141. entropy->count_ptrs[tbl] = (long *)
  142.   (*cinfo->mem->alloc_small) ((j_common_ptr) cinfo, JPOOL_IMAGE,
  143.       257 * SIZEOF(long));
  144.       MEMZERO(entropy->count_ptrs[tbl], 257 * SIZEOF(long));
  145.     } else {
  146.       /* Compute derived values for Huffman table */
  147.       /* We may do this more than once for a table, but it's not expensive */
  148.       jpeg_make_c_derived_tbl(cinfo, is_DC_band, tbl,
  149.       & entropy->derived_tbls[tbl]);
  150.     }
  151.   }
  152.   /* Initialize AC stuff */
  153.   entropy->EOBRUN = 0;
  154.   entropy->BE = 0;
  155.   /* Initialize bit buffer to empty */
  156.   entropy->put_buffer = 0;
  157.   entropy->put_bits = 0;
  158.   /* Initialize restart stuff */
  159.   entropy->restarts_to_go = cinfo->restart_interval;
  160.   entropy->next_restart_num = 0;
  161. }
  162. /* Outputting bytes to the file.
  163.  * NB: these must be called only when actually outputting,
  164.  * that is, entropy->gather_statistics == FALSE.
  165.  */
  166. /* Emit a byte */
  167. #define emit_byte(entropy,val)  
  168. { *(entropy)->next_output_byte++ = (JOCTET) (val);  
  169.   if (--(entropy)->free_in_buffer == 0)  
  170.     dump_buffer(entropy); }
  171. LOCAL(void)
  172. dump_buffer (phuff_entropy_ptr entropy)
  173. /* Empty the output buffer; we do not support suspension in this module. */
  174. {
  175.   struct jpeg_destination_mgr * dest = entropy->cinfo->dest;
  176.   if (! (*dest->empty_output_buffer) (entropy->cinfo))
  177.     ERREXIT(entropy->cinfo, JERR_CANT_SUSPEND);
  178.   /* After a successful buffer dump, must reset buffer pointers */
  179.   entropy->next_output_byte = dest->next_output_byte;
  180.   entropy->free_in_buffer = dest->free_in_buffer;
  181. }
  182. /* Outputting bits to the file */
  183. /* Only the right 24 bits of put_buffer are used; the valid bits are
  184.  * left-justified in this part.  At most 16 bits can be passed to emit_bits
  185.  * in one call, and we never retain more than 7 bits in put_buffer
  186.  * between calls, so 24 bits are sufficient.
  187.  */
  188. INLINE
  189. LOCAL(void)
  190. emit_bits (phuff_entropy_ptr entropy, unsigned int code, int size)
  191. /* Emit some bits, unless we are in gather mode */
  192. {
  193.   /* This routine is heavily used, so it's worth coding tightly. */
  194.   register INT32 put_buffer = (INT32) code;
  195.   register int put_bits = entropy->put_bits;
  196.   /* if size is 0, caller used an invalid Huffman table entry */
  197.   if (size == 0)
  198.     ERREXIT(entropy->cinfo, JERR_HUFF_MISSING_CODE);
  199.   if (entropy->gather_statistics)
  200.     return; /* do nothing if we're only getting stats */
  201.   put_buffer &= (((INT32) 1)<<size) - 1; /* mask off any extra bits in code */
  202.   
  203.   put_bits += size; /* new number of bits in buffer */
  204.   
  205.   put_buffer <<= 24 - put_bits; /* align incoming bits */
  206.   put_buffer |= entropy->put_buffer; /* and merge with old buffer contents */
  207.   while (put_bits >= 8) {
  208.     int c = (int) ((put_buffer >> 16) & 0xFF);
  209.     
  210.     emit_byte(entropy, c);
  211.     if (c == 0xFF) { /* need to stuff a zero byte? */
  212.       emit_byte(entropy, 0);
  213.     }
  214.     put_buffer <<= 8;
  215.     put_bits -= 8;
  216.   }
  217.   entropy->put_buffer = put_buffer; /* update variables */
  218.   entropy->put_bits = put_bits;
  219. }
  220. LOCAL(void)
  221. flush_bits (phuff_entropy_ptr entropy)
  222. {
  223.   emit_bits(entropy, 0x7F, 7); /* fill any partial byte with ones */
  224.   entropy->put_buffer = 0;     /* and reset bit-buffer to empty */
  225.   entropy->put_bits = 0;
  226. }
  227. /*
  228.  * Emit (or just count) a Huffman symbol.
  229.  */
  230. INLINE
  231. LOCAL(void)
  232. emit_symbol (phuff_entropy_ptr entropy, int tbl_no, int symbol)
  233. {
  234.   if (entropy->gather_statistics)
  235.     entropy->count_ptrs[tbl_no][symbol]++;
  236.   else {
  237.     c_derived_tbl * tbl = entropy->derived_tbls[tbl_no];
  238.     emit_bits(entropy, tbl->ehufco[symbol], tbl->ehufsi[symbol]);
  239.   }
  240. }
  241. /*
  242.  * Emit bits from a correction bit buffer.
  243.  */
  244. LOCAL(void)
  245. emit_buffered_bits (phuff_entropy_ptr entropy, char * bufstart,
  246.     unsigned int nbits)
  247. {
  248.   if (entropy->gather_statistics)
  249.     return; /* no real work */
  250.   while (nbits > 0) {
  251.     emit_bits(entropy, (unsigned int) (*bufstart), 1);
  252.     bufstart++;
  253.     nbits--;
  254.   }
  255. }
  256. /*
  257.  * Emit any pending EOBRUN symbol.
  258.  */
  259. LOCAL(void)
  260. emit_eobrun (phuff_entropy_ptr entropy)
  261. {
  262.   register int temp, nbits;
  263.   if (entropy->EOBRUN > 0) { /* if there is any pending EOBRUN */
  264.     temp = entropy->EOBRUN;
  265.     nbits = 0;
  266.     while ((temp >>= 1))
  267.       nbits++;
  268.     /* safety check: shouldn't happen given limited correction-bit buffer */
  269.     if (nbits > 14)
  270.       ERREXIT(entropy->cinfo, JERR_HUFF_MISSING_CODE);
  271.     emit_symbol(entropy, entropy->ac_tbl_no, nbits << 4);
  272.     if (nbits)
  273.       emit_bits(entropy, entropy->EOBRUN, nbits);
  274.     entropy->EOBRUN = 0;
  275.     /* Emit any buffered correction bits */
  276.     emit_buffered_bits(entropy, entropy->bit_buffer, entropy->BE);
  277.     entropy->BE = 0;
  278.   }
  279. }
  280. /*
  281.  * Emit a restart marker & resynchronize predictions.
  282.  */
  283. LOCAL(void)
  284. emit_restart (phuff_entropy_ptr entropy, int restart_num)
  285. {
  286.   int ci;
  287.   emit_eobrun(entropy);
  288.   if (! entropy->gather_statistics) {
  289.     flush_bits(entropy);
  290.     emit_byte(entropy, 0xFF);
  291.     emit_byte(entropy, JPEG_RST0 + restart_num);
  292.   }
  293.   if (entropy->cinfo->Ss == 0) {
  294.     /* Re-initialize DC predictions to 0 */
  295.     for (ci = 0; ci < entropy->cinfo->comps_in_scan; ci++)
  296.       entropy->last_dc_val[ci] = 0;
  297.   } else {
  298.     /* Re-initialize all AC-related fields to 0 */
  299.     entropy->EOBRUN = 0;
  300.     entropy->BE = 0;
  301.   }
  302. }
  303. /*
  304.  * MCU encoding for DC initial scan (either spectral selection,
  305.  * or first pass of successive approximation).
  306.  */
  307. METHODDEF(boolean)
  308. encode_mcu_DC_first (j_compress_ptr cinfo, JBLOCKROW *MCU_data)
  309. {
  310.   phuff_entropy_ptr entropy = (phuff_entropy_ptr) cinfo->entropy;
  311.   register int temp, temp2;
  312.   register int nbits;
  313.   int blkn, ci;
  314.   int Al = cinfo->Al;
  315.   JBLOCKROW block;
  316.   jpeg_component_info * compptr;
  317.   ISHIFT_TEMPS
  318.   entropy->next_output_byte = cinfo->dest->next_output_byte;
  319.   entropy->free_in_buffer = cinfo->dest->free_in_buffer;
  320.   /* Emit restart marker if needed */
  321.   if (cinfo->restart_interval)
  322.     if (entropy->restarts_to_go == 0)
  323.       emit_restart(entropy, entropy->next_restart_num);
  324.   /* Encode the MCU data blocks */
  325.   for (blkn = 0; blkn < cinfo->blocks_in_MCU; blkn++) {
  326.     block = MCU_data[blkn];
  327.     ci = cinfo->MCU_membership[blkn];
  328.     compptr = cinfo->cur_comp_info[ci];
  329.     /* Compute the DC value after the required point transform by Al.
  330.      * This is simply an arithmetic right shift.
  331.      */
  332.     temp2 = IRIGHT_SHIFT((int) ((*block)[0]), Al);
  333.     /* DC differences are figured on the point-transformed values. */
  334.     temp = temp2 - entropy->last_dc_val[ci];
  335.     entropy->last_dc_val[ci] = temp2;
  336.     /* Encode the DC coefficient difference per section G.1.2.1 */
  337.     temp2 = temp;
  338.     if (temp < 0) {
  339.       temp = -temp; /* temp is abs value of input */
  340.       /* For a negative input, want temp2 = bitwise complement of abs(input) */
  341.       /* This code assumes we are on a two's complement machine */
  342.       temp2--;
  343.     }
  344.     
  345.     /* Find the number of bits needed for the magnitude of the coefficient */
  346.     nbits = 0;
  347.     while (temp) {
  348.       nbits++;
  349.       temp >>= 1;
  350.     }
  351.     /* Check for out-of-range coefficient values.
  352.      * Since we're encoding a difference, the range limit is twice as much.
  353.      */
  354.     if (nbits > MAX_COEF_BITS+1)
  355.       ERREXIT(cinfo, JERR_BAD_DCT_COEF);
  356.     
  357.     /* Count/emit the Huffman-coded symbol for the number of bits */
  358.     emit_symbol(entropy, compptr->dc_tbl_no, nbits);
  359.     
  360.     /* Emit that number of bits of the value, if positive, */
  361.     /* or the complement of its magnitude, if negative. */
  362.     if (nbits) /* emit_bits rejects calls with size 0 */
  363.       emit_bits(entropy, (unsigned int) temp2, nbits);
  364.   }
  365.   cinfo->dest->next_output_byte = entropy->next_output_byte;
  366.   cinfo->dest->free_in_buffer = entropy->free_in_buffer;
  367.   /* Update restart-interval state too */
  368.   if (cinfo->restart_interval) {
  369.     if (entropy->restarts_to_go == 0) {
  370.       entropy->restarts_to_go = cinfo->restart_interval;
  371.       entropy->next_restart_num++;
  372.       entropy->next_restart_num &= 7;
  373.     }
  374.     entropy->restarts_to_go--;
  375.   }
  376.   return TRUE;
  377. }
  378. /*
  379.  * MCU encoding for AC initial scan (either spectral selection,
  380.  * or first pass of successive approximation).
  381.  */
  382. METHODDEF(boolean)
  383. encode_mcu_AC_first (j_compress_ptr cinfo, JBLOCKROW *MCU_data)
  384. {
  385.   phuff_entropy_ptr entropy = (phuff_entropy_ptr) cinfo->entropy;
  386.   register int temp, temp2;
  387.   register int nbits;
  388.   register int r, k;
  389.   int Se = cinfo->Se;
  390.   int Al = cinfo->Al;
  391.   JBLOCKROW block;
  392.   entropy->next_output_byte = cinfo->dest->next_output_byte;
  393.   entropy->free_in_buffer = cinfo->dest->free_in_buffer;
  394.   /* Emit restart marker if needed */
  395.   if (cinfo->restart_interval)
  396.     if (entropy->restarts_to_go == 0)
  397.       emit_restart(entropy, entropy->next_restart_num);
  398.   /* Encode the MCU data block */
  399.   block = MCU_data[0];
  400.   /* Encode the AC coefficients per section G.1.2.2, fig. G.3 */
  401.   
  402.   r = 0; /* r = run length of zeros */
  403.    
  404.   for (k = cinfo->Ss; k <= Se; k++) {
  405.     if ((temp = (*block)[jpeg_natural_order[k]]) == 0) {
  406.       r++;
  407.       continue;
  408.     }
  409.     /* We must apply the point transform by Al.  For AC coefficients this
  410.      * is an integer division with rounding towards 0.  To do this portably
  411.      * in C, we shift after obtaining the absolute value; so the code is
  412.      * interwoven with finding the abs value (temp) and output bits (temp2).
  413.      */
  414.     if (temp < 0) {
  415.       temp = -temp; /* temp is abs value of input */
  416.       temp >>= Al; /* apply the point transform */
  417.       /* For a negative coef, want temp2 = bitwise complement of abs(coef) */
  418.       temp2 = ~temp;
  419.     } else {
  420.       temp >>= Al; /* apply the point transform */
  421.       temp2 = temp;
  422.     }
  423.     /* Watch out for case that nonzero coef is zero after point transform */
  424.     if (temp == 0) {
  425.       r++;
  426.       continue;
  427.     }
  428.     /* Emit any pending EOBRUN */
  429.     if (entropy->EOBRUN > 0)
  430.       emit_eobrun(entropy);
  431.     /* if run length > 15, must emit special run-length-16 codes (0xF0) */
  432.     while (r > 15) {
  433.       emit_symbol(entropy, entropy->ac_tbl_no, 0xF0);
  434.       r -= 16;
  435.     }
  436.     /* Find the number of bits needed for the magnitude of the coefficient */
  437.     nbits = 1; /* there must be at least one 1 bit */
  438.     while ((temp >>= 1))
  439.       nbits++;
  440.     /* Check for out-of-range coefficient values */
  441.     if (nbits > MAX_COEF_BITS)
  442.       ERREXIT(cinfo, JERR_BAD_DCT_COEF);
  443.     /* Count/emit Huffman symbol for run length / number of bits */
  444.     emit_symbol(entropy, entropy->ac_tbl_no, (r << 4) + nbits);
  445.     /* Emit that number of bits of the value, if positive, */
  446.     /* or the complement of its magnitude, if negative. */
  447.     emit_bits(entropy, (unsigned int) temp2, nbits);
  448.     r = 0; /* reset zero run length */
  449.   }
  450.   if (r > 0) { /* If there are trailing zeroes, */
  451.     entropy->EOBRUN++; /* count an EOB */
  452.     if (entropy->EOBRUN == 0x7FFF)
  453.       emit_eobrun(entropy); /* force it out to avoid overflow */
  454.   }
  455.   cinfo->dest->next_output_byte = entropy->next_output_byte;
  456.   cinfo->dest->free_in_buffer = entropy->free_in_buffer;
  457.   /* Update restart-interval state too */
  458.   if (cinfo->restart_interval) {
  459.     if (entropy->restarts_to_go == 0) {
  460.       entropy->restarts_to_go = cinfo->restart_interval;
  461.       entropy->next_restart_num++;
  462.       entropy->next_restart_num &= 7;
  463.     }
  464.     entropy->restarts_to_go--;
  465.   }
  466.   return TRUE;
  467. }
  468. /*
  469.  * MCU encoding for DC successive approximation refinement scan.
  470.  * Note: we assume such scans can be multi-component, although the spec
  471.  * is not very clear on the point.
  472.  */
  473. METHODDEF(boolean)
  474. encode_mcu_DC_refine (j_compress_ptr cinfo, JBLOCKROW *MCU_data)
  475. {
  476.   phuff_entropy_ptr entropy = (phuff_entropy_ptr) cinfo->entropy;
  477.   register int temp;
  478.   int blkn;
  479.   int Al = cinfo->Al;
  480.   JBLOCKROW block;
  481.   entropy->next_output_byte = cinfo->dest->next_output_byte;
  482.   entropy->free_in_buffer = cinfo->dest->free_in_buffer;
  483.   /* Emit restart marker if needed */
  484.   if (cinfo->restart_interval)
  485.     if (entropy->restarts_to_go == 0)
  486.       emit_restart(entropy, entropy->next_restart_num);
  487.   /* Encode the MCU data blocks */
  488.   for (blkn = 0; blkn < cinfo->blocks_in_MCU; blkn++) {
  489.     block = MCU_data[blkn];
  490.     /* We simply emit the Al'th bit of the DC coefficient value. */
  491.     temp = (*block)[0];
  492.     emit_bits(entropy, (unsigned int) (temp >> Al), 1);
  493.   }
  494.   cinfo->dest->next_output_byte = entropy->next_output_byte;
  495.   cinfo->dest->free_in_buffer = entropy->free_in_buffer;
  496.   /* Update restart-interval state too */
  497.   if (cinfo->restart_interval) {
  498.     if (entropy->restarts_to_go == 0) {
  499.       entropy->restarts_to_go = cinfo->restart_interval;
  500.       entropy->next_restart_num++;
  501.       entropy->next_restart_num &= 7;
  502.     }
  503.     entropy->restarts_to_go--;
  504.   }
  505.   return TRUE;
  506. }
  507. /*
  508.  * MCU encoding for AC successive approximation refinement scan.
  509.  */
  510. METHODDEF(boolean)
  511. encode_mcu_AC_refine (j_compress_ptr cinfo, JBLOCKROW *MCU_data)
  512. {
  513.   phuff_entropy_ptr entropy = (phuff_entropy_ptr) cinfo->entropy;
  514.   register int temp;
  515.   register int r, k;
  516.   int EOB;
  517.   char *BR_buffer;
  518.   unsigned int BR;
  519.   int Se = cinfo->Se;
  520.   int Al = cinfo->Al;
  521.   JBLOCKROW block;
  522.   int absvalues[DCTSIZE2];
  523.   entropy->next_output_byte = cinfo->dest->next_output_byte;
  524.   entropy->free_in_buffer = cinfo->dest->free_in_buffer;
  525.   /* Emit restart marker if needed */
  526.   if (cinfo->restart_interval)
  527.     if (entropy->restarts_to_go == 0)
  528.       emit_restart(entropy, entropy->next_restart_num);
  529.   /* Encode the MCU data block */
  530.   block = MCU_data[0];
  531.   /* It is convenient to make a pre-pass to determine the transformed
  532.    * coefficients' absolute values and the EOB position.
  533.    */
  534.   EOB = 0;
  535.   for (k = cinfo->Ss; k <= Se; k++) {
  536.     temp = (*block)[jpeg_natural_order[k]];
  537.     /* We must apply the point transform by Al.  For AC coefficients this
  538.      * is an integer division with rounding towards 0.  To do this portably
  539.      * in C, we shift after obtaining the absolute value.
  540.      */
  541.     if (temp < 0)
  542.       temp = -temp; /* temp is abs value of input */
  543.     temp >>= Al; /* apply the point transform */
  544.     absvalues[k] = temp; /* save abs value for main pass */
  545.     if (temp == 1)
  546.       EOB = k; /* EOB = index of last newly-nonzero coef */
  547.   }
  548.   /* Encode the AC coefficients per section G.1.2.3, fig. G.7 */
  549.   
  550.   r = 0; /* r = run length of zeros */
  551.   BR = 0; /* BR = count of buffered bits added now */
  552.   BR_buffer = entropy->bit_buffer + entropy->BE; /* Append bits to buffer */
  553.   for (k = cinfo->Ss; k <= Se; k++) {
  554.     if ((temp = absvalues[k]) == 0) {
  555.       r++;
  556.       continue;
  557.     }
  558.     /* Emit any required ZRLs, but not if they can be folded into EOB */
  559.     while (r > 15 && k <= EOB) {
  560.       /* emit any pending EOBRUN and the BE correction bits */
  561.       emit_eobrun(entropy);
  562.       /* Emit ZRL */
  563.       emit_symbol(entropy, entropy->ac_tbl_no, 0xF0);
  564.       r -= 16;
  565.       /* Emit buffered correction bits that must be associated with ZRL */
  566.       emit_buffered_bits(entropy, BR_buffer, BR);
  567.       BR_buffer = entropy->bit_buffer; /* BE bits are gone now */
  568.       BR = 0;
  569.     }
  570.     /* If the coef was previously nonzero, it only needs a correction bit.
  571.      * NOTE: a straight translation of the spec's figure G.7 would suggest
  572.      * that we also need to test r > 15.  But if r > 15, we can only get here
  573.      * if k > EOB, which implies that this coefficient is not 1.
  574.      */
  575.     if (temp > 1) {
  576.       /* The correction bit is the next bit of the absolute value. */
  577.       BR_buffer[BR++] = (char) (temp & 1);
  578.       continue;
  579.     }
  580.     /* Emit any pending EOBRUN and the BE correction bits */
  581.     emit_eobrun(entropy);
  582.     /* Count/emit Huffman symbol for run length / number of bits */
  583.     emit_symbol(entropy, entropy->ac_tbl_no, (r << 4) + 1);
  584.     /* Emit output bit for newly-nonzero coef */
  585.     temp = ((*block)[jpeg_natural_order[k]] < 0) ? 0 : 1;
  586.     emit_bits(entropy, (unsigned int) temp, 1);
  587.     /* Emit buffered correction bits that must be associated with this code */
  588.     emit_buffered_bits(entropy, BR_buffer, BR);
  589.     BR_buffer = entropy->bit_buffer; /* BE bits are gone now */
  590.     BR = 0;
  591.     r = 0; /* reset zero run length */
  592.   }
  593.   if (r > 0 || BR > 0) { /* If there are trailing zeroes, */
  594.     entropy->EOBRUN++; /* count an EOB */
  595.     entropy->BE += BR; /* concat my correction bits to older ones */
  596.     /* We force out the EOB if we risk either:
  597.      * 1. overflow of the EOB counter;
  598.      * 2. overflow of the correction bit buffer during the next MCU.
  599.      */
  600.     if (entropy->EOBRUN == 0x7FFF || entropy->BE > (MAX_CORR_BITS-DCTSIZE2+1))
  601.       emit_eobrun(entropy);
  602.   }
  603.   cinfo->dest->next_output_byte = entropy->next_output_byte;
  604.   cinfo->dest->free_in_buffer = entropy->free_in_buffer;
  605.   /* Update restart-interval state too */
  606.   if (cinfo->restart_interval) {
  607.     if (entropy->restarts_to_go == 0) {
  608.       entropy->restarts_to_go = cinfo->restart_interval;
  609.       entropy->next_restart_num++;
  610.       entropy->next_restart_num &= 7;
  611.     }
  612.     entropy->restarts_to_go--;
  613.   }
  614.   return TRUE;
  615. }
  616. /*
  617.  * Finish up at the end of a Huffman-compressed progressive scan.
  618.  */
  619. METHODDEF(void)
  620. finish_pass_phuff (j_compress_ptr cinfo)
  621. {   
  622.   phuff_entropy_ptr entropy = (phuff_entropy_ptr) cinfo->entropy;
  623.   entropy->next_output_byte = cinfo->dest->next_output_byte;
  624.   entropy->free_in_buffer = cinfo->dest->free_in_buffer;
  625.   /* Flush out any buffered data */
  626.   emit_eobrun(entropy);
  627.   flush_bits(entropy);
  628.   cinfo->dest->next_output_byte = entropy->next_output_byte;
  629.   cinfo->dest->free_in_buffer = entropy->free_in_buffer;
  630. }
  631. /*
  632.  * Finish up a statistics-gathering pass and create the new Huffman tables.
  633.  */
  634. METHODDEF(void)
  635. finish_pass_gather_phuff (j_compress_ptr cinfo)
  636. {
  637.   phuff_entropy_ptr entropy = (phuff_entropy_ptr) cinfo->entropy;
  638.   boolean is_DC_band;
  639.   int ci, tbl;
  640.   jpeg_component_info * compptr;
  641.   JHUFF_TBL **htblptr;
  642.   boolean did[NUM_HUFF_TBLS];
  643.   /* Flush out buffered data (all we care about is counting the EOB symbol) */
  644.   emit_eobrun(entropy);
  645.   is_DC_band = (cinfo->Ss == 0);
  646.   /* It's important not to apply jpeg_gen_optimal_table more than once
  647.    * per table, because it clobbers the input frequency counts!
  648.    */
  649.   MEMZERO(did, SIZEOF(did));
  650.   for (ci = 0; ci < cinfo->comps_in_scan; ci++) {
  651.     compptr = cinfo->cur_comp_info[ci];
  652.     if (is_DC_band) {
  653.       if (cinfo->Ah != 0) /* DC refinement needs no table */
  654. continue;
  655.       tbl = compptr->dc_tbl_no;
  656.     } else {
  657.       tbl = compptr->ac_tbl_no;
  658.     }
  659.     if (! did[tbl]) {
  660.       if (is_DC_band)
  661.         htblptr = & cinfo->dc_huff_tbl_ptrs[tbl];
  662.       else
  663.         htblptr = & cinfo->ac_huff_tbl_ptrs[tbl];
  664.       if (*htblptr == NULL)
  665.         *htblptr = jpeg_alloc_huff_table((j_common_ptr) cinfo);
  666.       jpeg_gen_optimal_table(cinfo, *htblptr, entropy->count_ptrs[tbl]);
  667.       did[tbl] = TRUE;
  668.     }
  669.   }
  670. }
  671. /*
  672.  * Module initialization routine for progressive Huffman entropy encoding.
  673.  */
  674. GLOBAL(void)
  675. jinit_phuff_encoder (j_compress_ptr cinfo)
  676. {
  677.   phuff_entropy_ptr entropy;
  678.   int i;
  679.   entropy = (phuff_entropy_ptr)
  680.     (*cinfo->mem->alloc_small) ((j_common_ptr) cinfo, JPOOL_IMAGE,
  681. SIZEOF(phuff_entropy_encoder));
  682.   cinfo->entropy = (struct jpeg_entropy_encoder *) entropy;
  683.   entropy->pub.start_pass = start_pass_phuff;
  684.   /* Mark tables unallocated */
  685.   for (i = 0; i < NUM_HUFF_TBLS; i++) {
  686.     entropy->derived_tbls[i] = NULL;
  687.     entropy->count_ptrs[i] = NULL;
  688.   }
  689.   entropy->bit_buffer = NULL; /* needed only in AC refinement scan */
  690. }
  691. #endif /* C_PROGRESSIVE_SUPPORTED */