]> git.jsancho.org Git - lugaru.git/blob - Dependencies/libjpeg/cdjpeg.h
finally...
[lugaru.git] / Dependencies / libjpeg / cdjpeg.h
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_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
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,
122                                             boolean is_os2));
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));
131
132 /* cjpeg support routines (in rdswitch.c) */
133
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));
141
142 /* djpeg support routines (in rdcolmap.c) */
143
144 EXTERN(void) read_color_map JPP((j_decompress_ptr cinfo, FILE * infile));
145
146 /* common support routines (in cdjpeg.c) */
147
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));
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