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