1/* 2 * cdjpeg.h 3 * 4 * Copyright (C) 1994-1997, 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 common declarations for the sample applications 9 * cjpeg and djpeg. It is NOT used by the core JPEG library. 10 */ 11 12#define JPEG_CJPEG_DJPEG /* define proper options in jconfig.h */ 13#define JPEG_INTERNAL_OPTIONS /* cjpeg.c,djpeg.c need to see xxx_SUPPORTED */ 14#include "jinclude.h" 15#include "jpeglib.h" 16#include "jerror.h" /* get library error codes too */ 17#include "cderror.h" /* get application-specific error codes */ 18 19 20/* 21 * Object interface for cjpeg's source file decoding modules 22 */ 23 24typedef struct cjpeg_source_struct * cjpeg_source_ptr; 25 26struct cjpeg_source_struct { 27 JMETHOD(void, start_input, (j_compress_ptr cinfo, 28 cjpeg_source_ptr sinfo)); 29 JMETHOD(JDIMENSION, get_pixel_rows, (j_compress_ptr cinfo, 30 cjpeg_source_ptr sinfo)); 31 JMETHOD(void, finish_input, (j_compress_ptr cinfo, 32 cjpeg_source_ptr sinfo)); 33 34 FILE *input_file; 35 36 JSAMPARRAY buffer; 37 JDIMENSION buffer_height; 38}; 39 40 41/* 42 * Object interface for djpeg's output file encoding modules 43 */ 44 45typedef struct djpeg_dest_struct * djpeg_dest_ptr; 46 47struct djpeg_dest_struct { 48 /* start_output is called after jpeg_start_decompress finishes. 49 * The color map will be ready at this time, if one is needed. 50 */ 51 JMETHOD(void, start_output, (j_decompress_ptr cinfo, 52 djpeg_dest_ptr dinfo)); 53 /* Emit the specified number of pixel rows from the buffer. */ 54 JMETHOD(void, put_pixel_rows, (j_decompress_ptr cinfo, 55 djpeg_dest_ptr dinfo, 56 JDIMENSION rows_supplied)); 57 /* Finish up at the end of the image. */ 58 JMETHOD(void, finish_output, (j_decompress_ptr cinfo, 59 djpeg_dest_ptr dinfo)); 60 61 /* Target file spec; filled in by djpeg.c after object is created. */ 62 FILE * output_file; 63 64 /* Output pixel-row buffer. Created by module init or start_output. 65 * Width is cinfo->output_width * cinfo->output_components; 66 * height is buffer_height. 67 */ 68 JSAMPARRAY buffer; 69 JDIMENSION buffer_height; 70}; 71 72 73/* 74 * cjpeg/djpeg may need to perform extra passes to convert to or from 75 * the source/destination file format. The JPEG library does not know 76 * about these passes, but we'd like them to be counted by the progress 77 * monitor. We use an expanded progress monitor object to hold the 78 * additional pass count. 79 */ 80 81struct cdjpeg_progress_mgr { 82 struct jpeg_progress_mgr pub; /* fields known to JPEG library */ 83 int completed_extra_passes; /* extra passes completed */ 84 int total_extra_passes; /* total extra */ 85 /* last printed percentage stored here to avoid multiple printouts */ 86 int percent_done; 87}; 88 89typedef struct cdjpeg_progress_mgr * cd_progress_ptr; 90 91 92/* Short forms of external names for systems with brain-damaged linkers. */ 93 94#ifdef NEED_SHORT_EXTERNAL_NAMES 95#define jinit_read_bmp jIRdBMP 96#define jinit_write_bmp jIWrBMP 97#define jinit_read_gif jIRdGIF 98#define jinit_write_gif jIWrGIF 99#define jinit_read_ppm jIRdPPM 100#define jinit_write_ppm jIWrPPM 101#define jinit_read_rle jIRdRLE 102#define jinit_write_rle jIWrRLE 103#define jinit_read_targa jIRdTarga 104#define jinit_write_targa jIWrTarga 105#define read_quant_tables RdQTables 106#define read_scan_script RdScnScript 107#define set_quality_ratings SetQRates 108#define set_quant_slots SetQSlots 109#define set_sample_factors SetSFacts 110#define read_color_map RdCMap 111#define enable_signal_catcher EnSigCatcher 112#define start_progress_monitor StProgMon 113#define end_progress_monitor EnProgMon 114#define read_stdin RdStdin 115#define write_stdout WrStdout 116#endif /* NEED_SHORT_EXTERNAL_NAMES */ 117 118/* Module selection routines for I/O modules. */ 119 120EXTERN(cjpeg_source_ptr) jinit_read_bmp JPP((j_compress_ptr cinfo)); 121EXTERN(djpeg_dest_ptr) jinit_write_bmp JPP((j_decompress_ptr cinfo, 122 boolean is_os2)); 123EXTERN(cjpeg_source_ptr) jinit_read_gif JPP((j_compress_ptr cinfo)); 124EXTERN(djpeg_dest_ptr) jinit_write_gif JPP((j_decompress_ptr cinfo)); 125EXTERN(cjpeg_source_ptr) jinit_read_ppm JPP((j_compress_ptr cinfo)); 126EXTERN(djpeg_dest_ptr) jinit_write_ppm JPP((j_decompress_ptr cinfo)); 127EXTERN(cjpeg_source_ptr) jinit_read_rle JPP((j_compress_ptr cinfo)); 128EXTERN(djpeg_dest_ptr) jinit_write_rle JPP((j_decompress_ptr cinfo)); 129EXTERN(cjpeg_source_ptr) jinit_read_targa JPP((j_compress_ptr cinfo)); 130EXTERN(djpeg_dest_ptr) jinit_write_targa JPP((j_decompress_ptr cinfo)); 131 132/* cjpeg support routines (in rdswitch.c) */ 133 134EXTERN(boolean) read_quant_tables JPP((j_compress_ptr cinfo, char * filename, 135 boolean force_baseline)); 136EXTERN(boolean) read_scan_script JPP((j_compress_ptr cinfo, char * filename)); 137EXTERN(boolean) set_quality_ratings JPP((j_compress_ptr cinfo, char *arg, 138 boolean force_baseline)); 139EXTERN(boolean) set_quant_slots JPP((j_compress_ptr cinfo, char *arg)); 140EXTERN(boolean) set_sample_factors JPP((j_compress_ptr cinfo, char *arg)); 141 142/* djpeg support routines (in rdcolmap.c) */ 143 144EXTERN(void) read_color_map JPP((j_decompress_ptr cinfo, FILE * infile)); 145 146/* common support routines (in cdjpeg.c) */ 147 148EXTERN(void) enable_signal_catcher JPP((j_common_ptr cinfo)); 149EXTERN(void) start_progress_monitor JPP((j_common_ptr cinfo, 150 cd_progress_ptr progress)); 151EXTERN(void) end_progress_monitor JPP((j_common_ptr cinfo)); 152EXTERN(boolean) keymatch JPP((char * arg, const char * keyword, int minchars)); 153EXTERN(FILE *) read_stdin JPP((void)); 154EXTERN(FILE *) write_stdout JPP((void)); 155 156/* miscellaneous useful macros */ 157 158#ifdef DONT_USE_B_MODE /* define mode parameters for fopen() */ 159#define READ_BINARY "r" 160#define WRITE_BINARY "w" 161#else 162#ifdef VMS /* VMS is very nonstandard */ 163#define READ_BINARY "rb", "ctx=stm" 164#define WRITE_BINARY "wb", "ctx=stm" 165#else /* standard ANSI-compliant case */ 166#define READ_BINARY "rb" 167#define WRITE_BINARY "wb" 168#endif 169#endif 170 171#ifndef EXIT_FAILURE /* define exit() codes if not provided */ 172#define EXIT_FAILURE 1 173#endif 174#ifndef EXIT_SUCCESS 175#ifdef VMS 176#define EXIT_SUCCESS 1 /* VMS is very nonstandard */ 177#else 178#define EXIT_SUCCESS 0 179#endif 180#endif 181#ifndef EXIT_WARNING 182#ifdef VMS 183#define EXIT_WARNING 1 /* VMS is very nonstandard */ 184#else 185#define EXIT_WARNING 2 186#endif 187#endif 188