jcparam.c 19 KB

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