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