src/3rdparty/libjpeg/cdjpeg.h
changeset 30 5dc02b23752f
equal deleted inserted replaced
29:b72c6db6890b 30:5dc02b23752f
       
     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