| OLD | NEW | 
| (Empty) |  | 
 |    1 libjpeg-turbo note:  This is the legacy document from the original libjpeg v6b | 
 |    2 release, which is included for reference.  The Internet addresses given below | 
 |    3 are likely non-functional.  For more information about the libjpeg project, | 
 |    4 please see http://www.ijg.org.  For more information about libjpeg-turbo, | 
 |    5 please see http://libjpeg-turbo.virtualgl.org. | 
 |    6  | 
 |    7  | 
 |    8 The Independent JPEG Group's JPEG software | 
 |    9 ========================================== | 
 |   10  | 
 |   11 README for release 6b of 27-Mar-1998 | 
 |   12 ==================================== | 
 |   13  | 
 |   14 This distribution contains the sixth public release of the Independent JPEG | 
 |   15 Group's free JPEG software.  You are welcome to redistribute this software and | 
 |   16 to use it for any purpose, subject to the conditions under LEGAL ISSUES, below. | 
 |   17  | 
 |   18 Serious users of this software (particularly those incorporating it into | 
 |   19 larger programs) should contact IJG at jpeg-info@uunet.uu.net to be added to | 
 |   20 our electronic mailing list.  Mailing list members are notified of updates | 
 |   21 and have a chance to participate in technical discussions, etc. | 
 |   22  | 
 |   23 This software is the work of Tom Lane, Philip Gladstone, Jim Boucher, | 
 |   24 Lee Crocker, Julian Minguillon, Luis Ortiz, George Phillips, Davide Rossi, | 
 |   25 Guido Vollbeding, Ge' Weijers, and other members of the Independent JPEG | 
 |   26 Group. | 
 |   27  | 
 |   28 IJG is not affiliated with the official ISO JPEG standards committee. | 
 |   29  | 
 |   30  | 
 |   31 DOCUMENTATION ROADMAP | 
 |   32 ===================== | 
 |   33  | 
 |   34 This file contains the following sections: | 
 |   35  | 
 |   36 OVERVIEW            General description of JPEG and the IJG software. | 
 |   37 LEGAL ISSUES        Copyright, lack of warranty, terms of distribution. | 
 |   38 REFERENCES          Where to learn more about JPEG. | 
 |   39 ARCHIVE LOCATIONS   Where to find newer versions of this software. | 
 |   40 RELATED SOFTWARE    Other stuff you should get. | 
 |   41 FILE FORMAT WARS    Software *not* to get. | 
 |   42 TO DO               Plans for future IJG releases. | 
 |   43  | 
 |   44 Other documentation files in the distribution are: | 
 |   45  | 
 |   46 User documentation: | 
 |   47   install.doc       How to configure and install the IJG software. | 
 |   48   usage.doc         Usage instructions for cjpeg, djpeg, jpegtran, | 
 |   49                     rdjpgcom, and wrjpgcom. | 
 |   50   *.1               Unix-style man pages for programs (same info as usage.doc). | 
 |   51   wizard.doc        Advanced usage instructions for JPEG wizards only. | 
 |   52   change.log        Version-to-version change highlights. | 
 |   53 Programmer and internal documentation: | 
 |   54   libjpeg.doc       How to use the JPEG library in your own programs. | 
 |   55   example.c         Sample code for calling the JPEG library. | 
 |   56   structure.doc     Overview of the JPEG library's internal structure. | 
 |   57   filelist.doc      Road map of IJG files. | 
 |   58   coderules.doc     Coding style rules --- please read if you contribute code. | 
 |   59  | 
 |   60 Please read at least the files install.doc and usage.doc.  Useful information | 
 |   61 can also be found in the JPEG FAQ (Frequently Asked Questions) article.  See | 
 |   62 ARCHIVE LOCATIONS below to find out where to obtain the FAQ article. | 
 |   63  | 
 |   64 If you want to understand how the JPEG code works, we suggest reading one or | 
 |   65 more of the REFERENCES, then looking at the documentation files (in roughly | 
 |   66 the order listed) before diving into the code. | 
 |   67  | 
 |   68  | 
 |   69 OVERVIEW | 
 |   70 ======== | 
 |   71  | 
 |   72 This package contains C software to implement JPEG image compression and | 
 |   73 decompression.  JPEG (pronounced "jay-peg") is a standardized compression | 
 |   74 method for full-color and gray-scale images.  JPEG is intended for compressing | 
 |   75 "real-world" scenes; line drawings, cartoons and other non-realistic images | 
 |   76 are not its strong suit.  JPEG is lossy, meaning that the output image is not | 
 |   77 exactly identical to the input image.  Hence you must not use JPEG if you | 
 |   78 have to have identical output bits.  However, on typical photographic images, | 
 |   79 very good compression levels can be obtained with no visible change, and | 
 |   80 remarkably high compression levels are possible if you can tolerate a | 
 |   81 low-quality image.  For more details, see the references, or just experiment | 
 |   82 with various compression settings. | 
 |   83  | 
 |   84 This software implements JPEG baseline, extended-sequential, and progressive | 
 |   85 compression processes.  Provision is made for supporting all variants of these | 
 |   86 processes, although some uncommon parameter settings aren't implemented yet. | 
 |   87 For legal reasons, we are not distributing code for the arithmetic-coding | 
 |   88 variants of JPEG; see LEGAL ISSUES.  We have made no provision for supporting | 
 |   89 the hierarchical or lossless processes defined in the standard. | 
 |   90  | 
 |   91 We provide a set of library routines for reading and writing JPEG image files, | 
 |   92 plus two sample applications "cjpeg" and "djpeg", which use the library to | 
 |   93 perform conversion between JPEG and some other popular image file formats. | 
 |   94 The library is intended to be reused in other applications. | 
 |   95  | 
 |   96 In order to support file conversion and viewing software, we have included | 
 |   97 considerable functionality beyond the bare JPEG coding/decoding capability; | 
 |   98 for example, the color quantization modules are not strictly part of JPEG | 
 |   99 decoding, but they are essential for output to colormapped file formats or | 
 |  100 colormapped displays.  These extra functions can be compiled out of the | 
 |  101 library if not required for a particular application.  We have also included | 
 |  102 "jpegtran", a utility for lossless transcoding between different JPEG | 
 |  103 processes, and "rdjpgcom" and "wrjpgcom", two simple applications for | 
 |  104 inserting and extracting textual comments in JFIF files. | 
 |  105  | 
 |  106 The emphasis in designing this software has been on achieving portability and | 
 |  107 flexibility, while also making it fast enough to be useful.  In particular, | 
 |  108 the software is not intended to be read as a tutorial on JPEG.  (See the | 
 |  109 REFERENCES section for introductory material.)  Rather, it is intended to | 
 |  110 be reliable, portable, industrial-strength code.  We do not claim to have | 
 |  111 achieved that goal in every aspect of the software, but we strive for it. | 
 |  112  | 
 |  113 We welcome the use of this software as a component of commercial products. | 
 |  114 No royalty is required, but we do ask for an acknowledgement in product | 
 |  115 documentation, as described under LEGAL ISSUES. | 
 |  116  | 
 |  117  | 
 |  118 LEGAL ISSUES | 
 |  119 ============ | 
 |  120  | 
 |  121 In plain English: | 
 |  122  | 
 |  123 1. We don't promise that this software works.  (But if you find any bugs, | 
 |  124    please let us know!) | 
 |  125 2. You can use this software for whatever you want.  You don't have to pay us. | 
 |  126 3. You may not pretend that you wrote this software.  If you use it in a | 
 |  127    program, you must acknowledge somewhere in your documentation that | 
 |  128    you've used the IJG code. | 
 |  129  | 
 |  130 In legalese: | 
 |  131  | 
 |  132 The authors make NO WARRANTY or representation, either express or implied, | 
 |  133 with respect to this software, its quality, accuracy, merchantability, or | 
 |  134 fitness for a particular purpose.  This software is provided "AS IS", and you, | 
 |  135 its user, assume the entire risk as to its quality and accuracy. | 
 |  136  | 
 |  137 This software is copyright (C) 1991-1998, Thomas G. Lane. | 
 |  138 All Rights Reserved except as specified below. | 
 |  139  | 
 |  140 Permission is hereby granted to use, copy, modify, and distribute this | 
 |  141 software (or portions thereof) for any purpose, without fee, subject to these | 
 |  142 conditions: | 
 |  143 (1) If any part of the source code for this software is distributed, then this | 
 |  144 README file must be included, with this copyright and no-warranty notice | 
 |  145 unaltered; and any additions, deletions, or changes to the original files | 
 |  146 must be clearly indicated in accompanying documentation. | 
 |  147 (2) If only executable code is distributed, then the accompanying | 
 |  148 documentation must state that "this software is based in part on the work of | 
 |  149 the Independent JPEG Group". | 
 |  150 (3) Permission for use of this software is granted only if the user accepts | 
 |  151 full responsibility for any undesirable consequences; the authors accept | 
 |  152 NO LIABILITY for damages of any kind. | 
 |  153  | 
 |  154 These conditions apply to any software derived from or based on the IJG code, | 
 |  155 not just to the unmodified library.  If you use our work, you ought to | 
 |  156 acknowledge us. | 
 |  157  | 
 |  158 Permission is NOT granted for the use of any IJG author's name or company name | 
 |  159 in advertising or publicity relating to this software or products derived from | 
 |  160 it.  This software may be referred to only as "the Independent JPEG Group's | 
 |  161 software". | 
 |  162  | 
 |  163 We specifically permit and encourage the use of this software as the basis of | 
 |  164 commercial products, provided that all warranty or liability claims are | 
 |  165 assumed by the product vendor. | 
 |  166  | 
 |  167  | 
 |  168 ansi2knr.c is included in this distribution by permission of L. Peter Deutsch, | 
 |  169 sole proprietor of its copyright holder, Aladdin Enterprises of Menlo Park, CA. | 
 |  170 ansi2knr.c is NOT covered by the above copyright and conditions, but instead | 
 |  171 by the usual distribution terms of the Free Software Foundation; principally, | 
 |  172 that you must include source code if you redistribute it.  (See the file | 
 |  173 ansi2knr.c for full details.)  However, since ansi2knr.c is not needed as part | 
 |  174 of any program generated from the IJG code, this does not limit you more than | 
 |  175 the foregoing paragraphs do. | 
 |  176  | 
 |  177 The Unix configuration script "configure" was produced with GNU Autoconf. | 
 |  178 It is copyright by the Free Software Foundation but is freely distributable. | 
 |  179 The same holds for its supporting scripts (config.guess, config.sub, | 
 |  180 ltconfig, ltmain.sh).  Another support script, install-sh, is copyright | 
 |  181 by M.I.T. but is also freely distributable. | 
 |  182  | 
 |  183 It appears that the arithmetic coding option of the JPEG spec is covered by | 
 |  184 patents owned by IBM, AT&T, and Mitsubishi.  Hence arithmetic coding cannot | 
 |  185 legally be used without obtaining one or more licenses.  For this reason, | 
 |  186 support for arithmetic coding has been removed from the free JPEG software. | 
 |  187 (Since arithmetic coding provides only a marginal gain over the unpatented | 
 |  188 Huffman mode, it is unlikely that very many implementations will support it.) | 
 |  189 So far as we are aware, there are no patent restrictions on the remaining | 
 |  190 code. | 
 |  191  | 
 |  192 The IJG distribution formerly included code to read and write GIF files. | 
 |  193 To avoid entanglement with the Unisys LZW patent, GIF reading support has | 
 |  194 been removed altogether, and the GIF writer has been simplified to produce | 
 |  195 "uncompressed GIFs".  This technique does not use the LZW algorithm; the | 
 |  196 resulting GIF files are larger than usual, but are readable by all standard | 
 |  197 GIF decoders. | 
 |  198  | 
 |  199 We are required to state that | 
 |  200     "The Graphics Interchange Format(c) is the Copyright property of | 
 |  201     CompuServe Incorporated.  GIF(sm) is a Service Mark property of | 
 |  202     CompuServe Incorporated." | 
 |  203  | 
 |  204  | 
 |  205 REFERENCES | 
 |  206 ========== | 
 |  207  | 
 |  208 We highly recommend reading one or more of these references before trying to | 
 |  209 understand the innards of the JPEG software. | 
 |  210  | 
 |  211 The best short technical introduction to the JPEG compression algorithm is | 
 |  212         Wallace, Gregory K.  "The JPEG Still Picture Compression Standard", | 
 |  213         Communications of the ACM, April 1991 (vol. 34 no. 4), pp. 30-44. | 
 |  214 (Adjacent articles in that issue discuss MPEG motion picture compression, | 
 |  215 applications of JPEG, and related topics.)  If you don't have the CACM issue | 
 |  216 handy, a PostScript file containing a revised version of Wallace's article is | 
 |  217 available at ftp://ftp.uu.net/graphics/jpeg/wallace.ps.gz.  The file (actually | 
 |  218 a preprint for an article that appeared in IEEE Trans. Consumer Electronics) | 
 |  219 omits the sample images that appeared in CACM, but it includes corrections | 
 |  220 and some added material.  Note: the Wallace article is copyright ACM and IEEE, | 
 |  221 and it may not be used for commercial purposes. | 
 |  222  | 
 |  223 A somewhat less technical, more leisurely introduction to JPEG can be found in | 
 |  224 "The Data Compression Book" by Mark Nelson and Jean-loup Gailly, published by | 
 |  225 M&T Books (New York), 2nd ed. 1996, ISBN 1-55851-434-1.  This book provides | 
 |  226 good explanations and example C code for a multitude of compression methods | 
 |  227 including JPEG.  It is an excellent source if you are comfortable reading C | 
 |  228 code but don't know much about data compression in general.  The book's JPEG | 
 |  229 sample code is far from industrial-strength, but when you are ready to look | 
 |  230 at a full implementation, you've got one here... | 
 |  231  | 
 |  232 The best full description of JPEG is the textbook "JPEG Still Image Data | 
 |  233 Compression Standard" by William B. Pennebaker and Joan L. Mitchell, published | 
 |  234 by Van Nostrand Reinhold, 1993, ISBN 0-442-01272-1.  Price US$59.95, 638 pp. | 
 |  235 The book includes the complete text of the ISO JPEG standards (DIS 10918-1 | 
 |  236 and draft DIS 10918-2).  This is by far the most complete exposition of JPEG | 
 |  237 in existence, and we highly recommend it. | 
 |  238  | 
 |  239 The JPEG standard itself is not available electronically; you must order a | 
 |  240 paper copy through ISO or ITU.  (Unless you feel a need to own a certified | 
 |  241 official copy, we recommend buying the Pennebaker and Mitchell book instead; | 
 |  242 it's much cheaper and includes a great deal of useful explanatory material.) | 
 |  243 In the USA, copies of the standard may be ordered from ANSI Sales at (212) | 
 |  244 642-4900, or from Global Engineering Documents at (800) 854-7179.  (ANSI | 
 |  245 doesn't take credit card orders, but Global does.)  It's not cheap: as of | 
 |  246 1992, ANSI was charging $95 for Part 1 and $47 for Part 2, plus 7% | 
 |  247 shipping/handling.  The standard is divided into two parts, Part 1 being the | 
 |  248 actual specification, while Part 2 covers compliance testing methods.  Part 1 | 
 |  249 is titled "Digital Compression and Coding of Continuous-tone Still Images, | 
 |  250 Part 1: Requirements and guidelines" and has document numbers ISO/IEC IS | 
 |  251 10918-1, ITU-T T.81.  Part 2 is titled "Digital Compression and Coding of | 
 |  252 Continuous-tone Still Images, Part 2: Compliance testing" and has document | 
 |  253 numbers ISO/IEC IS 10918-2, ITU-T T.83. | 
 |  254  | 
 |  255 Some extensions to the original JPEG standard are defined in JPEG Part 3, | 
 |  256 a newer ISO standard numbered ISO/IEC IS 10918-3 and ITU-T T.84.  IJG | 
 |  257 currently does not support any Part 3 extensions. | 
 |  258  | 
 |  259 The JPEG standard does not specify all details of an interchangeable file | 
 |  260 format.  For the omitted details we follow the "JFIF" conventions, revision | 
 |  261 1.02.  A copy of the JFIF spec is available from: | 
 |  262         Literature Department | 
 |  263         C-Cube Microsystems, Inc. | 
 |  264         1778 McCarthy Blvd. | 
 |  265         Milpitas, CA 95035 | 
 |  266         phone (408) 944-6300,  fax (408) 944-6314 | 
 |  267 A PostScript version of this document is available by FTP at | 
 |  268 ftp://ftp.uu.net/graphics/jpeg/jfif.ps.gz.  There is also a plain text | 
 |  269 version at ftp://ftp.uu.net/graphics/jpeg/jfif.txt.gz, but it is missing | 
 |  270 the figures. | 
 |  271  | 
 |  272 The TIFF 6.0 file format specification can be obtained by FTP from | 
 |  273 ftp://ftp.sgi.com/graphics/tiff/TIFF6.ps.gz.  The JPEG incorporation scheme | 
 |  274 found in the TIFF 6.0 spec of 3-June-92 has a number of serious problems. | 
 |  275 IJG does not recommend use of the TIFF 6.0 design (TIFF Compression tag 6). | 
 |  276 Instead, we recommend the JPEG design proposed by TIFF Technical Note #2 | 
 |  277 (Compression tag 7).  Copies of this Note can be obtained from ftp.sgi.com or | 
 |  278 from ftp://ftp.uu.net/graphics/jpeg/.  It is expected that the next revision | 
 |  279 of the TIFF spec will replace the 6.0 JPEG design with the Note's design. | 
 |  280 Although IJG's own code does not support TIFF/JPEG, the free libtiff library | 
 |  281 uses our library to implement TIFF/JPEG per the Note.  libtiff is available | 
 |  282 from ftp://ftp.sgi.com/graphics/tiff/. | 
 |  283  | 
 |  284  | 
 |  285 ARCHIVE LOCATIONS | 
 |  286 ================= | 
 |  287  | 
 |  288 The "official" archive site for this software is ftp.uu.net (Internet | 
 |  289 address 192.48.96.9).  The most recent released version can always be found | 
 |  290 there in directory graphics/jpeg.  This particular version will be archived | 
 |  291 as ftp://ftp.uu.net/graphics/jpeg/jpegsrc.v6b.tar.gz.  If you don't have | 
 |  292 direct Internet access, UUNET's archives are also available via UUCP; contact | 
 |  293 help@uunet.uu.net for information on retrieving files that way. | 
 |  294  | 
 |  295 Numerous Internet sites maintain copies of the UUNET files.  However, only | 
 |  296 ftp.uu.net is guaranteed to have the latest official version. | 
 |  297  | 
 |  298 You can also obtain this software in DOS-compatible "zip" archive format from | 
 |  299 the SimTel archives (ftp://ftp.simtel.net/pub/simtelnet/msdos/graphics/), or | 
 |  300 on CompuServe in the Graphics Support forum (GO CIS:GRAPHSUP), library 12 | 
 |  301 "JPEG Tools".  Again, these versions may sometimes lag behind the ftp.uu.net | 
 |  302 release. | 
 |  303  | 
 |  304 The JPEG FAQ (Frequently Asked Questions) article is a useful source of | 
 |  305 general information about JPEG.  It is updated constantly and therefore is | 
 |  306 not included in this distribution.  The FAQ is posted every two weeks to | 
 |  307 Usenet newsgroups comp.graphics.misc, news.answers, and other groups. | 
 |  308 It is available on the World Wide Web at http://www.faqs.org/faqs/jpeg-faq/ | 
 |  309 and other news.answers archive sites, including the official news.answers | 
 |  310 archive at rtfm.mit.edu: ftp://rtfm.mit.edu/pub/usenet/news.answers/jpeg-faq/. | 
 |  311 If you don't have Web or FTP access, send e-mail to mail-server@rtfm.mit.edu | 
 |  312 with body | 
 |  313         send usenet/news.answers/jpeg-faq/part1 | 
 |  314         send usenet/news.answers/jpeg-faq/part2 | 
 |  315  | 
 |  316  | 
 |  317 RELATED SOFTWARE | 
 |  318 ================ | 
 |  319  | 
 |  320 Numerous viewing and image manipulation programs now support JPEG.  (Quite a | 
 |  321 few of them use this library to do so.)  The JPEG FAQ described above lists | 
 |  322 some of the more popular free and shareware viewers, and tells where to | 
 |  323 obtain them on Internet. | 
 |  324  | 
 |  325 If you are on a Unix machine, we highly recommend Jef Poskanzer's free | 
 |  326 PBMPLUS software, which provides many useful operations on PPM-format image | 
 |  327 files.  In particular, it can convert PPM images to and from a wide range of | 
 |  328 other formats, thus making cjpeg/djpeg considerably more useful.  The latest | 
 |  329 version is distributed by the NetPBM group, and is available from numerous | 
 |  330 sites, notably ftp://wuarchive.wustl.edu/graphics/graphics/packages/NetPBM/. | 
 |  331 Unfortunately PBMPLUS/NETPBM is not nearly as portable as the IJG software is; | 
 |  332 you are likely to have difficulty making it work on any non-Unix machine. | 
 |  333  | 
 |  334 A different free JPEG implementation, written by the PVRG group at Stanford, | 
 |  335 is available from ftp://havefun.stanford.edu/pub/jpeg/.  This program | 
 |  336 is designed for research and experimentation rather than production use; | 
 |  337 it is slower, harder to use, and less portable than the IJG code, but it | 
 |  338 is easier to read and modify.  Also, the PVRG code supports lossless JPEG, | 
 |  339 which we do not.  (On the other hand, it doesn't do progressive JPEG.) | 
 |  340  | 
 |  341  | 
 |  342 FILE FORMAT WARS | 
 |  343 ================ | 
 |  344  | 
 |  345 Some JPEG programs produce files that are not compatible with our library. | 
 |  346 The root of the problem is that the ISO JPEG committee failed to specify a | 
 |  347 concrete file format.  Some vendors "filled in the blanks" on their own, | 
 |  348 creating proprietary formats that no one else could read.  (For example, none | 
 |  349 of the early commercial JPEG implementations for the Macintosh were able to | 
 |  350 exchange compressed files.) | 
 |  351  | 
 |  352 The file format we have adopted is called JFIF (see REFERENCES).  This format | 
 |  353 has been agreed to by a number of major commercial JPEG vendors, and it has | 
 |  354 become the de facto standard.  JFIF is a minimal or "low end" representation. | 
 |  355 We recommend the use of TIFF/JPEG (TIFF revision 6.0 as modified by TIFF | 
 |  356 Technical Note #2) for "high end" applications that need to record a lot of | 
 |  357 additional data about an image.  TIFF/JPEG is fairly new and not yet widely | 
 |  358 supported, unfortunately. | 
 |  359  | 
 |  360 The upcoming JPEG Part 3 standard defines a file format called SPIFF. | 
 |  361 SPIFF is interoperable with JFIF, in the sense that most JFIF decoders should | 
 |  362 be able to read the most common variant of SPIFF.  SPIFF has some technical | 
 |  363 advantages over JFIF, but its major claim to fame is simply that it is an | 
 |  364 official standard rather than an informal one.  At this point it is unclear | 
 |  365 whether SPIFF will supersede JFIF or whether JFIF will remain the de-facto | 
 |  366 standard.  IJG intends to support SPIFF once the standard is frozen, but we | 
 |  367 have not decided whether it should become our default output format or not. | 
 |  368 (In any case, our decoder will remain capable of reading JFIF indefinitely.) | 
 |  369  | 
 |  370 Various proprietary file formats incorporating JPEG compression also exist. | 
 |  371 We have little or no sympathy for the existence of these formats.  Indeed, | 
 |  372 one of the original reasons for developing this free software was to help | 
 |  373 force convergence on common, open format standards for JPEG files.  Don't | 
 |  374 use a proprietary file format! | 
 |  375  | 
 |  376  | 
 |  377 TO DO | 
 |  378 ===== | 
 |  379  | 
 |  380 The major thrust for v7 will probably be improvement of visual quality. | 
 |  381 The current method for scaling the quantization tables is known not to be | 
 |  382 very good at low Q values.  We also intend to investigate block boundary | 
 |  383 smoothing, "poor man's variable quantization", and other means of improving | 
 |  384 quality-vs-file-size performance without sacrificing compatibility. | 
 |  385  | 
 |  386 In future versions, we are considering supporting some of the upcoming JPEG | 
 |  387 Part 3 extensions --- principally, variable quantization and the SPIFF file | 
 |  388 format. | 
 |  389  | 
 |  390 As always, speeding things up is of great interest. | 
 |  391  | 
 |  392 Please send bug reports, offers of help, etc. to jpeg-info@uunet.uu.net. | 
| OLD | NEW |