1 /*
2 * rdswitch.c
3 *
4 * Copyright (C) 1991-1996, Thomas G. Lane.
5 * Modified 2003-2015 by Guido Vollbeding.
6 * This file is part of the Independent JPEG Group's software.
7 * For conditions of distribution and use, see the accompanying README file.
8 *
9 * This file contains routines to process some of cjpeg's more complicated
10 * command-line switches. Switches processed here are:
11 * -qtables file Read quantization tables from text file
12 * -scans file Read scan script from text file
13 * -quality N[,N,...] Set quality ratings
14 * -qslots N[,N,...] Set component quantization table selectors
15 * -sample HxV[,HxV,...] Set component sampling factors
16 */
17
18 #include "cdjpeg.h" /* Common decls for cjpeg/djpeg applications */
19 #include <ctype.h> /* to declare isdigit(), isspace() */
20
21
22 LOCAL(int)
text_getc(FILE * file)23 text_getc (FILE * file)
24 /* Read next char, skipping over any comments (# to end of line) */
25 /* A comment/newline sequence is returned as a newline */
26 {
27 register int ch;
28
29 ch = getc(file);
30 if (ch == '#') {
31 do {
32 ch = getc(file);
33 } while (ch != '\n' && ch != EOF);
34 }
35 return ch;
36 }
37
38
39 LOCAL(boolean)
read_text_integer(FILE * file,long * result,int * termchar)40 read_text_integer (FILE * file, long * result, int * termchar)
41 /* Read an unsigned decimal integer from a file, store it in result */
42 /* Reads one trailing character after the integer; returns it in termchar */
43 {
44 register int ch;
45 register long val;
46
47 /* Skip any leading whitespace, detect EOF */
48 do {
49 ch = text_getc(file);
50 if (ch == EOF) {
51 *termchar = ch;
52 return FALSE;
53 }
54 } while (isspace(ch));
55
56 if (! isdigit(ch)) {
57 *termchar = ch;
58 return FALSE;
59 }
60
61 val = ch - '0';
62 while ((ch = text_getc(file)) != EOF) {
63 if (! isdigit(ch))
64 break;
65 val *= 10;
66 val += ch - '0';
67 }
68 *result = val;
69 *termchar = ch;
70 return TRUE;
71 }
72
73
74 GLOBAL(boolean)
read_quant_tables(j_compress_ptr cinfo,char * filename,boolean force_baseline)75 read_quant_tables (j_compress_ptr cinfo, char * filename, boolean force_baseline)
76 /* Read a set of quantization tables from the specified file.
77 * The file is plain ASCII text: decimal numbers with whitespace between.
78 * Comments preceded by '#' may be included in the file.
79 * There may be one to NUM_QUANT_TBLS tables in the file, each of 64 values.
80 * The tables are implicitly numbered 0,1,etc.
81 * NOTE: does not affect the qslots mapping, which will default to selecting
82 * table 0 for luminance (or primary) components, 1 for chrominance components.
83 * You must use -qslots if you want a different component->table mapping.
84 */
85 {
86 FILE * fp;
87 int tblno, i, termchar;
88 long val;
89 unsigned int table[DCTSIZE2];
90
91 if ((fp = fopen(filename, "r")) == NULL) {
92 fprintf(stderr, "Can't open table file %s\n", filename);
93 return FALSE;
94 }
95 tblno = 0;
96
97 while (read_text_integer(fp, &val, &termchar)) { /* read 1st element of table */
98 if (tblno >= NUM_QUANT_TBLS) {
99 fprintf(stderr, "Too many tables in file %s\n", filename);
100 fclose(fp);
101 return FALSE;
102 }
103 table[0] = (unsigned int) val;
104 for (i = 1; i < DCTSIZE2; i++) {
105 if (! read_text_integer(fp, &val, &termchar)) {
106 fprintf(stderr, "Invalid table data in file %s\n", filename);
107 fclose(fp);
108 return FALSE;
109 }
110 table[i] = (unsigned int) val;
111 }
112 jpeg_add_quant_table(cinfo, tblno, table, cinfo->q_scale_factor[tblno],
113 force_baseline);
114 tblno++;
115 }
116
117 if (termchar != EOF) {
118 fprintf(stderr, "Non-numeric data in file %s\n", filename);
119 fclose(fp);
120 return FALSE;
121 }
122
123 fclose(fp);
124 return TRUE;
125 }
126
127
128 #ifdef C_MULTISCAN_FILES_SUPPORTED
129
130 LOCAL(boolean)
read_scan_integer(FILE * file,long * result,int * termchar)131 read_scan_integer (FILE * file, long * result, int * termchar)
132 /* Variant of read_text_integer that always looks for a non-space termchar;
133 * this simplifies parsing of punctuation in scan scripts.
134 */
135 {
136 register int ch;
137
138 if (! read_text_integer(file, result, termchar))
139 return FALSE;
140 ch = *termchar;
141 while (ch != EOF && isspace(ch))
142 ch = text_getc(file);
143 if (isdigit(ch)) { /* oops, put it back */
144 if (ungetc(ch, file) == EOF)
145 return FALSE;
146 ch = ' ';
147 } else {
148 /* Any separators other than ';' and ':' are ignored;
149 * this allows user to insert commas, etc, if desired.
150 */
151 if (ch != EOF && ch != ';' && ch != ':')
152 ch = ' ';
153 }
154 *termchar = ch;
155 return TRUE;
156 }
157
158
159 GLOBAL(boolean)
read_scan_script(j_compress_ptr cinfo,char * filename)160 read_scan_script (j_compress_ptr cinfo, char * filename)
161 /* Read a scan script from the specified text file.
162 * Each entry in the file defines one scan to be emitted.
163 * Entries are separated by semicolons ';'.
164 * An entry contains one to four component indexes,
165 * optionally followed by a colon ':' and four progressive-JPEG parameters.
166 * The component indexes denote which component(s) are to be transmitted
167 * in the current scan. The first component has index 0.
168 * Sequential JPEG is used if the progressive-JPEG parameters are omitted.
169 * The file is free format text: any whitespace may appear between numbers
170 * and the ':' and ';' punctuation marks. Also, other punctuation (such
171 * as commas or dashes) can be placed between numbers if desired.
172 * Comments preceded by '#' may be included in the file.
173 * Note: we do very little validity checking here;
174 * jcmaster.c will validate the script parameters.
175 */
176 {
177 FILE * fp;
178 int scanno, ncomps, termchar;
179 long val;
180 jpeg_scan_info * scanptr;
181 #define MAX_SCANS 100 /* quite arbitrary limit */
182 jpeg_scan_info scans[MAX_SCANS];
183
184 if ((fp = fopen(filename, "r")) == NULL) {
185 fprintf(stderr, "Can't open scan definition file %s\n", filename);
186 return FALSE;
187 }
188 scanptr = scans;
189 scanno = 0;
190
191 while (read_scan_integer(fp, &val, &termchar)) {
192 if (scanno >= MAX_SCANS) {
193 fprintf(stderr, "Too many scans defined in file %s\n", filename);
194 fclose(fp);
195 return FALSE;
196 }
197 scanptr->component_index[0] = (int) val;
198 ncomps = 1;
199 while (termchar == ' ') {
200 if (ncomps >= MAX_COMPS_IN_SCAN) {
201 fprintf(stderr, "Too many components in one scan in file %s\n",
202 filename);
203 fclose(fp);
204 return FALSE;
205 }
206 if (! read_scan_integer(fp, &val, &termchar))
207 goto bogus;
208 scanptr->component_index[ncomps] = (int) val;
209 ncomps++;
210 }
211 scanptr->comps_in_scan = ncomps;
212 if (termchar == ':') {
213 if (! read_scan_integer(fp, &val, &termchar) || termchar != ' ')
214 goto bogus;
215 scanptr->Ss = (int) val;
216 if (! read_scan_integer(fp, &val, &termchar) || termchar != ' ')
217 goto bogus;
218 scanptr->Se = (int) val;
219 if (! read_scan_integer(fp, &val, &termchar) || termchar != ' ')
220 goto bogus;
221 scanptr->Ah = (int) val;
222 if (! read_scan_integer(fp, &val, &termchar))
223 goto bogus;
224 scanptr->Al = (int) val;
225 } else {
226 /* set non-progressive parameters */
227 scanptr->Ss = 0;
228 scanptr->Se = DCTSIZE2-1;
229 scanptr->Ah = 0;
230 scanptr->Al = 0;
231 }
232 if (termchar != ';' && termchar != EOF) {
233 bogus:
234 fprintf(stderr, "Invalid scan entry format in file %s\n", filename);
235 fclose(fp);
236 return FALSE;
237 }
238 scanptr++, scanno++;
239 }
240
241 if (termchar != EOF) {
242 fprintf(stderr, "Non-numeric data in file %s\n", filename);
243 fclose(fp);
244 return FALSE;
245 }
246
247 if (scanno > 0) {
248 /* Stash completed scan list in cinfo structure.
249 * NOTE: for cjpeg's use, JPOOL_IMAGE is the right lifetime for this data,
250 * but if you want to compress multiple images you'd want JPOOL_PERMANENT.
251 */
252 scanptr = (jpeg_scan_info *)
253 (*cinfo->mem->alloc_small) ((j_common_ptr) cinfo, JPOOL_IMAGE,
254 scanno * SIZEOF(jpeg_scan_info));
255 MEMCOPY(scanptr, scans, scanno * SIZEOF(jpeg_scan_info));
256 cinfo->scan_info = scanptr;
257 cinfo->num_scans = scanno;
258 }
259
260 fclose(fp);
261 return TRUE;
262 }
263
264 #endif /* C_MULTISCAN_FILES_SUPPORTED */
265
266
267 GLOBAL(boolean)
set_quality_ratings(j_compress_ptr cinfo,char * arg,boolean force_baseline)268 set_quality_ratings (j_compress_ptr cinfo, char *arg, boolean force_baseline)
269 /* Process a quality-ratings parameter string, of the form
270 * N[,N,...]
271 * If there are more q-table slots than parameters, the last value is replicated.
272 */
273 {
274 int val = 75; /* default value */
275 int tblno;
276 char ch;
277
278 for (tblno = 0; tblno < NUM_QUANT_TBLS; tblno++) {
279 if (*arg) {
280 ch = ','; /* if not set by sscanf, will be ',' */
281 if (sscanf(arg, "%d%c", &val, &ch) < 1)
282 return FALSE;
283 if (ch != ',') /* syntax check */
284 return FALSE;
285 /* Convert user 0-100 rating to percentage scaling */
286 cinfo->q_scale_factor[tblno] = jpeg_quality_scaling(val);
287 while (*arg && *arg++ != ',') /* advance to next segment of arg string */
288 ;
289 } else {
290 /* reached end of parameter, set remaining factors to last value */
291 cinfo->q_scale_factor[tblno] = jpeg_quality_scaling(val);
292 }
293 }
294 jpeg_default_qtables(cinfo, force_baseline);
295 return TRUE;
296 }
297
298
299 GLOBAL(boolean)
set_quant_slots(j_compress_ptr cinfo,char * arg)300 set_quant_slots (j_compress_ptr cinfo, char *arg)
301 /* Process a quantization-table-selectors parameter string, of the form
302 * N[,N,...]
303 * If there are more components than parameters, the last value is replicated.
304 */
305 {
306 int val = 0; /* default table # */
307 int ci;
308 char ch;
309
310 for (ci = 0; ci < MAX_COMPONENTS; ci++) {
311 if (*arg) {
312 ch = ','; /* if not set by sscanf, will be ',' */
313 if (sscanf(arg, "%d%c", &val, &ch) < 1)
314 return FALSE;
315 if (ch != ',') /* syntax check */
316 return FALSE;
317 if (val < 0 || val >= NUM_QUANT_TBLS) {
318 fprintf(stderr, "JPEG quantization tables are numbered 0..%d\n",
319 NUM_QUANT_TBLS-1);
320 return FALSE;
321 }
322 cinfo->comp_info[ci].quant_tbl_no = val;
323 while (*arg && *arg++ != ',') /* advance to next segment of arg string */
324 ;
325 } else {
326 /* reached end of parameter, set remaining components to last table */
327 cinfo->comp_info[ci].quant_tbl_no = val;
328 }
329 }
330 return TRUE;
331 }
332
333
334 GLOBAL(boolean)
set_sample_factors(j_compress_ptr cinfo,char * arg)335 set_sample_factors (j_compress_ptr cinfo, char *arg)
336 /* Process a sample-factors parameter string, of the form
337 * HxV[,HxV,...]
338 * If there are more components than parameters, "1x1" is assumed for the rest.
339 */
340 {
341 int ci, val1, val2;
342 char ch1, ch2;
343
344 for (ci = 0; ci < MAX_COMPONENTS; ci++) {
345 if (*arg) {
346 ch2 = ','; /* if not set by sscanf, will be ',' */
347 if (sscanf(arg, "%d%c%d%c", &val1, &ch1, &val2, &ch2) < 3)
348 return FALSE;
349 if ((ch1 != 'x' && ch1 != 'X') || ch2 != ',') /* syntax check */
350 return FALSE;
351 if (val1 <= 0 || val1 > MAX_SAMP_FACTOR ||
352 val2 <= 0 || val2 > MAX_SAMP_FACTOR) {
353 fprintf(stderr, "JPEG sampling factors must be 1..%d\n", MAX_SAMP_FACTOR);
354 return FALSE;
355 }
356 cinfo->comp_info[ci].h_samp_factor = val1;
357 cinfo->comp_info[ci].v_samp_factor = val2;
358 while (*arg && *arg++ != ',') /* advance to next segment of arg string */
359 ;
360 } else {
361 /* reached end of parameter, set remaining components to 1x1 sampling */
362 cinfo->comp_info[ci].h_samp_factor = 1;
363 cinfo->comp_info[ci].v_samp_factor = 1;
364 }
365 }
366 return TRUE;
367 }
368