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_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 */
117
/* Module selection routines for I/O modules. */
119
EXTERN(cjpeg_source_ptr) jinit_read_bmp JPP((j_compress_ptr cinfo));
120
EXTERN(djpeg_dest_ptr) jinit_write_bmp JPP((j_decompress_ptr cinfo,
122
EXTERN(cjpeg_source_ptr) jinit_read_gif JPP((j_compress_ptr cinfo));
123
EXTERN(djpeg_dest_ptr) jinit_write_gif JPP((j_decompress_ptr cinfo));
124
EXTERN(cjpeg_source_ptr) jinit_read_ppm JPP((j_compress_ptr cinfo));
125
EXTERN(djpeg_dest_ptr) jinit_write_ppm JPP((j_decompress_ptr cinfo));
126
EXTERN(cjpeg_source_ptr) jinit_read_rle JPP((j_compress_ptr cinfo));
127
EXTERN(djpeg_dest_ptr) jinit_write_rle JPP((j_decompress_ptr cinfo));
128
EXTERN(cjpeg_source_ptr) jinit_read_targa JPP((j_compress_ptr cinfo));
129
EXTERN(djpeg_dest_ptr) jinit_write_targa JPP((j_decompress_ptr cinfo));
131
/* cjpeg support routines (in rdswitch.c) */
133
EXTERN(boolean) read_quant_tables JPP((j_compress_ptr cinfo, char * filename,
134
int scale_factor, boolean force_baseline));
135
EXTERN(boolean) read_scan_script JPP((j_compress_ptr cinfo, char * filename));
136
EXTERN(boolean) set_quant_slots JPP((j_compress_ptr cinfo, char *arg));
137
EXTERN(boolean) set_sample_factors JPP((j_compress_ptr cinfo, char *arg));
139
/* djpeg support routines (in rdcolmap.c) */
141
EXTERN(void) read_color_map JPP((j_decompress_ptr cinfo, FILE * infile));
143
/* common support routines (in cdjpeg.c) */
145
EXTERN(void) enable_signal_catcher JPP((j_common_ptr cinfo));
146
EXTERN(void) start_progress_monitor JPP((j_common_ptr cinfo,
147
cd_progress_ptr progress));
148
EXTERN(void) end_progress_monitor JPP((j_common_ptr cinfo));
149
EXTERN(boolean) keymatch JPP((char * arg, const char * keyword, int minchars));
150
EXTERN(FILE *) read_stdin JPP((void));
151
EXTERN(FILE *) write_stdout JPP((void));
153
/* miscellaneous useful macros */
155
#ifdef DONT_USE_B_MODE /* define mode parameters for fopen() */
156
#define READ_BINARY "r"
157
#define WRITE_BINARY "w"
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"
168
#ifndef EXIT_FAILURE /* define exit() codes if not provided */
169
#define EXIT_FAILURE 1
173
#define EXIT_SUCCESS 1 /* VMS is very nonstandard */
175
#define EXIT_SUCCESS 0
180
#define EXIT_WARNING 1 /* VMS is very nonstandard */
182
#define EXIT_WARNING 2