216 lines
8.3 KiB
Plaintext
216 lines
8.3 KiB
Plaintext
|
IJG JPEG LIBRARY: FILE LIST
|
||
|
|
|
||
|
|
Copyright (C) 1994-2009, Thomas G. Lane, Guido Vollbeding.
|
||
|
|
This file is part of the Independent JPEG Group's software.
|
||
|
|
For conditions of distribution and use, see the accompanying README file.
|
||
|
|
|
||
|
|
|
||
|
|
Here is a road map to the files in the IJG JPEG distribution. The
|
||
|
|
distribution includes the JPEG library proper, plus two application
|
||
|
|
programs ("cjpeg" and "djpeg") which use the library to convert JPEG
|
||
|
|
files to and from some other popular image formats. A third application
|
||
|
|
"jpegtran" uses the library to do lossless conversion between different
|
||
|
|
variants of JPEG. There are also two stand-alone applications,
|
||
|
|
"rdjpgcom" and "wrjpgcom".
|
||
|
|
|
||
|
|
|
||
|
|
THE JPEG LIBRARY
|
||
|
|
================
|
||
|
|
|
||
|
|
Include files:
|
||
|
|
|
||
|
|
jpeglib.h JPEG library's exported data and function declarations.
|
||
|
|
jconfig.h Configuration declarations. Note: this file is not present
|
||
|
|
in the distribution; it is generated during installation.
|
||
|
|
jmorecfg.h Additional configuration declarations; need not be changed
|
||
|
|
for a standard installation.
|
||
|
|
jerror.h Declares JPEG library's error and trace message codes.
|
||
|
|
jinclude.h Central include file used by all IJG .c files to reference
|
||
|
|
system include files.
|
||
|
|
jpegint.h JPEG library's internal data structures.
|
||
|
|
jdct.h Private declarations for forward & reverse DCT subsystems.
|
||
|
|
jmemsys.h Private declarations for memory management subsystem.
|
||
|
|
jversion.h Version information.
|
||
|
|
|
||
|
|
Applications using the library should include jpeglib.h (which in turn
|
||
|
|
includes jconfig.h and jmorecfg.h). Optionally, jerror.h may be included
|
||
|
|
if the application needs to reference individual JPEG error codes. The
|
||
|
|
other include files are intended for internal use and would not normally
|
||
|
|
be included by an application program. (cjpeg/djpeg/etc do use jinclude.h,
|
||
|
|
since its function is to improve portability of the whole IJG distribution.
|
||
|
|
Most other applications will directly include the system include files they
|
||
|
|
want, and hence won't need jinclude.h.)
|
||
|
|
|
||
|
|
|
||
|
|
C source code files:
|
||
|
|
|
||
|
|
These files contain most of the functions intended to be called directly by
|
||
|
|
an application program:
|
||
|
|
|
||
|
|
jcapimin.c Application program interface: core routines for compression.
|
||
|
|
jcapistd.c Application program interface: standard compression.
|
||
|
|
jdapimin.c Application program interface: core routines for decompression.
|
||
|
|
jdapistd.c Application program interface: standard decompression.
|
||
|
|
jcomapi.c Application program interface routines common to compression
|
||
|
|
and decompression.
|
||
|
|
jcparam.c Compression parameter setting helper routines.
|
||
|
|
jctrans.c API and library routines for transcoding compression.
|
||
|
|
jdtrans.c API and library routines for transcoding decompression.
|
||
|
|
|
||
|
|
Compression side of the library:
|
||
|
|
|
||
|
|
jcinit.c Initialization: determines which other modules to use.
|
||
|
|
jcmaster.c Master control: setup and inter-pass sequencing logic.
|
||
|
|
jcmainct.c Main buffer controller (preprocessor => JPEG compressor).
|
||
|
|
jcprepct.c Preprocessor buffer controller.
|
||
|
|
jccoefct.c Buffer controller for DCT coefficient buffer.
|
||
|
|
jccolor.c Color space conversion.
|
||
|
|
jcsample.c Downsampling.
|
||
|
|
jcdctmgr.c DCT manager (DCT implementation selection & control).
|
||
|
|
jfdctint.c Forward DCT using slow-but-accurate integer method.
|
||
|
|
jfdctfst.c Forward DCT using faster, less accurate integer method.
|
||
|
|
jfdctflt.c Forward DCT using floating-point arithmetic.
|
||
|
|
jchuff.c Huffman entropy coding.
|
||
|
|
jcarith.c Arithmetic entropy coding.
|
||
|
|
jcmarker.c JPEG marker writing.
|
||
|
|
jdatadst.c Data destination manager for stdio output.
|
||
|
|
|
||
|
|
Decompression side of the library:
|
||
|
|
|
||
|
|
jdmaster.c Master control: determines which other modules to use.
|
||
|
|
jdinput.c Input controller: controls input processing modules.
|
||
|
|
jdmainct.c Main buffer controller (JPEG decompressor => postprocessor).
|
||
|
|
jdcoefct.c Buffer controller for DCT coefficient buffer.
|
||
|
|
jdpostct.c Postprocessor buffer controller.
|
||
|
|
jdmarker.c JPEG marker reading.
|
||
|
|
jdhuff.c Huffman entropy decoding.
|
||
|
|
jdarith.c Arithmetic entropy decoding.
|
||
|
|
jddctmgr.c IDCT manager (IDCT implementation selection & control).
|
||
|
|
jidctint.c Inverse DCT using slow-but-accurate integer method.
|
||
|
|
jidctfst.c Inverse DCT using faster, less accurate integer method.
|
||
|
|
jidctflt.c Inverse DCT using floating-point arithmetic.
|
||
|
|
jdsample.c Upsampling.
|
||
|
|
jdcolor.c Color space conversion.
|
||
|
|
jdmerge.c Merged upsampling/color conversion (faster, lower quality).
|
||
|
|
jquant1.c One-pass color quantization using a fixed-spacing colormap.
|
||
|
|
jquant2.c Two-pass color quantization using a custom-generated colormap.
|
||
|
|
Also handles one-pass quantization to an externally given map.
|
||
|
|
jdatasrc.c Data source manager for stdio input.
|
||
|
|
|
||
|
|
Support files for both compression and decompression:
|
||
|
|
|
||
|
|
jaricom.c Tables for common use in arithmetic entropy encoding and
|
||
|
|
decoding routines.
|
||
|
|
jerror.c Standard error handling routines (application replaceable).
|
||
|
|
jmemmgr.c System-independent (more or less) memory management code.
|
||
|
|
jutils.c Miscellaneous utility routines.
|
||
|
|
|
||
|
|
jmemmgr.c relies on a system-dependent memory management module. The IJG
|
||
|
|
distribution includes the following implementations of the system-dependent
|
||
|
|
module:
|
||
|
|
|
||
|
|
jmemnobs.c "No backing store": assumes adequate virtual memory exists.
|
||
|
|
jmemansi.c Makes temporary files with ANSI-standard routine tmpfile().
|
||
|
|
jmemname.c Makes temporary files with program-generated file names.
|
||
|
|
jmemdos.c Custom implementation for MS-DOS (16-bit environment only):
|
||
|
|
can use extended and expanded memory as well as temp files.
|
||
|
|
jmemmac.c Custom implementation for Apple Macintosh.
|
||
|
|
|
||
|
|
Exactly one of the system-dependent modules should be configured into an
|
||
|
|
installed JPEG library (see install.txt for hints about which one to use).
|
||
|
|
On unusual systems you may find it worthwhile to make a special
|
||
|
|
system-dependent memory manager.
|
||
|
|
|
||
|
|
|
||
|
|
Non-C source code files:
|
||
|
|
|
||
|
|
jmemdosa.asm 80x86 assembly code support for jmemdos.c; used only in
|
||
|
|
MS-DOS-specific configurations of the JPEG library.
|
||
|
|
|
||
|
|
|
||
|
|
CJPEG/DJPEG/JPEGTRAN
|
||
|
|
====================
|
||
|
|
|
||
|
|
Include files:
|
||
|
|
|
||
|
|
cdjpeg.h Declarations shared by cjpeg/djpeg/jpegtran modules.
|
||
|
|
cderror.h Additional error and trace message codes for cjpeg et al.
|
||
|
|
transupp.h Declarations for jpegtran support routines in transupp.c.
|
||
|
|
|
||
|
|
C source code files:
|
||
|
|
|
||
|
|
cjpeg.c Main program for cjpeg.
|
||
|
|
djpeg.c Main program for djpeg.
|
||
|
|
jpegtran.c Main program for jpegtran.
|
||
|
|
cdjpeg.c Utility routines used by all three programs.
|
||
|
|
rdcolmap.c Code to read a colormap file for djpeg's "-map" switch.
|
||
|
|
rdswitch.c Code to process some of cjpeg's more complex switches.
|
||
|
|
Also used by jpegtran.
|
||
|
|
transupp.c Support code for jpegtran: lossless image manipulations.
|
||
|
|
|
||
|
|
Image file reader modules for cjpeg:
|
||
|
|
|
||
|
|
rdbmp.c BMP file input.
|
||
|
|
rdgif.c GIF file input (now just a stub).
|
||
|
|
rdppm.c PPM/PGM file input.
|
||
|
|
rdrle.c Utah RLE file input.
|
||
|
|
rdtarga.c Targa file input.
|
||
|
|
|
||
|
|
Image file writer modules for djpeg:
|
||
|
|
|
||
|
|
wrbmp.c BMP file output.
|
||
|
|
wrgif.c GIF file output (a mere shadow of its former self).
|
||
|
|
wrppm.c PPM/PGM file output.
|
||
|
|
wrrle.c Utah RLE file output.
|
||
|
|
wrtarga.c Targa file output.
|
||
|
|
|
||
|
|
|
||
|
|
RDJPGCOM/WRJPGCOM
|
||
|
|
=================
|
||
|
|
|
||
|
|
C source code files:
|
||
|
|
|
||
|
|
rdjpgcom.c Stand-alone rdjpgcom application.
|
||
|
|
wrjpgcom.c Stand-alone wrjpgcom application.
|
||
|
|
|
||
|
|
These programs do not depend on the IJG library. They do use
|
||
|
|
jconfig.h and jinclude.h, only to improve portability.
|
||
|
|
|
||
|
|
|
||
|
|
ADDITIONAL FILES
|
||
|
|
================
|
||
|
|
|
||
|
|
Documentation (see README for a guide to the documentation files):
|
||
|
|
|
||
|
|
README Master documentation file.
|
||
|
|
*.txt Other documentation files.
|
||
|
|
*.1 Documentation in Unix man page format.
|
||
|
|
change.log Version-to-version change highlights.
|
||
|
|
example.c Sample code for calling JPEG library.
|
||
|
|
|
||
|
|
Configuration/installation files and programs (see install.txt for more info):
|
||
|
|
|
||
|
|
configure Unix shell script to perform automatic configuration.
|
||
|
|
configure.ac Source file for use with Autoconf to generate configure.
|
||
|
|
ltmain.sh Support scripts for configure (from GNU libtool).
|
||
|
|
config.guess
|
||
|
|
config.sub
|
||
|
|
depcomp
|
||
|
|
missing
|
||
|
|
install-sh Install shell script for those Unix systems lacking one.
|
||
|
|
Makefile.in Makefile input for configure.
|
||
|
|
Makefile.am Source file for use with Automake to generate Makefile.in.
|
||
|
|
ckconfig.c Program to generate jconfig.h on non-Unix systems.
|
||
|
|
jconfig.txt Template for making jconfig.h by hand.
|
||
|
|
mak*.* Sample makefiles for particular systems.
|
||
|
|
jconfig.* Sample jconfig.h for particular systems.
|
||
|
|
libjpeg.map Script to generate shared library with versioned symbols.
|
||
|
|
aclocal.m4 M4 macro definitions for use with Autoconf.
|
||
|
|
ansi2knr.c De-ANSIfier for pre-ANSI C compilers (courtesy of
|
||
|
|
L. Peter Deutsch and Aladdin Enterprises).
|
||
|
|
|
||
|
|
Test files (see install.txt for test procedure):
|
||
|
|
|
||
|
|
test*.* Source and comparison files for confidence test.
|
||
|
|
These are binary image files, NOT text files.
|