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_quant_slots SetQSlots 108#define set_sample_factors SetSFacts 109#define read_color_map RdCMap 110#define enable_signal_catcher EnSigCatcher 111#define start_progress_monitor StProgMon 112#define end_progress_monitor EnProgMon 113#define read_stdin RdStdin 114#define write_stdout WrStdout 115#endif /* NEED_SHORT_EXTERNAL_NAMES */ 116 117/* Module selection routines for I/O modules. */ 118 119EXTERN(cjpeg_source_ptr) jinit_read_bmp JPP((j_compress_ptr cinfo)); 120EXTERN(djpeg_dest_ptr) jinit_write_bmp JPP((j_decompress_ptr cinfo, 121 boolean is_os2)); 122EXTERN(cjpeg_source_ptr) jinit_read_gif JPP((j_compress_ptr cinfo)); 123EXTERN(djpeg_dest_ptr) jinit_write_gif JPP((j_decompress_ptr cinfo)); 124EXTERN(cjpeg_source_ptr) jinit_read_ppm JPP((j_compress_ptr cinfo)); 125EXTERN(djpeg_dest_ptr) jinit_write_ppm JPP((j_decompress_ptr cinfo)); 126EXTERN(cjpeg_source_ptr) jinit_read_rle JPP((j_compress_ptr cinfo)); 127EXTERN(djpeg_dest_ptr) jinit_write_rle JPP((j_decompress_ptr cinfo)); 128EXTERN(cjpeg_source_ptr) jinit_read_targa JPP((j_compress_ptr cinfo)); 129EXTERN(djpeg_dest_ptr) jinit_write_targa JPP((j_decompress_ptr cinfo)); 130 131/* cjpeg support routines (in rdswitch.c) */ 132 133EXTERN(boolean) read_quant_tables JPP((j_compress_ptr cinfo, char * filename, 134 int scale_factor, boolean force_baseline)); 135EXTERN(boolean) read_scan_script JPP((j_compress_ptr cinfo, char * filename)); 136EXTERN(boolean) set_quant_slots JPP((j_compress_ptr cinfo, char *arg)); 137EXTERN(boolean) set_sample_factors JPP((j_compress_ptr cinfo, char *arg)); 138 139/* djpeg support routines (in rdcolmap.c) */ 140 141EXTERN(void) read_color_map JPP((j_decompress_ptr cinfo, FILE * infile)); 142 143/* common support routines (in cdjpeg.c) */ 144 145EXTERN(void) enable_signal_catcher JPP((j_common_ptr cinfo)); 146EXTERN(void) start_progress_monitor JPP((j_common_ptr cinfo, 147 cd_progress_ptr progress)); 148EXTERN(void) end_progress_monitor JPP((j_common_ptr cinfo)); 149EXTERN(boolean) keymatch JPP((char * arg, const char * keyword, int minchars)); 150EXTERN(FILE *) read_stdin JPP((void)); 151EXTERN(FILE *) write_stdout JPP((void)); 152 153/* miscellaneous useful macros */ 154 155#ifdef DONT_USE_B_MODE /* define mode parameters for fopen() */ 156#define READ_BINARY "r" 157#define WRITE_BINARY "w" 158#else 159#ifdef VMS /* VMS is very nonstandard */ 160#define READ_BINARY "rb", "ctx=stm" 161#define WRITE_BINARY "wb", "ctx=stm" 162#else /* standard ANSI-compliant case */ 163#define READ_BINARY "rb" 164#define WRITE_BINARY "wb" 165#endif 166#endif 167 168#ifndef EXIT_FAILURE /* define exit() codes if not provided */ 169#define EXIT_FAILURE 1 170#endif 171#ifndef EXIT_SUCCESS 172#ifdef VMS 173#define EXIT_SUCCESS 1 /* VMS is very nonstandard */ 174#else 175#define EXIT_SUCCESS 0 176#endif 177#endif 178#ifndef EXIT_WARNING 179#ifdef VMS 180#define EXIT_WARNING 1 /* VMS is very nonstandard */ 181#else 182#define EXIT_WARNING 2 183#endif 184#endif 185