JCPARAM.c
上传用户:qiutianh
上传日期:2022-08-08
资源大小:939k
文件大小:21k
源码类别:

图形图象

开发平台:

Visual C++

  1. ////////////////////////////////////////////////////////////////////////
  2. //
  3. // Note : this file is included as part of the Smaller Animals Software
  4. // JpegFile package. Though this file has not been modified from it's 
  5. // original IJG 6a form, it is not the responsibility on the Independent
  6. // JPEG Group to answer questions regarding this code.
  7. //
  8. // Any questions you have about this code should be addressed to :
  9. //
  10. // CHRISDL@PAGESZ.NET - the distributor of this package.
  11. //
  12. // Remember, by including this code in the JpegFile package, Smaller 
  13. // Animals Software assumes all responsibilities for answering questions
  14. // about it. If we (SA Software) can't answer your questions ourselves, we 
  15. // will direct you to people who can.
  16. //
  17. // Thanks, CDL.
  18. //
  19. ////////////////////////////////////////////////////////////////////////
  20. /*
  21.  * jcparam.c
  22.  *
  23.  * Copyright (C) 1991-1996, Thomas G. Lane.
  24.  * This file is part of the Independent JPEG Group's software.
  25.  * For conditions of distribution and use, see the accompanying README file.
  26.  *
  27.  * This file contains optional default-setting code for the JPEG compressor.
  28.  * Applications do not have to use this file, but those that don't use it
  29.  * must know a lot more about the innards of the JPEG code.
  30.  */
  31. #define JPEG_INTERNALS
  32. #include "jinclude.h"
  33. #include "jpeglib.h"
  34. /*
  35.  * Quantization table setup routines
  36.  */
  37. GLOBAL(void)
  38. jpeg_add_quant_table (j_compress_ptr cinfo, int which_tbl,
  39.       const unsigned int *basic_table,
  40.       int scale_factor, boolean force_baseline)
  41. /* Define a quantization table equal to the basic_table times
  42.  * a scale factor (given as a percentage).
  43.  * If force_baseline is TRUE, the computed quantization table entries
  44.  * are limited to 1..255 for JPEG baseline compatibility.
  45.  */
  46. {
  47.   JQUANT_TBL ** qtblptr = & cinfo->quant_tbl_ptrs[which_tbl];
  48.   int i;
  49.   long temp;
  50.   /* Safety check to ensure start_compress not called yet. */
  51.   if (cinfo->global_state != CSTATE_START)
  52.     ERREXIT1(cinfo, JERR_BAD_STATE, cinfo->global_state);
  53.   if (*qtblptr == NULL)
  54.     *qtblptr = jpeg_alloc_quant_table((j_common_ptr) cinfo);
  55.   for (i = 0; i < DCTSIZE2; i++) {
  56.     temp = ((long) basic_table[i] * scale_factor + 50L) / 100L;
  57.     /* limit the values to the valid range */
  58.     if (temp <= 0L) temp = 1L;
  59.     if (temp > 32767L) temp = 32767L; /* max quantizer needed for 12 bits */
  60.     if (force_baseline && temp > 255L)
  61.       temp = 255L; /* limit to baseline range if requested */
  62.     (*qtblptr)->quantval[i] = (Ushort) temp;
  63.   }
  64.   /* Initialize sent_table FALSE so table will be written to JPEG file. */
  65.   (*qtblptr)->sent_table = FALSE;
  66. }
  67. GLOBAL(void)
  68. jpeg_set_linear_quality (j_compress_ptr cinfo, int scale_factor,
  69.  boolean force_baseline)
  70. /* Set or change the 'quality' (quantization) setting, using default tables
  71.  * and a straight percentage-scaling quality scale.  In most cases it's better
  72.  * to use jpeg_set_quality (below); this entry point is provided for
  73.  * applications that insist on a linear percentage scaling.
  74.  */
  75. {
  76.   /* These are the sample quantization tables given in JPEG spec section K.1.
  77.    * The spec says that the values given produce "good" quality, and
  78.    * when divided by 2, "very good" quality.
  79.    */
  80.   static const unsigned int std_luminance_quant_tbl[DCTSIZE2] = {
  81.     16,  11,  10,  16,  24,  40,  51,  61,
  82.     12,  12,  14,  19,  26,  58,  60,  55,
  83.     14,  13,  16,  24,  40,  57,  69,  56,
  84.     14,  17,  22,  29,  51,  87,  80,  62,
  85.     18,  22,  37,  56,  68, 109, 103,  77,
  86.     24,  35,  55,  64,  81, 104, 113,  92,
  87.     49,  64,  78,  87, 103, 121, 120, 101,
  88.     72,  92,  95,  98, 112, 100, 103,  99
  89.   };
  90.   static const unsigned int std_chrominance_quant_tbl[DCTSIZE2] = {
  91.     17,  18,  24,  47,  99,  99,  99,  99,
  92.     18,  21,  26,  66,  99,  99,  99,  99,
  93.     24,  26,  56,  99,  99,  99,  99,  99,
  94.     47,  66,  99,  99,  99,  99,  99,  99,
  95.     99,  99,  99,  99,  99,  99,  99,  99,
  96.     99,  99,  99,  99,  99,  99,  99,  99,
  97.     99,  99,  99,  99,  99,  99,  99,  99,
  98.     99,  99,  99,  99,  99,  99,  99,  99
  99.   };
  100.   /* Set up two quantization tables using the specified scaling */
  101.   jpeg_add_quant_table(cinfo, 0, std_luminance_quant_tbl,
  102.        scale_factor, force_baseline);
  103.   jpeg_add_quant_table(cinfo, 1, std_chrominance_quant_tbl,
  104.        scale_factor, force_baseline);
  105. }
  106. GLOBAL(int)
  107. jpeg_quality_scaling (int quality)
  108. /* Convert a user-specified quality rating to a percentage scaling factor
  109.  * for an underlying quantization table, using our recommended scaling curve.
  110.  * The input 'quality' factor should be 0 (terrible) to 100 (very good).
  111.  */
  112. {
  113.   /* Safety limit on quality factor.  Convert 0 to 1 to avoid zero divide. */
  114.   if (quality <= 0) quality = 1;
  115.   if (quality > 100) quality = 100;
  116.   /* The basic table is used as-is (scaling 100) for a quality of 50.
  117.    * Qualities 50..100 are converted to scaling percentage 200 - 2*Q;
  118.    * note that at Q=100 the scaling is 0, which will cause jpeg_add_quant_table
  119.    * to make all the table entries 1 (hence, minimum quantization loss).
  120.    * Qualities 1..50 are converted to scaling percentage 5000/Q.
  121.    */
  122.   if (quality < 50)
  123.     quality = 5000 / quality;
  124.   else
  125.     quality = 200 - quality*2;
  126.   return quality;
  127. }
  128. GLOBAL(void)
  129. jpeg_set_quality (j_compress_ptr cinfo, int quality, boolean force_baseline)
  130. /* Set or change the 'quality' (quantization) setting, using default tables.
  131.  * This is the standard quality-adjusting entry point for typical user
  132.  * interfaces; only those who want detailed control over quantization tables
  133.  * would use the preceding three routines directly.
  134.  */
  135. {
  136.   /* Convert user 0-100 rating to percentage scaling */
  137.   quality = jpeg_quality_scaling(quality);
  138.   /* Set up standard quality tables */
  139.   jpeg_set_linear_quality(cinfo, quality, force_baseline);
  140. }
  141. /*
  142.  * Huffman table setup routines
  143.  */
  144. LOCAL(void)
  145. add_huff_table (j_compress_ptr cinfo,
  146. JHUFF_TBL **htblptr, const UINT8 *bits, const UINT8 *val)
  147. /* Define a Huffman table */
  148. {
  149.   if (*htblptr == NULL)
  150.     *htblptr = jpeg_alloc_huff_table((j_common_ptr) cinfo);
  151.   
  152.   MEMCOPY((*htblptr)->bits, bits, SIZEOF((*htblptr)->bits));
  153.   MEMCOPY((*htblptr)->huffval, val, SIZEOF((*htblptr)->huffval));
  154.   /* Initialize sent_table FALSE so table will be written to JPEG file. */
  155.   (*htblptr)->sent_table = FALSE;
  156. }
  157. LOCAL(void)
  158. std_huff_tables (j_compress_ptr cinfo)
  159. /* Set up the standard Huffman tables (cf. JPEG standard section K.3) */
  160. /* IMPORTANT: these are only valid for 8-bit data precision! */
  161. {
  162.   static const UINT8 bits_dc_luminance[17] =
  163.     { /* 0-base */ 0, 0, 1, 5, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, 0 };
  164.   static const UINT8 val_dc_luminance[] =
  165.     { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 };
  166.   
  167.   static const UINT8 bits_dc_chrominance[17] =
  168.     { /* 0-base */ 0, 0, 3, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0 };
  169.   static const UINT8 val_dc_chrominance[] =
  170.     { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 };
  171.   
  172.   static const UINT8 bits_ac_luminance[17] =
  173.     { /* 0-base */ 0, 0, 2, 1, 3, 3, 2, 4, 3, 5, 5, 4, 4, 0, 0, 1, 0x7d };
  174.   static const UINT8 val_ac_luminance[] =
  175.     { 0x01, 0x02, 0x03, 0x00, 0x04, 0x11, 0x05, 0x12,
  176.       0x21, 0x31, 0x41, 0x06, 0x13, 0x51, 0x61, 0x07,
  177.       0x22, 0x71, 0x14, 0x32, 0x81, 0x91, 0xa1, 0x08,
  178.       0x23, 0x42, 0xb1, 0xc1, 0x15, 0x52, 0xd1, 0xf0,
  179.       0x24, 0x33, 0x62, 0x72, 0x82, 0x09, 0x0a, 0x16,
  180.       0x17, 0x18, 0x19, 0x1a, 0x25, 0x26, 0x27, 0x28,
  181.       0x29, 0x2a, 0x34, 0x35, 0x36, 0x37, 0x38, 0x39,
  182.       0x3a, 0x43, 0x44, 0x45, 0x46, 0x47, 0x48, 0x49,
  183.       0x4a, 0x53, 0x54, 0x55, 0x56, 0x57, 0x58, 0x59,
  184.       0x5a, 0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69,
  185.       0x6a, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78, 0x79,
  186.       0x7a, 0x83, 0x84, 0x85, 0x86, 0x87, 0x88, 0x89,
  187.       0x8a, 0x92, 0x93, 0x94, 0x95, 0x96, 0x97, 0x98,
  188.       0x99, 0x9a, 0xa2, 0xa3, 0xa4, 0xa5, 0xa6, 0xa7,
  189.       0xa8, 0xa9, 0xaa, 0xb2, 0xb3, 0xb4, 0xb5, 0xb6,
  190.       0xb7, 0xb8, 0xb9, 0xba, 0xc2, 0xc3, 0xc4, 0xc5,
  191.       0xc6, 0xc7, 0xc8, 0xc9, 0xca, 0xd2, 0xd3, 0xd4,
  192.       0xd5, 0xd6, 0xd7, 0xd8, 0xd9, 0xda, 0xe1, 0xe2,
  193.       0xe3, 0xe4, 0xe5, 0xe6, 0xe7, 0xe8, 0xe9, 0xea,
  194.       0xf1, 0xf2, 0xf3, 0xf4, 0xf5, 0xf6, 0xf7, 0xf8,
  195.       0xf9, 0xfa };
  196.   
  197.   static const UINT8 bits_ac_chrominance[17] =
  198.     { /* 0-base */ 0, 0, 2, 1, 2, 4, 4, 3, 4, 7, 5, 4, 4, 0, 1, 2, 0x77 };
  199.   static const UINT8 val_ac_chrominance[] =
  200.     { 0x00, 0x01, 0x02, 0x03, 0x11, 0x04, 0x05, 0x21,
  201.       0x31, 0x06, 0x12, 0x41, 0x51, 0x07, 0x61, 0x71,
  202.       0x13, 0x22, 0x32, 0x81, 0x08, 0x14, 0x42, 0x91,
  203.       0xa1, 0xb1, 0xc1, 0x09, 0x23, 0x33, 0x52, 0xf0,
  204.       0x15, 0x62, 0x72, 0xd1, 0x0a, 0x16, 0x24, 0x34,
  205.       0xe1, 0x25, 0xf1, 0x17, 0x18, 0x19, 0x1a, 0x26,
  206.       0x27, 0x28, 0x29, 0x2a, 0x35, 0x36, 0x37, 0x38,
  207.       0x39, 0x3a, 0x43, 0x44, 0x45, 0x46, 0x47, 0x48,
  208.       0x49, 0x4a, 0x53, 0x54, 0x55, 0x56, 0x57, 0x58,
  209.       0x59, 0x5a, 0x63, 0x64, 0x65, 0x66, 0x67, 0x68,
  210.       0x69, 0x6a, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78,
  211.       0x79, 0x7a, 0x82, 0x83, 0x84, 0x85, 0x86, 0x87,
  212.       0x88, 0x89, 0x8a, 0x92, 0x93, 0x94, 0x95, 0x96,
  213.       0x97, 0x98, 0x99, 0x9a, 0xa2, 0xa3, 0xa4, 0xa5,
  214.       0xa6, 0xa7, 0xa8, 0xa9, 0xaa, 0xb2, 0xb3, 0xb4,
  215.       0xb5, 0xb6, 0xb7, 0xb8, 0xb9, 0xba, 0xc2, 0xc3,
  216.       0xc4, 0xc5, 0xc6, 0xc7, 0xc8, 0xc9, 0xca, 0xd2,
  217.       0xd3, 0xd4, 0xd5, 0xd6, 0xd7, 0xd8, 0xd9, 0xda,
  218.       0xe2, 0xe3, 0xe4, 0xe5, 0xe6, 0xe7, 0xe8, 0xe9,
  219.       0xea, 0xf2, 0xf3, 0xf4, 0xf5, 0xf6, 0xf7, 0xf8,
  220.       0xf9, 0xfa };
  221.   
  222.   add_huff_table(cinfo, &cinfo->dc_huff_tbl_ptrs[0],
  223.  bits_dc_luminance, val_dc_luminance);
  224.   add_huff_table(cinfo, &cinfo->ac_huff_tbl_ptrs[0],
  225.  bits_ac_luminance, val_ac_luminance);
  226.   add_huff_table(cinfo, &cinfo->dc_huff_tbl_ptrs[1],
  227.  bits_dc_chrominance, val_dc_chrominance);
  228.   add_huff_table(cinfo, &cinfo->ac_huff_tbl_ptrs[1],
  229.  bits_ac_chrominance, val_ac_chrominance);
  230. }
  231. /*
  232.  * Default parameter setup for compression.
  233.  *
  234.  * Applications that don't choose to use this routine must do their
  235.  * own setup of all these parameters.  Alternately, you can call this
  236.  * to establish defaults and then alter parameters selectively.  This
  237.  * is the recommended approach since, if we add any new parameters,
  238.  * your code will still work (they'll be set to reasonable defaults).
  239.  */
  240. GLOBAL(void)
  241. jpeg_set_defaults (j_compress_ptr cinfo)
  242. {
  243.   int i;
  244.   /* Safety check to ensure start_compress not called yet. */
  245.   if (cinfo->global_state != CSTATE_START)
  246.     ERREXIT1(cinfo, JERR_BAD_STATE, cinfo->global_state);
  247.   /* Allocate comp_info array large enough for maximum component count.
  248.    * Array is made permanent in case application wants to compress
  249.    * multiple images at same param settings.
  250.    */
  251.   if (cinfo->comp_info == NULL)
  252.     cinfo->comp_info = (jpeg_component_info *)
  253.       (*cinfo->mem->alloc_small) ((j_common_ptr) cinfo, JPOOL_PERMANENT,
  254.   MAX_COMPONENTS * SIZEOF(jpeg_component_info));
  255.   /* Initialize everything not dependent on the color space */
  256.   cinfo->data_precision = BITS_IN_JSAMPLE;
  257.   /* Set up two quantization tables using default quality of 75 */
  258.   jpeg_set_quality(cinfo, 75, TRUE);
  259.   /* Set up two Huffman tables */
  260.   std_huff_tables(cinfo);
  261.   /* Initialize default arithmetic coding conditioning */
  262.   for (i = 0; i < NUM_ARITH_TBLS; i++) {
  263.     cinfo->arith_dc_L[i] = 0;
  264.     cinfo->arith_dc_U[i] = 1;
  265.     cinfo->arith_ac_K[i] = 5;
  266.   }
  267.   /* Default is no multiple-scan output */
  268.   cinfo->scan_info = NULL;
  269.   cinfo->num_scans = 0;
  270.   /* Expect normal source image, not raw downsampled data */
  271.   cinfo->raw_data_in = FALSE;
  272.   /* Use Huffman coding, not arithmetic coding, by default */
  273.   cinfo->arith_code = FALSE;
  274.   /* By default, don't do extra passes to optimize entropy coding */
  275.   cinfo->optimize_coding = FALSE;
  276.   /* The standard Huffman tables are only valid for 8-bit data precision.
  277.    * If the precision is higher, force optimization on so that usable
  278.    * tables will be computed.  This test can be removed if default tables
  279.    * are supplied that are valid for the desired precision.
  280.    */
  281.   if (cinfo->data_precision > 8)
  282.     cinfo->optimize_coding = TRUE;
  283.   /* By default, use the simpler non-cosited sampling alignment */
  284.   cinfo->CCIR601_sampling = FALSE;
  285.   /* No input smoothing */
  286.   cinfo->smoothing_factor = 0;
  287.   /* DCT algorithm preference */
  288.   cinfo->dct_method = JDCT_DEFAULT;
  289.   /* No restart markers */
  290.   cinfo->restart_interval = 0;
  291.   cinfo->restart_in_rows = 0;
  292.   /* Fill in default JFIF marker parameters.  Note that whether the marker
  293.    * will actually be written is determined by jpeg_set_colorspace.
  294.    */
  295.   cinfo->density_unit = 0; /* Pixel size is unknown by default */
  296.   cinfo->X_density = 1; /* Pixel aspect ratio is square by default */
  297.   cinfo->Y_density = 1;
  298.   /* Choose JPEG colorspace based on input space, set defaults accordingly */
  299.   jpeg_default_colorspace(cinfo);
  300. }
  301. /*
  302.  * Select an appropriate JPEG colorspace for in_color_space.
  303.  */
  304. GLOBAL(void)
  305. jpeg_default_colorspace (j_compress_ptr cinfo)
  306. {
  307.   switch (cinfo->in_color_space) {
  308.   case JCS_GRAYSCALE:
  309.     jpeg_set_colorspace(cinfo, JCS_GRAYSCALE);
  310.     break;
  311.   case JCS_RGB:
  312.     jpeg_set_colorspace(cinfo, JCS_YCbCr);
  313.     break;
  314.   case JCS_YCbCr:
  315.     jpeg_set_colorspace(cinfo, JCS_YCbCr);
  316.     break;
  317.   case JCS_CMYK:
  318.     jpeg_set_colorspace(cinfo, JCS_CMYK); /* By default, no translation */
  319.     break;
  320.   case JCS_YCCK:
  321.     jpeg_set_colorspace(cinfo, JCS_YCCK);
  322.     break;
  323.   case JCS_UNKNOWN:
  324.     jpeg_set_colorspace(cinfo, JCS_UNKNOWN);
  325.     break;
  326.   default:
  327.     ERREXIT(cinfo, JERR_BAD_IN_COLORSPACE);
  328.   }
  329. }
  330. /*
  331.  * Set the JPEG colorspace, and choose colorspace-dependent default values.
  332.  */
  333. GLOBAL(void)
  334. jpeg_set_colorspace (j_compress_ptr cinfo, J_COLOR_SPACE colorspace)
  335. {
  336.   jpeg_component_info * compptr;
  337.   int ci;
  338. #define SET_COMP(index,id,hsamp,vsamp,quant,dctbl,actbl)  
  339.   (compptr = &cinfo->comp_info[index], 
  340.    compptr->component_id = (id), 
  341.    compptr->h_samp_factor = (hsamp), 
  342.    compptr->v_samp_factor = (vsamp), 
  343.    compptr->quant_tbl_no = (quant), 
  344.    compptr->dc_tbl_no = (dctbl), 
  345.    compptr->ac_tbl_no = (actbl) )
  346.   /* Safety check to ensure start_compress not called yet. */
  347.   if (cinfo->global_state != CSTATE_START)
  348.     ERREXIT1(cinfo, JERR_BAD_STATE, cinfo->global_state);
  349.   /* For all colorspaces, we use Q and Huff tables 0 for luminance components,
  350.    * tables 1 for chrominance components.
  351.    */
  352.   cinfo->jpeg_color_space = colorspace;
  353.   cinfo->write_JFIF_header = FALSE; /* No marker for non-JFIF colorspaces */
  354.   cinfo->write_Adobe_marker = FALSE; /* write no Adobe marker by default */
  355.   switch (colorspace) {
  356.   case JCS_GRAYSCALE:
  357.     cinfo->write_JFIF_header = TRUE; /* Write a JFIF marker */
  358.     cinfo->num_components = 1;
  359.     /* JFIF specifies component ID 1 */
  360.     SET_COMP(0, 1, 1,1, 0, 0,0);
  361.     break;
  362.   case JCS_RGB:
  363.     cinfo->write_Adobe_marker = TRUE; /* write Adobe marker to flag RGB */
  364.     cinfo->num_components = 3;
  365.     SET_COMP(0, 0x52 /* 'R' */, 1,1, 0, 0,0);
  366.     SET_COMP(1, 0x47 /* 'G' */, 1,1, 0, 0,0);
  367.     SET_COMP(2, 0x42 /* 'B' */, 1,1, 0, 0,0);
  368.     break;
  369.   case JCS_YCbCr:
  370.     cinfo->write_JFIF_header = TRUE; /* Write a JFIF marker */
  371.     cinfo->num_components = 3;
  372.     /* JFIF specifies component IDs 1,2,3 */
  373.     /* We default to 2x2 subsamples of chrominance */
  374.     SET_COMP(0, 1, 2,2, 0, 0,0);
  375.     SET_COMP(1, 2, 1,1, 1, 1,1);
  376.     SET_COMP(2, 3, 1,1, 1, 1,1);
  377.     break;
  378.   case JCS_CMYK:
  379.     cinfo->write_Adobe_marker = TRUE; /* write Adobe marker to flag CMYK */
  380.     cinfo->num_components = 4;
  381.     SET_COMP(0, 0x43 /* 'C' */, 1,1, 0, 0,0);
  382.     SET_COMP(1, 0x4D /* 'M' */, 1,1, 0, 0,0);
  383.     SET_COMP(2, 0x59 /* 'Y' */, 1,1, 0, 0,0);
  384.     SET_COMP(3, 0x4B /* 'K' */, 1,1, 0, 0,0);
  385.     break;
  386.   case JCS_YCCK:
  387.     cinfo->write_Adobe_marker = TRUE; /* write Adobe marker to flag YCCK */
  388.     cinfo->num_components = 4;
  389.     SET_COMP(0, 1, 2,2, 0, 0,0);
  390.     SET_COMP(1, 2, 1,1, 1, 1,1);
  391.     SET_COMP(2, 3, 1,1, 1, 1,1);
  392.     SET_COMP(3, 4, 2,2, 0, 0,0);
  393.     break;
  394.   case JCS_UNKNOWN:
  395.     cinfo->num_components = cinfo->input_components;
  396.     if (cinfo->num_components < 1 || cinfo->num_components > MAX_COMPONENTS)
  397.       ERREXIT2(cinfo, JERR_COMPONENT_COUNT, cinfo->num_components,
  398.        MAX_COMPONENTS);
  399.     for (ci = 0; ci < cinfo->num_components; ci++) {
  400.       SET_COMP(ci, ci, 1,1, 0, 0,0);
  401.     }
  402.     break;
  403.   default:
  404.     ERREXIT(cinfo, JERR_BAD_J_COLORSPACE);
  405.   }
  406. }
  407. #ifdef C_PROGRESSIVE_SUPPORTED
  408. LOCAL(jpeg_scan_info *)
  409. fill_a_scan (jpeg_scan_info * scanptr, int ci,
  410.      int Ss, int Se, int Ah, int Al)
  411. /* Support routine: generate one scan for specified component */
  412. {
  413.   scanptr->comps_in_scan = 1;
  414.   scanptr->component_index[0] = ci;
  415.   scanptr->Ss = Ss;
  416.   scanptr->Se = Se;
  417.   scanptr->Ah = Ah;
  418.   scanptr->Al = Al;
  419.   scanptr++;
  420.   return scanptr;
  421. }
  422. LOCAL(jpeg_scan_info *)
  423. fill_scans (jpeg_scan_info * scanptr, int ncomps,
  424.     int Ss, int Se, int Ah, int Al)
  425. /* Support routine: generate one scan for each component */
  426. {
  427.   int ci;
  428.   for (ci = 0; ci < ncomps; ci++) {
  429.     scanptr->comps_in_scan = 1;
  430.     scanptr->component_index[0] = ci;
  431.     scanptr->Ss = Ss;
  432.     scanptr->Se = Se;
  433.     scanptr->Ah = Ah;
  434.     scanptr->Al = Al;
  435.     scanptr++;
  436.   }
  437.   return scanptr;
  438. }
  439. LOCAL(jpeg_scan_info *)
  440. fill_dc_scans (jpeg_scan_info * scanptr, int ncomps, int Ah, int Al)
  441. /* Support routine: generate interleaved DC scan if possible, else N scans */
  442. {
  443.   int ci;
  444.   if (ncomps <= MAX_COMPS_IN_SCAN) {
  445.     /* Single interleaved DC scan */
  446.     scanptr->comps_in_scan = ncomps;
  447.     for (ci = 0; ci < ncomps; ci++)
  448.       scanptr->component_index[ci] = ci;
  449.     scanptr->Ss = scanptr->Se = 0;
  450.     scanptr->Ah = Ah;
  451.     scanptr->Al = Al;
  452.     scanptr++;
  453.   } else {
  454.     /* Noninterleaved DC scan for each component */
  455.     scanptr = fill_scans(scanptr, ncomps, 0, 0, Ah, Al);
  456.   }
  457.   return scanptr;
  458. }
  459. /*
  460.  * Create a recommended progressive-JPEG script.
  461.  * cinfo->num_components and cinfo->jpeg_color_space must be correct.
  462.  */
  463. GLOBAL(void)
  464. jpeg_simple_progression (j_compress_ptr cinfo)
  465. {
  466.   int ncomps = cinfo->num_components;
  467.   int nscans;
  468.   jpeg_scan_info * scanptr;
  469.   /* Safety check to ensure start_compress not called yet. */
  470.   if (cinfo->global_state != CSTATE_START)
  471.     ERREXIT1(cinfo, JERR_BAD_STATE, cinfo->global_state);
  472.   /* Figure space needed for script.  Calculation must match code below! */
  473.   if (ncomps == 3 && cinfo->jpeg_color_space == JCS_YCbCr) {
  474.     /* Custom script for YCbCr color images. */
  475.     nscans = 10;
  476.   } else {
  477.     /* All-purpose script for other color spaces. */
  478.     if (ncomps > MAX_COMPS_IN_SCAN)
  479.       nscans = 6 * ncomps; /* 2 DC + 4 AC scans per component */
  480.     else
  481.       nscans = 2 + 4 * ncomps; /* 2 DC scans; 4 AC scans per component */
  482.   }
  483.   /* Allocate space for script. */
  484.   /* We use permanent pool just in case application re-uses script. */
  485.   scanptr = (jpeg_scan_info *)
  486.     (*cinfo->mem->alloc_small) ((j_common_ptr) cinfo, JPOOL_PERMANENT,
  487. nscans * SIZEOF(jpeg_scan_info));
  488.   cinfo->scan_info = scanptr;
  489.   cinfo->num_scans = nscans;
  490.   if (ncomps == 3 && cinfo->jpeg_color_space == JCS_YCbCr) {
  491.     /* Custom script for YCbCr color images. */
  492.     /* Initial DC scan */
  493.     scanptr = fill_dc_scans(scanptr, ncomps, 0, 1);
  494.     /* Initial AC scan: get some luma data out in a hurry */
  495.     scanptr = fill_a_scan(scanptr, 0, 1, 5, 0, 2);
  496.     /* Chroma data is too small to be worth expending many scans on */
  497.     scanptr = fill_a_scan(scanptr, 2, 1, 63, 0, 1);
  498.     scanptr = fill_a_scan(scanptr, 1, 1, 63, 0, 1);
  499.     /* Complete spectral selection for luma AC */
  500.     scanptr = fill_a_scan(scanptr, 0, 6, 63, 0, 2);
  501.     /* Refine next bit of luma AC */
  502.     scanptr = fill_a_scan(scanptr, 0, 1, 63, 2, 1);
  503.     /* Finish DC successive approximation */
  504.     scanptr = fill_dc_scans(scanptr, ncomps, 1, 0);
  505.     /* Finish AC successive approximation */
  506.     scanptr = fill_a_scan(scanptr, 2, 1, 63, 1, 0);
  507.     scanptr = fill_a_scan(scanptr, 1, 1, 63, 1, 0);
  508.     /* Luma bottom bit comes last since it's usually largest scan */
  509.     scanptr = fill_a_scan(scanptr, 0, 1, 63, 1, 0);
  510.   } else {
  511.     /* All-purpose script for other color spaces. */
  512.     /* Successive approximation first pass */
  513.     scanptr = fill_dc_scans(scanptr, ncomps, 0, 1);
  514.     scanptr = fill_scans(scanptr, ncomps, 1, 5, 0, 2);
  515.     scanptr = fill_scans(scanptr, ncomps, 6, 63, 0, 2);
  516.     /* Successive approximation second pass */
  517.     scanptr = fill_scans(scanptr, ncomps, 1, 63, 2, 1);
  518.     /* Successive approximation final pass */
  519.     scanptr = fill_dc_scans(scanptr, ncomps, 1, 0);
  520.     scanptr = fill_scans(scanptr, ncomps, 1, 63, 1, 0);
  521.   }
  522. }
  523. #endif /* C_PROGRESSIVE_SUPPORTED */