Real-time collaboration for Jupyter Notebooks, Linux Terminals, LaTeX, VS Code, R IDE, and more,
all in one place.

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

24
typedef struct cjpeg_source_struct * cjpeg_source_ptr;
25

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));
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

45
typedef struct djpeg_dest_struct * djpeg_dest_ptr;
46

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.
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

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 */
86
  int percent_done;
87
};
88

89
typedef 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

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,
121
					    boolean is_os2));
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));
130

131
/* cjpeg support routines (in rdswitch.c) */
132

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));
138

139
/* djpeg support routines (in rdcolmap.c) */
140

141
EXTERN(void) read_color_map JPP((j_decompress_ptr cinfo, FILE * infile));
142

143
/* common support routines (in cdjpeg.c) */
144

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));
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

186