Fixed binary search: no more infinite loops when vendor is unknown.
[tangerine.git] / compiler / libjpeg / main / jcparam.c
blob55c0acf6aa2140d2d164fd499d0998affddaf4aa
1 /*
2 $Id$
3 */
5 /*
6 * jcparam.c
8 * Copyright (C) 1991-1998, Thomas G. Lane.
9 * This file is part of the Independent JPEG Group's software.
10 * For conditions of distribution and use, see the accompanying README file.
12 * This file contains optional default-setting code for the JPEG compressor.
13 * Applications do not have to use this file, but those that don't use it
14 * must know a lot more about the innards of the JPEG code.
17 #define JPEG_INTERNALS
18 #include "jinclude.h"
19 #include "jpeglib.h"
23 * Quantization table setup routines
26 JGLOBAL(void)
27 jpeg_add_quant_table (j_compress_ptr cinfo, int which_tbl,
28 const unsigned int *basic_table,
29 int scale_factor, boolean force_baseline)
30 /* Define a quantization table equal to the basic_table times
31 * a scale factor (given as a percentage).
32 * If force_baseline is TRUE, the computed quantization table entries
33 * are limited to 1..255 for JPEG baseline compatibility.
36 JQUANT_TBL ** qtblptr;
37 int i;
38 long temp;
40 /* Safety check to ensure start_compress not called yet. */
41 if (cinfo->global_state != CSTATE_START)
42 ERREXIT1(cinfo, JERR_BAD_STATE, cinfo->global_state);
44 if (which_tbl < 0 || which_tbl >= NUM_QUANT_TBLS)
45 ERREXIT1(cinfo, JERR_DQT_INDEX, which_tbl);
47 qtblptr = & cinfo->quant_tbl_ptrs[which_tbl];
49 if (*qtblptr == NULL)
50 *qtblptr = jpeg_alloc_quant_table((j_common_ptr) cinfo);
52 for (i = 0; i < DCTSIZE2; i++) {
53 temp = ((long) basic_table[i] * scale_factor + 50L) / 100L;
54 /* limit the values to the valid range */
55 if (temp <= 0L) temp = 1L;
56 if (temp > 32767L) temp = 32767L; /* max quantizer needed for 12 bits */
57 if (force_baseline && temp > 255L)
58 temp = 255L; /* limit to baseline range if requested */
59 (*qtblptr)->quantval[i] = (UINT16) temp;
62 /* Initialize sent_table FALSE so table will be written to JPEG file. */
63 (*qtblptr)->sent_table = FALSE;
67 JGLOBAL(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.
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.
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
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
101 /* Set up two quantization tables using the specified scaling */
102 jpeg_add_quant_table(cinfo, 0, std_luminance_quant_tbl,
103 scale_factor, force_baseline);
104 jpeg_add_quant_table(cinfo, 1, std_chrominance_quant_tbl,
105 scale_factor, force_baseline);
109 JGLOBAL(int)
110 jpeg_quality_scaling (int quality)
111 /* Convert a user-specified quality rating to a percentage scaling factor
112 * for an underlying quantization table, using our recommended scaling curve.
113 * The input 'quality' factor should be 0 (terrible) to 100 (very good).
116 /* Safety limit on quality factor. Convert 0 to 1 to avoid zero divide. */
117 if (quality <= 0) quality = 1;
118 if (quality > 100) quality = 100;
120 /* The basic table is used as-is (scaling 100) for a quality of 50.
121 * Qualities 50..100 are converted to scaling percentage 200 - 2*Q;
122 * note that at Q=100 the scaling is 0, which will cause jpeg_add_quant_table
123 * to make all the table entries 1 (hence, minimum quantization loss).
124 * Qualities 1..50 are converted to scaling percentage 5000/Q.
126 if (quality < 50)
127 quality = 5000 / quality;
128 else
129 quality = 200 - quality*2;
131 return quality;
135 JGLOBAL(void)
136 jpeg_set_quality (j_compress_ptr cinfo, int quality, boolean force_baseline)
137 /* Set or change the 'quality' (quantization) setting, using default tables.
138 * This is the standard quality-adjusting entry point for typical user
139 * interfaces; only those who want detailed control over quantization tables
140 * would use the preceding three routines directly.
143 /* Convert user 0-100 rating to percentage scaling */
144 quality = jpeg_quality_scaling(quality);
146 /* Set up standard quality tables */
147 jpeg_set_linear_quality(cinfo, quality, force_baseline);
152 * Huffman table setup routines
155 LOCAL(void)
156 add_huff_table (j_compress_ptr cinfo,
157 JHUFF_TBL **htblptr, const UINT8 *bits, const UINT8 *val)
158 /* Define a Huffman table */
160 int nsymbols, len;
162 if (*htblptr == NULL)
163 *htblptr = jpeg_alloc_huff_table((j_common_ptr) cinfo);
165 /* Copy the number-of-symbols-of-each-code-length counts */
166 MEMCOPY((*htblptr)->bits, bits, SIZEOF((*htblptr)->bits));
168 /* Validate the counts. We do this here mainly so we can copy the right
169 * number of symbols from the val[] array, without risking marching off
170 * the end of memory. jchuff.c will do a more thorough test later.
172 nsymbols = 0;
173 for (len = 1; len <= 16; len++)
174 nsymbols += bits[len];
175 if (nsymbols < 1 || nsymbols > 256)
176 ERREXIT(cinfo, JERR_BAD_HUFF_TABLE);
178 MEMCOPY((*htblptr)->huffval, val, nsymbols * SIZEOF(UINT8));
180 /* Initialize sent_table FALSE so table will be written to JPEG file. */
181 (*htblptr)->sent_table = FALSE;
185 LOCAL(void)
186 std_huff_tables (j_compress_ptr cinfo)
187 /* Set up the standard Huffman tables (cf. JPEG standard section K.3) */
188 /* IMPORTANT: these are only valid for 8-bit data precision! */
190 static const UINT8 bits_dc_luminance[17] =
191 { /* 0-base */ 0, 0, 1, 5, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, 0 };
192 static const UINT8 val_dc_luminance[] =
193 { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 };
195 static const UINT8 bits_dc_chrominance[17] =
196 { /* 0-base */ 0, 0, 3, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0 };
197 static const UINT8 val_dc_chrominance[] =
198 { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 };
200 static const UINT8 bits_ac_luminance[17] =
201 { /* 0-base */ 0, 0, 2, 1, 3, 3, 2, 4, 3, 5, 5, 4, 4, 0, 0, 1, 0x7d };
202 static const UINT8 val_ac_luminance[] =
203 { 0x01, 0x02, 0x03, 0x00, 0x04, 0x11, 0x05, 0x12,
204 0x21, 0x31, 0x41, 0x06, 0x13, 0x51, 0x61, 0x07,
205 0x22, 0x71, 0x14, 0x32, 0x81, 0x91, 0xa1, 0x08,
206 0x23, 0x42, 0xb1, 0xc1, 0x15, 0x52, 0xd1, 0xf0,
207 0x24, 0x33, 0x62, 0x72, 0x82, 0x09, 0x0a, 0x16,
208 0x17, 0x18, 0x19, 0x1a, 0x25, 0x26, 0x27, 0x28,
209 0x29, 0x2a, 0x34, 0x35, 0x36, 0x37, 0x38, 0x39,
210 0x3a, 0x43, 0x44, 0x45, 0x46, 0x47, 0x48, 0x49,
211 0x4a, 0x53, 0x54, 0x55, 0x56, 0x57, 0x58, 0x59,
212 0x5a, 0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69,
213 0x6a, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78, 0x79,
214 0x7a, 0x83, 0x84, 0x85, 0x86, 0x87, 0x88, 0x89,
215 0x8a, 0x92, 0x93, 0x94, 0x95, 0x96, 0x97, 0x98,
216 0x99, 0x9a, 0xa2, 0xa3, 0xa4, 0xa5, 0xa6, 0xa7,
217 0xa8, 0xa9, 0xaa, 0xb2, 0xb3, 0xb4, 0xb5, 0xb6,
218 0xb7, 0xb8, 0xb9, 0xba, 0xc2, 0xc3, 0xc4, 0xc5,
219 0xc6, 0xc7, 0xc8, 0xc9, 0xca, 0xd2, 0xd3, 0xd4,
220 0xd5, 0xd6, 0xd7, 0xd8, 0xd9, 0xda, 0xe1, 0xe2,
221 0xe3, 0xe4, 0xe5, 0xe6, 0xe7, 0xe8, 0xe9, 0xea,
222 0xf1, 0xf2, 0xf3, 0xf4, 0xf5, 0xf6, 0xf7, 0xf8,
223 0xf9, 0xfa };
225 static const UINT8 bits_ac_chrominance[17] =
226 { /* 0-base */ 0, 0, 2, 1, 2, 4, 4, 3, 4, 7, 5, 4, 4, 0, 1, 2, 0x77 };
227 static const UINT8 val_ac_chrominance[] =
228 { 0x00, 0x01, 0x02, 0x03, 0x11, 0x04, 0x05, 0x21,
229 0x31, 0x06, 0x12, 0x41, 0x51, 0x07, 0x61, 0x71,
230 0x13, 0x22, 0x32, 0x81, 0x08, 0x14, 0x42, 0x91,
231 0xa1, 0xb1, 0xc1, 0x09, 0x23, 0x33, 0x52, 0xf0,
232 0x15, 0x62, 0x72, 0xd1, 0x0a, 0x16, 0x24, 0x34,
233 0xe1, 0x25, 0xf1, 0x17, 0x18, 0x19, 0x1a, 0x26,
234 0x27, 0x28, 0x29, 0x2a, 0x35, 0x36, 0x37, 0x38,
235 0x39, 0x3a, 0x43, 0x44, 0x45, 0x46, 0x47, 0x48,
236 0x49, 0x4a, 0x53, 0x54, 0x55, 0x56, 0x57, 0x58,
237 0x59, 0x5a, 0x63, 0x64, 0x65, 0x66, 0x67, 0x68,
238 0x69, 0x6a, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78,
239 0x79, 0x7a, 0x82, 0x83, 0x84, 0x85, 0x86, 0x87,
240 0x88, 0x89, 0x8a, 0x92, 0x93, 0x94, 0x95, 0x96,
241 0x97, 0x98, 0x99, 0x9a, 0xa2, 0xa3, 0xa4, 0xa5,
242 0xa6, 0xa7, 0xa8, 0xa9, 0xaa, 0xb2, 0xb3, 0xb4,
243 0xb5, 0xb6, 0xb7, 0xb8, 0xb9, 0xba, 0xc2, 0xc3,
244 0xc4, 0xc5, 0xc6, 0xc7, 0xc8, 0xc9, 0xca, 0xd2,
245 0xd3, 0xd4, 0xd5, 0xd6, 0xd7, 0xd8, 0xd9, 0xda,
246 0xe2, 0xe3, 0xe4, 0xe5, 0xe6, 0xe7, 0xe8, 0xe9,
247 0xea, 0xf2, 0xf3, 0xf4, 0xf5, 0xf6, 0xf7, 0xf8,
248 0xf9, 0xfa };
250 add_huff_table(cinfo, &cinfo->dc_huff_tbl_ptrs[0],
251 bits_dc_luminance, val_dc_luminance);
252 add_huff_table(cinfo, &cinfo->ac_huff_tbl_ptrs[0],
253 bits_ac_luminance, val_ac_luminance);
254 add_huff_table(cinfo, &cinfo->dc_huff_tbl_ptrs[1],
255 bits_dc_chrominance, val_dc_chrominance);
256 add_huff_table(cinfo, &cinfo->ac_huff_tbl_ptrs[1],
257 bits_ac_chrominance, val_ac_chrominance);
262 * Default parameter setup for compression.
264 * Applications that don't choose to use this routine must do their
265 * own setup of all these parameters. Alternately, you can call this
266 * to establish defaults and then alter parameters selectively. This
267 * is the recommended approach since, if we add any new parameters,
268 * your code will still work (they'll be set to reasonable defaults).
271 JGLOBAL(void)
272 jpeg_set_defaults (j_compress_ptr cinfo)
274 int i;
276 /* Safety check to ensure start_compress not called yet. */
277 if (cinfo->global_state != CSTATE_START)
278 ERREXIT1(cinfo, JERR_BAD_STATE, cinfo->global_state);
280 /* Allocate comp_info array large enough for maximum component count.
281 * Array is made permanent in case application wants to compress
282 * multiple images at same param settings.
284 if (cinfo->comp_info == NULL)
285 cinfo->comp_info = (jpeg_component_info *)
286 (*cinfo->mem->alloc_small) ((j_common_ptr) cinfo, JPOOL_PERMANENT,
287 MAX_COMPONENTS * SIZEOF(jpeg_component_info));
289 /* Initialize everything not dependent on the color space */
291 cinfo->lossless = FALSE;
292 cinfo->data_precision = BITS_IN_JSAMPLE;
293 /* Set up two quantization tables using default quality of 75 */
294 jpeg_set_quality(cinfo, 75, TRUE);
295 /* Set up two Huffman tables */
296 std_huff_tables(cinfo);
298 /* Initialize default arithmetic coding conditioning */
299 for (i = 0; i < NUM_ARITH_TBLS; i++) {
300 cinfo->arith_dc_L[i] = 0;
301 cinfo->arith_dc_U[i] = 1;
302 cinfo->arith_ac_K[i] = 5;
305 /* Default is no multiple-scan output */
306 cinfo->scan_info = NULL;
307 cinfo->num_scans = 0;
309 /* Expect normal source image, not raw downsampled data */
310 cinfo->raw_data_in = FALSE;
312 /* Use Huffman coding, not arithmetic coding, by default */
313 cinfo->arith_code = FALSE;
315 /* By default, don't do extra passes to optimize entropy coding */
316 cinfo->optimize_coding = FALSE;
317 /* The standard Huffman tables are only valid for 8-bit data precision.
318 * If the precision is higher, force optimization on so that usable
319 * tables will be computed. This test can be removed if default tables
320 * are supplied that are valid for the desired precision.
322 if (cinfo->data_precision > 8)
323 cinfo->optimize_coding = TRUE;
325 /* By default, use the simpler non-cosited sampling alignment */
326 cinfo->CCIR601_sampling = FALSE;
328 /* No input smoothing */
329 cinfo->smoothing_factor = 0;
331 /* DCT algorithm preference */
332 cinfo->dct_method = JDCT_DEFAULT;
334 /* No restart markers */
335 cinfo->restart_interval = 0;
336 cinfo->restart_in_rows = 0;
338 /* Fill in default JFIF marker parameters. Note that whether the marker
339 * will actually be written is determined by jpeg_set_colorspace.
341 * By default, the library emits JFIF version code 1.01.
342 * An application that wants to emit JFIF 1.02 extension markers should set
343 * JFIF_minor_version to 2. We could probably get away with just defaulting
344 * to 1.02, but there may still be some decoders in use that will complain
345 * about that; saying 1.01 should minimize compatibility problems.
347 cinfo->JFIF_major_version = 1; /* Default JFIF version = 1.01 */
348 cinfo->JFIF_minor_version = 1;
349 cinfo->density_unit = 0; /* Pixel size is unknown by default */
350 cinfo->X_density = 1; /* Pixel aspect ratio is square by default */
351 cinfo->Y_density = 1;
353 /* Choose JPEG colorspace based on input space, set defaults accordingly */
355 jpeg_default_colorspace(cinfo);
360 * Select an appropriate JPEG colorspace for in_color_space.
363 JGLOBAL(void)
364 jpeg_default_colorspace (j_compress_ptr cinfo)
366 if (cinfo->lossless)
367 jpeg_set_colorspace(cinfo, cinfo->in_color_space);
368 else { /* lossy */
369 switch (cinfo->in_color_space) {
370 case JCS_GRAYSCALE:
371 jpeg_set_colorspace(cinfo, JCS_GRAYSCALE);
372 break;
373 case JCS_RGB:
374 jpeg_set_colorspace(cinfo, JCS_YCbCr);
375 break;
376 case JCS_YCbCr:
377 jpeg_set_colorspace(cinfo, JCS_YCbCr);
378 break;
379 case JCS_CMYK:
380 jpeg_set_colorspace(cinfo, JCS_CMYK); /* By default, no translation */
381 break;
382 case JCS_YCCK:
383 jpeg_set_colorspace(cinfo, JCS_YCCK);
384 break;
385 case JCS_UNKNOWN:
386 jpeg_set_colorspace(cinfo, JCS_UNKNOWN);
387 break;
388 default:
389 ERREXIT(cinfo, JERR_BAD_IN_COLORSPACE);
396 * Set the JPEG colorspace, and choose colorspace-dependent default values.
399 JGLOBAL(void)
400 jpeg_set_colorspace (j_compress_ptr cinfo, J_COLOR_SPACE colorspace)
402 jpeg_component_info * compptr;
403 int ci;
405 #define SET_COMP(index,id,hsamp,vsamp,quant,dctbl,actbl) \
406 (compptr = &cinfo->comp_info[index], \
407 compptr->component_id = (id), \
408 compptr->h_samp_factor = (hsamp), \
409 compptr->v_samp_factor = (vsamp), \
410 compptr->quant_tbl_no = (quant), \
411 compptr->dc_tbl_no = (dctbl), \
412 compptr->ac_tbl_no = (actbl) )
414 /* Safety check to ensure start_compress not called yet. */
415 if (cinfo->global_state != CSTATE_START)
416 ERREXIT1(cinfo, JERR_BAD_STATE, cinfo->global_state);
418 /* For all colorspaces, we use Q and Huff tables 0 for luminance components,
419 * tables 1 for chrominance components.
422 cinfo->jpeg_color_space = colorspace;
424 cinfo->write_JFIF_header = FALSE; /* No marker for non-JFIF colorspaces */
425 cinfo->write_Adobe_marker = FALSE; /* write no Adobe marker by default */
427 switch (colorspace) {
428 case JCS_GRAYSCALE:
429 cinfo->write_JFIF_header = TRUE; /* Write a JFIF marker */
430 cinfo->num_components = 1;
431 /* JFIF specifies component ID 1 */
432 SET_COMP(0, 1, 1,1, 0, 0,0);
433 break;
434 case JCS_RGB:
435 cinfo->write_Adobe_marker = TRUE; /* write Adobe marker to flag RGB */
436 cinfo->num_components = 3;
437 SET_COMP(0, 0x52 /* 'R' */, 1,1, 0, 0,0);
438 SET_COMP(1, 0x47 /* 'G' */, 1,1, 0, 0,0);
439 SET_COMP(2, 0x42 /* 'B' */, 1,1, 0, 0,0);
440 break;
441 case JCS_YCbCr:
442 cinfo->write_JFIF_header = TRUE; /* Write a JFIF marker */
443 cinfo->num_components = 3;
444 /* JFIF specifies component IDs 1,2,3 */
445 if (cinfo->lossless) {
446 SET_COMP(0, 1, 1,1, 0, 0,0);
447 SET_COMP(1, 2, 1,1, 1, 1,1);
448 SET_COMP(2, 3, 1,1, 1, 1,1);
449 } else { /* lossy */
450 /* We default to 2x2 subsamples of chrominance */
451 SET_COMP(0, 1, 2,2, 0, 0,0);
452 SET_COMP(1, 2, 1,1, 1, 1,1);
453 SET_COMP(2, 3, 1,1, 1, 1,1);
455 break;
456 case JCS_CMYK:
457 cinfo->write_Adobe_marker = TRUE; /* write Adobe marker to flag CMYK */
458 cinfo->num_components = 4;
459 SET_COMP(0, 0x43 /* 'C' */, 1,1, 0, 0,0);
460 SET_COMP(1, 0x4D /* 'M' */, 1,1, 0, 0,0);
461 SET_COMP(2, 0x59 /* 'Y' */, 1,1, 0, 0,0);
462 SET_COMP(3, 0x4B /* 'K' */, 1,1, 0, 0,0);
463 break;
464 case JCS_YCCK:
465 cinfo->write_Adobe_marker = TRUE; /* write Adobe marker to flag YCCK */
466 cinfo->num_components = 4;
467 if (cinfo->lossless) {
468 SET_COMP(0, 1, 1,1, 0, 0,0);
469 SET_COMP(1, 2, 1,1, 1, 1,1);
470 SET_COMP(2, 3, 1,1, 1, 1,1);
471 SET_COMP(3, 4, 1,1, 0, 0,0);
472 } else { /* lossy */
473 SET_COMP(0, 1, 2,2, 0, 0,0);
474 SET_COMP(1, 2, 1,1, 1, 1,1);
475 SET_COMP(2, 3, 1,1, 1, 1,1);
476 SET_COMP(3, 4, 2,2, 0, 0,0);
478 break;
479 case JCS_UNKNOWN:
480 cinfo->num_components = cinfo->input_components;
481 if (cinfo->num_components < 1 || cinfo->num_components > MAX_COMPONENTS)
482 ERREXIT2(cinfo, JERR_COMPONENT_COUNT, cinfo->num_components,
483 MAX_COMPONENTS);
484 for (ci = 0; ci < cinfo->num_components; ci++) {
485 SET_COMP(ci, ci, 1,1, 0, 0,0);
487 break;
488 default:
489 ERREXIT(cinfo, JERR_BAD_J_COLORSPACE);
494 #ifdef C_PROGRESSIVE_SUPPORTED
496 LOCAL(jpeg_scan_info *)
497 fill_scans (jpeg_scan_info * scanptr, int ncomps,
498 int Ss, int Se, int Ah, int Al)
499 /* Support routine: generate one scan for each component */
501 int ci;
503 for (ci = 0; ci < ncomps; ci++) {
504 scanptr->comps_in_scan = 1;
505 scanptr->component_index[0] = ci;
506 scanptr->Ss = Ss;
507 scanptr->Se = Se;
508 scanptr->Ah = Ah;
509 scanptr->Al = Al;
510 scanptr++;
512 return scanptr;
516 LOCAL(jpeg_scan_info *)
517 fill_a_scan (jpeg_scan_info * scanptr, int ci,
518 int Ss, int Se, int Ah, int Al)
519 /* Support routine: generate one scan for specified component */
521 scanptr->comps_in_scan = 1;
522 scanptr->component_index[0] = ci;
523 scanptr->Ss = Ss;
524 scanptr->Se = Se;
525 scanptr->Ah = Ah;
526 scanptr->Al = Al;
527 scanptr++;
528 return scanptr;
531 LOCAL(jpeg_scan_info *)
532 fill_dc_scans (jpeg_scan_info * scanptr, int ncomps, int Ah, int Al)
533 /* Support routine: generate interleaved DC scan if possible, else N scans */
535 int ci;
537 if (ncomps <= MAX_COMPS_IN_SCAN) {
538 /* Single interleaved DC scan */
539 scanptr->comps_in_scan = ncomps;
540 for (ci = 0; ci < ncomps; ci++)
541 scanptr->component_index[ci] = ci;
542 scanptr->Ss = scanptr->Se = 0;
543 scanptr->Ah = Ah;
544 scanptr->Al = Al;
545 scanptr++;
546 } else {
547 /* Noninterleaved DC scan for each component */
548 scanptr = fill_scans(scanptr, ncomps, 0, 0, Ah, Al);
550 return scanptr;
555 * Create a recommended progressive-JPEG script.
556 * cinfo->num_components and cinfo->jpeg_color_space must be correct.
559 JGLOBAL(void)
560 jpeg_simple_progression (j_compress_ptr cinfo)
562 int ncomps = cinfo->num_components;
563 int nscans;
564 jpeg_scan_info * scanptr;
566 /* Safety check to ensure start_compress not called yet. */
567 if (cinfo->global_state != CSTATE_START)
568 ERREXIT1(cinfo, JERR_BAD_STATE, cinfo->global_state);
570 /* Figure space needed for script. Calculation must match code below! */
571 if (ncomps == 3 && cinfo->jpeg_color_space == JCS_YCbCr) {
572 /* Custom script for YCbCr color images. */
573 nscans = 10;
574 } else {
575 /* All-purpose script for other color spaces. */
576 if (ncomps > MAX_COMPS_IN_SCAN)
577 nscans = 6 * ncomps; /* 2 DC + 4 AC scans per component */
578 else
579 nscans = 2 + 4 * ncomps; /* 2 DC scans; 4 AC scans per component */
582 /* Allocate space for script.
583 * We need to put it in the permanent pool in case the application performs
584 * multiple compressions without changing the settings. To avoid a memory
585 * leak if jpeg_simple_progression is called repeatedly for the same JPEG
586 * object, we try to re-use previously allocated space, and we allocate
587 * enough space to handle YCbCr even if initially asked for grayscale.
589 if (cinfo->script_space == NULL || cinfo->script_space_size < nscans) {
590 cinfo->script_space_size = MAX(nscans, 10);
591 cinfo->script_space = (jpeg_scan_info *)
592 (*cinfo->mem->alloc_small) ((j_common_ptr) cinfo, JPOOL_PERMANENT,
593 cinfo->script_space_size * SIZEOF(jpeg_scan_info));
595 scanptr = cinfo->script_space;
596 cinfo->scan_info = scanptr;
597 cinfo->num_scans = nscans;
599 if (ncomps == 3 && cinfo->jpeg_color_space == JCS_YCbCr) {
600 /* Custom script for YCbCr color images. */
601 /* Initial DC scan */
602 scanptr = fill_dc_scans(scanptr, ncomps, 0, 1);
603 /* Initial AC scan: get some luma data out in a hurry */
604 scanptr = fill_a_scan(scanptr, 0, 1, 5, 0, 2);
605 /* Chroma data is too small to be worth expending many scans on */
606 scanptr = fill_a_scan(scanptr, 2, 1, 63, 0, 1);
607 scanptr = fill_a_scan(scanptr, 1, 1, 63, 0, 1);
608 /* Complete spectral selection for luma AC */
609 scanptr = fill_a_scan(scanptr, 0, 6, 63, 0, 2);
610 /* Refine next bit of luma AC */
611 scanptr = fill_a_scan(scanptr, 0, 1, 63, 2, 1);
612 /* Finish DC successive approximation */
613 scanptr = fill_dc_scans(scanptr, ncomps, 1, 0);
614 /* Finish AC successive approximation */
615 scanptr = fill_a_scan(scanptr, 2, 1, 63, 1, 0);
616 scanptr = fill_a_scan(scanptr, 1, 1, 63, 1, 0);
617 /* Luma bottom bit comes last since it's usually largest scan */
618 scanptr = fill_a_scan(scanptr, 0, 1, 63, 1, 0);
619 } else {
620 /* All-purpose script for other color spaces. */
621 /* Successive approximation first pass */
622 scanptr = fill_dc_scans(scanptr, ncomps, 0, 1);
623 scanptr = fill_scans(scanptr, ncomps, 1, 5, 0, 2);
624 scanptr = fill_scans(scanptr, ncomps, 6, 63, 0, 2);
625 /* Successive approximation second pass */
626 scanptr = fill_scans(scanptr, ncomps, 1, 63, 2, 1);
627 /* Successive approximation final pass */
628 scanptr = fill_dc_scans(scanptr, ncomps, 1, 0);
629 scanptr = fill_scans(scanptr, ncomps, 1, 63, 1, 0);
633 #endif /* C_PROGRESSIVE_SUPPORTED */
636 #ifdef C_LOSSLESS_SUPPORTED
639 * Create a single-entry lossless-JPEG script containing all components.
640 * cinfo->num_components must be correct.
643 JGLOBAL(void)
644 jpeg_simple_lossless (j_compress_ptr cinfo, int predictor, int point_transform)
646 int ncomps = cinfo->num_components;
647 int nscans = 1;
648 int ci;
649 jpeg_scan_info * scanptr;
651 /* Safety check to ensure start_compress not called yet. */
652 if (cinfo->global_state != CSTATE_START)
653 ERREXIT1(cinfo, JERR_BAD_STATE, cinfo->global_state);
655 cinfo->lossless = TRUE;
657 /* Set jpeg_color_space. */
658 jpeg_default_colorspace(cinfo);
660 /* Check to ensure that all components will fit in one scan. */
661 if (cinfo->num_components > MAX_COMPS_IN_SCAN)
662 ERREXIT2(cinfo, JERR_COMPONENT_COUNT, cinfo->num_components,
663 MAX_COMPS_IN_SCAN);
665 /* Allocate space for script.
666 * We need to put it in the permanent pool in case the application performs
667 * multiple compressions without changing the settings. To avoid a memory
668 * leak if jpeg_simple_lossless is called repeatedly for the same JPEG
669 * object, we try to re-use previously allocated space.
671 if (cinfo->script_space == NULL || cinfo->script_space_size < nscans) {
672 cinfo->script_space_size = nscans;
673 cinfo->script_space = (jpeg_scan_info *)
674 (*cinfo->mem->alloc_small) ((j_common_ptr) cinfo, JPOOL_PERMANENT,
675 cinfo->script_space_size * SIZEOF(jpeg_scan_info));
677 scanptr = cinfo->script_space;
678 cinfo->scan_info = scanptr;
679 cinfo->num_scans = nscans;
681 /* Fill the script. */
682 scanptr->comps_in_scan = ncomps;
683 for (ci = 0; ci < ncomps; ci++)
684 scanptr->component_index[ci] = ci;
685 scanptr->Ss = predictor;
686 scanptr->Se = 0;
687 scanptr->Ah = 0;
688 scanptr->Al = point_transform;
691 #endif /* C_LOSSLESS_SUPPORTED */