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.
8 * This file contains common declarations for the sample applications
9 * cjpeg and djpeg. It is NOT used by the core JPEG library.
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 */
16 #include "jerror.h" /* get library error codes too */
17 #include "cderror.h" /* get application-specific error codes */
21 * Object interface for cjpeg's source file decoding modules
24 typedef struct cjpeg_source_struct
* cjpeg_source_ptr
;
26 struct 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
));
37 JDIMENSION buffer_height
;
42 * Object interface for djpeg's output file encoding modules
45 typedef struct djpeg_dest_struct
* djpeg_dest_ptr
;
47 struct 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.
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
,
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
));
61 /* Target file spec; filled in by djpeg.c after object is created. */
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.
69 JDIMENSION buffer_height
;
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.
81 struct 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 */
89 typedef struct cdjpeg_progress_mgr
* cd_progress_ptr
;
92 /* Short forms of external names for systems with brain-damaged linkers. */
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 */
118 /* Module selection routines for I/O modules. */
120 EXTERN(cjpeg_source_ptr
) jinit_read_bmp
JPP((j_compress_ptr cinfo
));
121 EXTERN(djpeg_dest_ptr
) jinit_write_bmp
JPP((j_decompress_ptr cinfo
,
123 EXTERN(cjpeg_source_ptr
) jinit_read_gif
JPP((j_compress_ptr cinfo
));
124 EXTERN(djpeg_dest_ptr
) jinit_write_gif
JPP((j_decompress_ptr cinfo
));
125 EXTERN(cjpeg_source_ptr
) jinit_read_ppm
JPP((j_compress_ptr cinfo
));
126 EXTERN(djpeg_dest_ptr
) jinit_write_ppm
JPP((j_decompress_ptr cinfo
));
127 EXTERN(cjpeg_source_ptr
) jinit_read_rle
JPP((j_compress_ptr cinfo
));
128 EXTERN(djpeg_dest_ptr
) jinit_write_rle
JPP((j_decompress_ptr cinfo
));
129 EXTERN(cjpeg_source_ptr
) jinit_read_targa
JPP((j_compress_ptr cinfo
));
130 EXTERN(djpeg_dest_ptr
) jinit_write_targa
JPP((j_decompress_ptr cinfo
));
132 /* cjpeg support routines (in rdswitch.c) */
134 EXTERN(boolean
) read_quant_tables
JPP((j_compress_ptr cinfo
, char * filename
,
135 boolean force_baseline
));
136 EXTERN(boolean
) read_scan_script
JPP((j_compress_ptr cinfo
, char * filename
));
137 EXTERN(boolean
) set_quality_ratings
JPP((j_compress_ptr cinfo
, char *arg
,
138 boolean force_baseline
));
139 EXTERN(boolean
) set_quant_slots
JPP((j_compress_ptr cinfo
, char *arg
));
140 EXTERN(boolean
) set_sample_factors
JPP((j_compress_ptr cinfo
, char *arg
));
142 /* djpeg support routines (in rdcolmap.c) */
144 EXTERN(void) read_color_map
JPP((j_decompress_ptr cinfo
, FILE * infile
));
146 /* common support routines (in cdjpeg.c) */
148 EXTERN(void) enable_signal_catcher
JPP((j_common_ptr cinfo
));
149 EXTERN(void) start_progress_monitor
JPP((j_common_ptr cinfo
,
150 cd_progress_ptr progress
));
151 EXTERN(void) end_progress_monitor
JPP((j_common_ptr cinfo
));
152 EXTERN(boolean
) keymatch
JPP((char * arg
, const char * keyword
, int minchars
));
153 EXTERN(FILE *) read_stdin
JPP((void));
154 EXTERN(FILE *) write_stdout
JPP((void));
156 /* miscellaneous useful macros */
158 #ifdef DONT_USE_B_MODE /* define mode parameters for fopen() */
159 #define READ_BINARY "r"
160 #define WRITE_BINARY "w"
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"
171 #ifndef EXIT_FAILURE /* define exit() codes if not provided */
172 #define EXIT_FAILURE 1
176 #define EXIT_SUCCESS 1 /* VMS is very nonstandard */
178 #define EXIT_SUCCESS 0
183 #define EXIT_WARNING 1 /* VMS is very nonstandard */
185 #define EXIT_WARNING 2