jpeg/filelist.doc

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