|
1 IJG JPEG LIBRARY: FILE LIST |
|
2 |
|
3 Copyright (C) 1994-2009, Thomas G. Lane, Guido Vollbeding. |
|
4 This file is part of the Independent JPEG Group's software. |
|
5 For conditions of distribution and use, see the accompanying README file. |
|
6 |
|
7 |
|
8 Here is a road map to the files in the IJG JPEG distribution. The |
|
9 distribution includes the JPEG library proper, plus two application |
|
10 programs ("cjpeg" and "djpeg") which use the library to convert JPEG |
|
11 files to and from some other popular image formats. A third application |
|
12 "jpegtran" uses the library to do lossless conversion between different |
|
13 variants of JPEG. There are also two stand-alone applications, |
|
14 "rdjpgcom" and "wrjpgcom". |
|
15 |
|
16 |
|
17 THE JPEG LIBRARY |
|
18 ================ |
|
19 |
|
20 Include files: |
|
21 |
|
22 jpeglib.h JPEG library's exported data and function declarations. |
|
23 jconfig.h Configuration declarations. Note: this file is not present |
|
24 in the distribution; it is generated during installation. |
|
25 jmorecfg.h Additional configuration declarations; need not be changed |
|
26 for a standard installation. |
|
27 jerror.h Declares JPEG library's error and trace message codes. |
|
28 jinclude.h Central include file used by all IJG .c files to reference |
|
29 system include files. |
|
30 jpegint.h JPEG library's internal data structures. |
|
31 jdct.h Private declarations for forward & reverse DCT subsystems. |
|
32 jmemsys.h Private declarations for memory management subsystem. |
|
33 jversion.h Version information. |
|
34 |
|
35 Applications using the library should include jpeglib.h (which in turn |
|
36 includes jconfig.h and jmorecfg.h). Optionally, jerror.h may be included |
|
37 if the application needs to reference individual JPEG error codes. The |
|
38 other include files are intended for internal use and would not normally |
|
39 be included by an application program. (cjpeg/djpeg/etc do use jinclude.h, |
|
40 since its function is to improve portability of the whole IJG distribution. |
|
41 Most other applications will directly include the system include files they |
|
42 want, and hence won't need jinclude.h.) |
|
43 |
|
44 |
|
45 C source code files: |
|
46 |
|
47 These files contain most of the functions intended to be called directly by |
|
48 an application program: |
|
49 |
|
50 jcapimin.c Application program interface: core routines for compression. |
|
51 jcapistd.c Application program interface: standard compression. |
|
52 jdapimin.c Application program interface: core routines for decompression. |
|
53 jdapistd.c Application program interface: standard decompression. |
|
54 jcomapi.c Application program interface routines common to compression |
|
55 and decompression. |
|
56 jcparam.c Compression parameter setting helper routines. |
|
57 jctrans.c API and library routines for transcoding compression. |
|
58 jdtrans.c API and library routines for transcoding decompression. |
|
59 |
|
60 Compression side of the library: |
|
61 |
|
62 jcinit.c Initialization: determines which other modules to use. |
|
63 jcmaster.c Master control: setup and inter-pass sequencing logic. |
|
64 jcmainct.c Main buffer controller (preprocessor => JPEG compressor). |
|
65 jcprepct.c Preprocessor buffer controller. |
|
66 jccoefct.c Buffer controller for DCT coefficient buffer. |
|
67 jccolor.c Color space conversion. |
|
68 jcsample.c Downsampling. |
|
69 jcdctmgr.c DCT manager (DCT implementation selection & control). |
|
70 jfdctint.c Forward DCT using slow-but-accurate integer method. |
|
71 jfdctfst.c Forward DCT using faster, less accurate integer method. |
|
72 jfdctflt.c Forward DCT using floating-point arithmetic. |
|
73 jchuff.c Huffman entropy coding. |
|
74 jcarith.c Arithmetic entropy coding. |
|
75 jcmarker.c JPEG marker writing. |
|
76 jdatadst.c Data destination managers for memory and stdio output. |
|
77 |
|
78 Decompression side of the library: |
|
79 |
|
80 jdmaster.c Master control: determines which other modules to use. |
|
81 jdinput.c Input controller: controls input processing modules. |
|
82 jdmainct.c Main buffer controller (JPEG decompressor => postprocessor). |
|
83 jdcoefct.c Buffer controller for DCT coefficient buffer. |
|
84 jdpostct.c Postprocessor buffer controller. |
|
85 jdmarker.c JPEG marker reading. |
|
86 jdhuff.c Huffman entropy decoding. |
|
87 jdarith.c Arithmetic entropy decoding. |
|
88 jddctmgr.c IDCT manager (IDCT implementation selection & control). |
|
89 jidctint.c Inverse DCT using slow-but-accurate integer method. |
|
90 jidctfst.c Inverse DCT using faster, less accurate integer method. |
|
91 jidctflt.c Inverse DCT using floating-point arithmetic. |
|
92 jdsample.c Upsampling. |
|
93 jdcolor.c Color space conversion. |
|
94 jdmerge.c Merged upsampling/color conversion (faster, lower quality). |
|
95 jquant1.c One-pass color quantization using a fixed-spacing colormap. |
|
96 jquant2.c Two-pass color quantization using a custom-generated colormap. |
|
97 Also handles one-pass quantization to an externally given map. |
|
98 jdatasrc.c Data source managers for memory and stdio input. |
|
99 |
|
100 Support files for both compression and decompression: |
|
101 |
|
102 jaricom.c Tables for common use in arithmetic entropy encoding and |
|
103 decoding routines. |
|
104 jerror.c Standard error handling routines (application replaceable). |
|
105 jmemmgr.c System-independent (more or less) memory management code. |
|
106 jutils.c Miscellaneous utility routines. |
|
107 |
|
108 jmemmgr.c relies on a system-dependent memory management module. The IJG |
|
109 distribution includes the following implementations of the system-dependent |
|
110 module: |
|
111 |
|
112 jmemnobs.c "No backing store": assumes adequate virtual memory exists. |
|
113 jmemansi.c Makes temporary files with ANSI-standard routine tmpfile(). |
|
114 jmemname.c Makes temporary files with program-generated file names. |
|
115 jmemdos.c Custom implementation for MS-DOS (16-bit environment only): |
|
116 can use extended and expanded memory as well as temp files. |
|
117 jmemmac.c Custom implementation for Apple Macintosh. |
|
118 |
|
119 Exactly one of the system-dependent modules should be configured into an |
|
120 installed JPEG library (see install.txt for hints about which one to use). |
|
121 On unusual systems you may find it worthwhile to make a special |
|
122 system-dependent memory manager. |
|
123 |
|
124 |
|
125 Non-C source code files: |
|
126 |
|
127 jmemdosa.asm 80x86 assembly code support for jmemdos.c; used only in |
|
128 MS-DOS-specific configurations of the JPEG library. |
|
129 |
|
130 |
|
131 CJPEG/DJPEG/JPEGTRAN |
|
132 ==================== |
|
133 |
|
134 Include files: |
|
135 |
|
136 cdjpeg.h Declarations shared by cjpeg/djpeg/jpegtran modules. |
|
137 cderror.h Additional error and trace message codes for cjpeg et al. |
|
138 transupp.h Declarations for jpegtran support routines in transupp.c. |
|
139 |
|
140 C source code files: |
|
141 |
|
142 cjpeg.c Main program for cjpeg. |
|
143 djpeg.c Main program for djpeg. |
|
144 jpegtran.c Main program for jpegtran. |
|
145 cdjpeg.c Utility routines used by all three programs. |
|
146 rdcolmap.c Code to read a colormap file for djpeg's "-map" switch. |
|
147 rdswitch.c Code to process some of cjpeg's more complex switches. |
|
148 Also used by jpegtran. |
|
149 transupp.c Support code for jpegtran: lossless image manipulations. |
|
150 |
|
151 Image file reader modules for cjpeg: |
|
152 |
|
153 rdbmp.c BMP file input. |
|
154 rdgif.c GIF file input (now just a stub). |
|
155 rdppm.c PPM/PGM file input. |
|
156 rdrle.c Utah RLE file input. |
|
157 rdtarga.c Targa file input. |
|
158 |
|
159 Image file writer modules for djpeg: |
|
160 |
|
161 wrbmp.c BMP file output. |
|
162 wrgif.c GIF file output (a mere shadow of its former self). |
|
163 wrppm.c PPM/PGM file output. |
|
164 wrrle.c Utah RLE file output. |
|
165 wrtarga.c Targa file output. |
|
166 |
|
167 |
|
168 RDJPGCOM/WRJPGCOM |
|
169 ================= |
|
170 |
|
171 C source code files: |
|
172 |
|
173 rdjpgcom.c Stand-alone rdjpgcom application. |
|
174 wrjpgcom.c Stand-alone wrjpgcom application. |
|
175 |
|
176 These programs do not depend on the IJG library. They do use |
|
177 jconfig.h and jinclude.h, only to improve portability. |
|
178 |
|
179 |
|
180 ADDITIONAL FILES |
|
181 ================ |
|
182 |
|
183 Documentation (see README for a guide to the documentation files): |
|
184 |
|
185 README Master documentation file. |
|
186 *.txt Other documentation files. |
|
187 *.1 Documentation in Unix man page format. |
|
188 change.log Version-to-version change highlights. |
|
189 example.c Sample code for calling JPEG library. |
|
190 |
|
191 Configuration/installation files and programs (see install.txt for more info): |
|
192 |
|
193 configure Unix shell script to perform automatic configuration. |
|
194 configure.ac Source file for use with Autoconf to generate configure. |
|
195 ltmain.sh Support scripts for configure (from GNU libtool). |
|
196 config.guess |
|
197 config.sub |
|
198 depcomp |
|
199 missing |
|
200 install-sh Install shell script for those Unix systems lacking one. |
|
201 Makefile.in Makefile input for configure. |
|
202 Makefile.am Source file for use with Automake to generate Makefile.in. |
|
203 ckconfig.c Program to generate jconfig.h on non-Unix systems. |
|
204 jconfig.txt Template for making jconfig.h by hand. |
|
205 mak*.* Sample makefiles for particular systems. |
|
206 jconfig.* Sample jconfig.h for particular systems. |
|
207 libjpeg.map Script to generate shared library with versioned symbols. |
|
208 aclocal.m4 M4 macro definitions for use with Autoconf. |
|
209 ansi2knr.c De-ANSIfier for pre-ANSI C compilers (courtesy of |
|
210 L. Peter Deutsch and Aladdin Enterprises). |
|
211 |
|
212 Test files (see install.txt for test procedure): |
|
213 |
|
214 test*.* Source and comparison files for confidence test. |
|
215 These are binary image files, NOT text files. |