4 * Copyright (C) 1991-1997, Thomas G. Lane.
5 * Modified 2009 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.
9 * This file contains a command-line user interface for the JPEG decompressor.
10 * It should work on any system with Unix- or MS-DOS-style command lines.
12 * Two different command line styles are permitted, depending on the
13 * compile-time switch TWO_FILE_COMMANDLINE:
14 * djpeg [options] inputfile outputfile
15 * djpeg [options] [inputfile]
16 * In the second style, output is always to standard output, which you'd
17 * normally redirect to a file or pipe to some other program. Input is
18 * either from a named file or from standard input (typically redirected).
19 * The second style is convenient on Unix but is unhelpful on systems that
20 * don't support pipes. Also, you MUST use the first style if your system
21 * doesn't do binary I/O to stdin/stdout.
22 * To simplify script writing, the "-outfile" switch is provided. The syntax
23 * djpeg [options] -outfile outputfile inputfile
24 * works regardless of which command line style is used.
27 #include "cdjpeg.h" /* Common decls for cjpeg/djpeg applications */
28 #include "jversion.h" /* for version message */
30 #include <ctype.h> /* to declare isprint() */
32 #ifdef USE_CCOMMAND /* command-line reader for Macintosh */
34 #include <SIOUX.h> /* Metrowerks needs this */
35 #include <console.h> /* ... and this */
38 #include <console.h> /* Think declares it here */
43 /* Create the add-on message string table. */
45 #define JMESSAGE(code,string) string ,
47 static const char * const cdjpeg_message_table[] = {
54 * This list defines the known output image formats
55 * (not all of which need be supported by a given version).
56 * You can change the default output format by defining DEFAULT_FMT;
57 * indeed, you had better do so if you undefine PPM_SUPPORTED.
61 FMT_BMP, /* BMP format (Windows flavor) */
62 FMT_GIF, /* GIF format */
63 FMT_OS2, /* BMP format (OS/2 flavor) */
64 FMT_PPM, /* PPM/PGM (PBMPLUS formats) */
65 FMT_RLE, /* RLE format */
66 FMT_TARGA, /* Targa format */
67 FMT_TIFF /* TIFF format */
70 #ifndef DEFAULT_FMT /* so can override from CFLAGS in Makefile */
71 #define DEFAULT_FMT FMT_PPM
74 static IMAGE_FORMATS requested_fmt;
78 * Argument-parsing code.
79 * The switch parser is designed to be useful with DOS-style command line
80 * syntax, ie, intermixed switches and file names, where only the switches
81 * to the left of a given file name affect processing of that file.
82 * The main program in this file doesn't actually use this capability...
86 static const char * progname; /* program name for error messages */
87 static char * outfilename; /* for -outfile switch */
92 /* complain about bad command line */
94 fprintf(stderr, "usage: %s [switches] ", progname);
95 #ifdef TWO_FILE_COMMANDLINE
96 fprintf(stderr, "inputfile outputfile\n");
98 fprintf(stderr, "[inputfile]\n");
101 fprintf(stderr, "Switches (names may be abbreviated):\n");
102 fprintf(stderr, " -colors N Reduce image to no more than N colors\n");
103 fprintf(stderr, " -fast Fast, low-quality processing\n");
104 fprintf(stderr, " -grayscale Force grayscale output\n");
105 #ifdef IDCT_SCALING_SUPPORTED
106 fprintf(stderr, " -scale M/N Scale output image by fraction M/N, eg, 1/8\n");
109 fprintf(stderr, " -bmp Select BMP output format (Windows style)%s\n",
110 (DEFAULT_FMT == FMT_BMP ? " (default)" : ""));
113 fprintf(stderr, " -gif Select GIF output format%s\n",
114 (DEFAULT_FMT == FMT_GIF ? " (default)" : ""));
117 fprintf(stderr, " -os2 Select BMP output format (OS/2 style)%s\n",
118 (DEFAULT_FMT == FMT_OS2 ? " (default)" : ""));
121 fprintf(stderr, " -pnm Select PBMPLUS (PPM/PGM) output format%s\n",
122 (DEFAULT_FMT == FMT_PPM ? " (default)" : ""));
125 fprintf(stderr, " -rle Select Utah RLE output format%s\n",
126 (DEFAULT_FMT == FMT_RLE ? " (default)" : ""));
128 #ifdef TARGA_SUPPORTED
129 fprintf(stderr, " -targa Select Targa output format%s\n",
130 (DEFAULT_FMT == FMT_TARGA ? " (default)" : ""));
132 fprintf(stderr, "Switches for advanced users:\n");
133 #ifdef DCT_ISLOW_SUPPORTED
134 fprintf(stderr, " -dct int Use integer DCT method%s\n",
135 (JDCT_DEFAULT == JDCT_ISLOW ? " (default)" : ""));
137 #ifdef DCT_IFAST_SUPPORTED
138 fprintf(stderr, " -dct fast Use fast integer DCT (less accurate)%s\n",
139 (JDCT_DEFAULT == JDCT_IFAST ? " (default)" : ""));
141 #ifdef DCT_FLOAT_SUPPORTED
142 fprintf(stderr, " -dct float Use floating-point DCT method%s\n",
143 (JDCT_DEFAULT == JDCT_FLOAT ? " (default)" : ""));
145 fprintf(stderr, " -dither fs Use F-S dithering (default)\n");
146 fprintf(stderr, " -dither none Don't use dithering in quantization\n");
147 fprintf(stderr, " -dither ordered Use ordered dither (medium speed, quality)\n");
148 #ifdef QUANT_2PASS_SUPPORTED
149 fprintf(stderr, " -map FILE Map to colors used in named image file\n");
151 fprintf(stderr, " -nosmooth Don't use high-quality upsampling\n");
152 #ifdef QUANT_1PASS_SUPPORTED
153 fprintf(stderr, " -onepass Use 1-pass quantization (fast, low quality)\n");
155 fprintf(stderr, " -maxmemory N Maximum memory to use (in kbytes)\n");
156 fprintf(stderr, " -outfile name Specify name for output file\n");
157 fprintf(stderr, " -verbose or -debug Emit debug output\n");
163 parse_switches (j_decompress_ptr cinfo, int argc, char **argv,
164 int last_file_arg_seen, boolean for_real)
165 /* Parse optional switches.
166 * Returns argv[] index of first file-name argument (== argc if none).
167 * Any file names with indexes <= last_file_arg_seen are ignored;
168 * they have presumably been processed in a previous iteration.
169 * (Pass 0 for last_file_arg_seen on the first or only iteration.)
170 * for_real is FALSE on the first (dummy) pass; we may skip any expensive
177 /* Set up default JPEG parameters. */
178 requested_fmt = DEFAULT_FMT; /* set default output file format */
180 cinfo->err->trace_level = 0;
182 /* Scan command line options, adjust parameters */
184 for (argn = 1; argn < argc; argn++) {
187 /* Not a switch, must be a file name argument */
188 if (argn <= last_file_arg_seen) {
189 outfilename = NULL; /* -outfile applies to just one input file */
190 continue; /* ignore this name if previously processed */
192 break; /* else done parsing switches */
194 arg++; /* advance past switch marker character */
196 if (keymatch(arg, "bmp", 1)) {
197 /* BMP output format. */
198 requested_fmt = FMT_BMP;
200 } else if (keymatch(arg, "colors", 1) || keymatch(arg, "colours", 1) ||
201 keymatch(arg, "quantize", 1) || keymatch(arg, "quantise", 1)) {
202 /* Do color quantization. */
205 if (++argn >= argc) /* advance to next argument */
207 if (sscanf(argv[argn], "%d", &val) != 1)
209 cinfo->desired_number_of_colors = val;
210 cinfo->quantize_colors = TRUE;
212 } else if (keymatch(arg, "dct", 2)) {
213 /* Select IDCT algorithm. */
214 if (++argn >= argc) /* advance to next argument */
216 if (keymatch(argv[argn], "int", 1)) {
217 cinfo->dct_method = JDCT_ISLOW;
218 } else if (keymatch(argv[argn], "fast", 2)) {
219 cinfo->dct_method = JDCT_IFAST;
220 } else if (keymatch(argv[argn], "float", 2)) {
221 cinfo->dct_method = JDCT_FLOAT;
225 } else if (keymatch(arg, "dither", 2)) {
226 /* Select dithering algorithm. */
227 if (++argn >= argc) /* advance to next argument */
229 if (keymatch(argv[argn], "fs", 2)) {
230 cinfo->dither_mode = JDITHER_FS;
231 } else if (keymatch(argv[argn], "none", 2)) {
232 cinfo->dither_mode = JDITHER_NONE;
233 } else if (keymatch(argv[argn], "ordered", 2)) {
234 cinfo->dither_mode = JDITHER_ORDERED;
238 } else if (keymatch(arg, "debug", 1) || keymatch(arg, "verbose", 1)) {
239 /* Enable debug printouts. */
240 /* On first -d, print version identification */
241 static boolean printed_version = FALSE;
243 if (! printed_version) {
244 fprintf(stderr, "Independent JPEG Group's DJPEG, version %s\n%s\n",
245 JVERSION, JCOPYRIGHT);
246 printed_version = TRUE;
248 cinfo->err->trace_level++;
250 } else if (keymatch(arg, "fast", 1)) {
251 /* Select recommended processing options for quick-and-dirty output. */
252 cinfo->two_pass_quantize = FALSE;
253 cinfo->dither_mode = JDITHER_ORDERED;
254 if (! cinfo->quantize_colors) /* don't override an earlier -colors */
255 cinfo->desired_number_of_colors = 216;
256 cinfo->dct_method = JDCT_FASTEST;
257 cinfo->do_fancy_upsampling = FALSE;
259 } else if (keymatch(arg, "gif", 1)) {
260 /* GIF output format. */
261 requested_fmt = FMT_GIF;
263 } else if (keymatch(arg, "grayscale", 2) || keymatch(arg, "greyscale",2)) {
264 /* Force monochrome output. */
265 cinfo->out_color_space = JCS_GRAYSCALE;
267 } else if (keymatch(arg, "map", 3)) {
268 /* Quantize to a color map taken from an input file. */
269 if (++argn >= argc) /* advance to next argument */
271 if (for_real) { /* too expensive to do twice! */
272 #ifdef QUANT_2PASS_SUPPORTED /* otherwise can't quantize to supplied map */
275 if ((mapfile = fopen(argv[argn], READ_BINARY)) == NULL) {
276 fprintf(stderr, "%s: can't open %s\n", progname, argv[argn]);
279 read_color_map(cinfo, mapfile);
281 cinfo->quantize_colors = TRUE;
283 ERREXIT(cinfo, JERR_NOT_COMPILED);
287 } else if (keymatch(arg, "maxmemory", 3)) {
288 /* Maximum memory in Kb (or Mb with 'm'). */
292 if (++argn >= argc) /* advance to next argument */
294 if (sscanf(argv[argn], "%ld%c", &lval, &ch) < 1)
296 if (ch == 'm' || ch == 'M')
298 cinfo->mem->max_memory_to_use = lval * 1000L;
300 } else if (keymatch(arg, "nosmooth", 3)) {
301 /* Suppress fancy upsampling */
302 cinfo->do_fancy_upsampling = FALSE;
304 } else if (keymatch(arg, "onepass", 3)) {
305 /* Use fast one-pass quantization. */
306 cinfo->two_pass_quantize = FALSE;
308 } else if (keymatch(arg, "os2", 3)) {
309 /* BMP output format (OS/2 flavor). */
310 requested_fmt = FMT_OS2;
312 } else if (keymatch(arg, "outfile", 4)) {
313 /* Set output file name. */
314 if (++argn >= argc) /* advance to next argument */
316 outfilename = argv[argn]; /* save it away for later use */
318 } else if (keymatch(arg, "pnm", 1) || keymatch(arg, "ppm", 1)) {
319 /* PPM/PGM output format. */
320 requested_fmt = FMT_PPM;
322 } else if (keymatch(arg, "rle", 1)) {
323 /* RLE output format. */
324 requested_fmt = FMT_RLE;
326 } else if (keymatch(arg, "scale", 1)) {
327 /* Scale the output image by a fraction M/N. */
328 if (++argn >= argc) /* advance to next argument */
330 if (sscanf(argv[argn], "%d/%d",
331 &cinfo->scale_num, &cinfo->scale_denom) < 1)
334 } else if (keymatch(arg, "targa", 1)) {
335 /* Targa output format. */
336 requested_fmt = FMT_TARGA;
339 usage(); /* bogus switch */
343 return argn; /* return index of next arg (file name) */
348 * Marker processor for COM and interesting APPn markers.
349 * This replaces the library's built-in processor, which just skips the marker.
350 * We want to print out the marker as text, to the extent possible.
351 * Note this code relies on a non-suspending data source.
355 jpeg_getc (j_decompress_ptr cinfo)
358 struct jpeg_source_mgr * datasrc = cinfo->src;
360 if (datasrc->bytes_in_buffer == 0) {
361 if (! (*datasrc->fill_input_buffer) (cinfo))
362 ERREXIT(cinfo, JERR_CANT_SUSPEND);
364 datasrc->bytes_in_buffer--;
365 return GETJOCTET(*datasrc->next_input_byte++);
370 print_text_marker (j_decompress_ptr cinfo)
372 boolean traceit = (cinfo->err->trace_level >= 1);
375 unsigned int lastch = 0;
377 length = jpeg_getc(cinfo) << 8;
378 length += jpeg_getc(cinfo);
379 length -= 2; /* discount the length word itself */
382 if (cinfo->unread_marker == JPEG_COM)
383 fprintf(stderr, "Comment, length %ld:\n", (long) length);
384 else /* assume it is an APPn otherwise */
385 fprintf(stderr, "APP%d, length %ld:\n",
386 cinfo->unread_marker - JPEG_APP0, (long) length);
389 while (--length >= 0) {
390 ch = jpeg_getc(cinfo);
392 /* Emit the character in a readable form.
393 * Nonprintables are converted to \nnn form,
394 * while \ is converted to \\.
395 * Newlines in CR, CR/LF, or LF form will be printed as one newline.
398 fprintf(stderr, "\n");
399 } else if (ch == '\n') {
401 fprintf(stderr, "\n");
402 } else if (ch == '\\') {
403 fprintf(stderr, "\\\\");
404 } else if (isprint(ch)) {
407 fprintf(stderr, "\\%03o", ch);
414 fprintf(stderr, "\n");
425 main (int argc, char **argv)
427 struct jpeg_decompress_struct cinfo;
428 struct jpeg_error_mgr jerr;
429 #ifdef PROGRESS_REPORT
430 struct cdjpeg_progress_mgr progress;
433 djpeg_dest_ptr dest_mgr = NULL;
436 JDIMENSION num_scanlines;
438 /* On Mac, fetch a command line. */
440 argc = ccommand(&argv);
444 if (progname == NULL || progname[0] == 0)
445 progname = "djpeg"; /* in case C library doesn't provide it */
447 /* Initialize the JPEG decompression object with default error handling. */
448 cinfo.err = jpeg_std_error(&jerr);
449 jpeg_create_decompress(&cinfo);
450 /* Add some application-specific error messages (from cderror.h) */
451 jerr.addon_message_table = cdjpeg_message_table;
452 jerr.first_addon_message = JMSG_FIRSTADDONCODE;
453 jerr.last_addon_message = JMSG_LASTADDONCODE;
455 /* Insert custom marker processor for COM and APP12.
456 * APP12 is used by some digital camera makers for textual info,
457 * so we provide the ability to display it as text.
458 * If you like, additional APPn marker types can be selected for display,
459 * but don't try to override APP0 or APP14 this way (see libjpeg.doc).
461 jpeg_set_marker_processor(&cinfo, JPEG_COM, print_text_marker);
462 jpeg_set_marker_processor(&cinfo, JPEG_APP0+12, print_text_marker);
464 /* Now safe to enable signal catcher. */
465 #ifdef NEED_SIGNAL_CATCHER
466 enable_signal_catcher((j_common_ptr) &cinfo);
469 /* Scan command line to find file names. */
470 /* It is convenient to use just one switch-parsing routine, but the switch
471 * values read here are ignored; we will rescan the switches after opening
473 * (Exception: tracing level set here controls verbosity for COM markers
474 * found during jpeg_read_header...)
477 file_index = parse_switches(&cinfo, argc, argv, 0, FALSE);
479 #ifdef TWO_FILE_COMMANDLINE
480 /* Must have either -outfile switch or explicit output file name */
481 if (outfilename == NULL) {
482 if (file_index != argc-2) {
483 fprintf(stderr, "%s: must name one input and one output file\n",
487 outfilename = argv[file_index+1];
489 if (file_index != argc-1) {
490 fprintf(stderr, "%s: must name one input and one output file\n",
496 /* Unix style: expect zero or one file name */
497 if (file_index < argc-1) {
498 fprintf(stderr, "%s: only one input file\n", progname);
501 #endif /* TWO_FILE_COMMANDLINE */
503 /* Open the input file. */
504 if (file_index < argc) {
505 if ((input_file = fopen(argv[file_index], READ_BINARY)) == NULL) {
506 fprintf(stderr, "%s: can't open %s\n", progname, argv[file_index]);
510 /* default input file is stdin */
511 input_file = read_stdin();
514 /* Open the output file. */
515 if (outfilename != NULL) {
516 if ((output_file = fopen(outfilename, WRITE_BINARY)) == NULL) {
517 fprintf(stderr, "%s: can't open %s\n", progname, outfilename);
521 /* default output file is stdout */
522 output_file = write_stdout();
525 #ifdef PROGRESS_REPORT
526 start_progress_monitor((j_common_ptr) &cinfo, &progress);
529 /* Specify data source for decompression */
530 jpeg_stdio_src(&cinfo, input_file);
532 /* Read file header, set default decompression parameters */
533 (void) jpeg_read_header(&cinfo, TRUE);
535 /* Adjust default decompression parameters by re-parsing the options */
536 file_index = parse_switches(&cinfo, argc, argv, 0, TRUE);
538 /* Initialize the output module now to let it override any crucial
539 * option settings (for instance, GIF wants to force color quantization).
541 switch (requested_fmt) {
544 dest_mgr = jinit_write_bmp(&cinfo, FALSE);
547 dest_mgr = jinit_write_bmp(&cinfo, TRUE);
552 dest_mgr = jinit_write_gif(&cinfo);
557 dest_mgr = jinit_write_ppm(&cinfo);
562 dest_mgr = jinit_write_rle(&cinfo);
565 #ifdef TARGA_SUPPORTED
567 dest_mgr = jinit_write_targa(&cinfo);
571 ERREXIT(&cinfo, JERR_UNSUPPORTED_FORMAT);
574 dest_mgr->output_file = output_file;
576 /* Start decompressor */
577 (void) jpeg_start_decompress(&cinfo);
579 /* Write output file header */
580 (*dest_mgr->start_output) (&cinfo, dest_mgr);
583 while (cinfo.output_scanline < cinfo.output_height) {
584 num_scanlines = jpeg_read_scanlines(&cinfo, dest_mgr->buffer,
585 dest_mgr->buffer_height);
586 (*dest_mgr->put_pixel_rows) (&cinfo, dest_mgr, num_scanlines);
589 #ifdef PROGRESS_REPORT
590 /* Hack: count final pass as done in case finish_output does an extra pass.
591 * The library won't have updated completed_passes.
593 progress.pub.completed_passes = progress.pub.total_passes;
596 /* Finish decompression and release memory.
597 * I must do it in this order because output module has allocated memory
598 * of lifespan JPOOL_IMAGE; it needs to finish before releasing memory.
600 (*dest_mgr->finish_output) (&cinfo, dest_mgr);
601 (void) jpeg_finish_decompress(&cinfo);
602 jpeg_destroy_decompress(&cinfo);
604 /* Close files, if we opened them */
605 if (input_file != stdin)
607 if (output_file != stdout)
610 #ifdef PROGRESS_REPORT
611 end_progress_monitor((j_common_ptr) &cinfo);
615 exit(jerr.num_warnings ? EXIT_WARNING : EXIT_SUCCESS);
616 return 0; /* suppress no-return-value warnings */