3rdparty/libjpeg/change.log

CHANGE LOG for Independent JPEG Group's JPEG software


Version 7  27-Jun-2009
----------------------

New scaled DCTs implemented.
djpeg now supports scalings N/8 with all N from 1 to 16.
cjpeg now supports scalings 8/N with all N from 1 to 16.
Scaled DCTs with size larger than 8 are now also used for resolving the
common 2x2 chroma subsampling case without additional spatial resampling.
Separate spatial resampling for those kind of files is now only necessary
for N>8 scaling cases.
Furthermore, separate scaled DCT functions are provided for direct resolving
of the common asymmetric subsampling cases (2x1 and 1x2) without additional
spatial resampling.

cjpeg -quality option has been extended for support of separate quality
settings for luminance and chrominance (or in general, for every provided
quantization table slot).
New API function jpeg_default_qtables() and q_scale_factor array in library.

Added -nosmooth option to cjpeg, complementary to djpeg.
New variable "do_fancy_downsampling" in library, complement to fancy
upsampling.  Fancy upsampling now uses direct DCT scaling with sizes
larger than 8.  The old method is not reversible and has been removed.

Support arithmetic entropy encoding and decoding.
Added files jaricom.c, jcarith.c, jdarith.c.

Straighten the file structure:
Removed files jidctred.c, jcphuff.c, jchuff.h, jdphuff.c, jdhuff.h.

jpegtran has a new "lossless" cropping feature.

Implement -perfect option in jpegtran, new API function
jtransform_perfect_transform() in transupp. (DP 204_perfect.dpatch)

Better error messages for jpegtran fopen failure.
(DP 203_jpegtran_errmsg.dpatch)

Fix byte order issue with 16bit PPM/PGM files in rdppm.c/wrppm.c:
according to Netpbm, the de facto standard implementation of the PNM formats,
the most significant byte is first. (DP 203_rdppm.dpatch)

Add -raw option to rdjpgcom not to mangle the output.
(DP 205_rdjpgcom_raw.dpatch)

Make rdjpgcom locale aware. (DP 201_rdjpgcom_locale.dpatch)

Add extern "C" to jpeglib.h.
This avoids the need to put extern "C" { ... } around #include "jpeglib.h"
in your C++ application.  Defining the symbol DONT_USE_EXTERN_C in the
configuration prevents this. (DP 202_jpeglib.h_c++.dpatch)


Version 6b  27-Mar-1998
-----------------------

jpegtran has new features for lossless image transformations (rotation
and flipping) as well as "lossless" reduction to grayscale.

jpegtran now copies comments by default; it has a -copy switch to enable
copying all APPn blocks as well, or to suppress comments.  (Formerly it
always suppressed comments and APPn blocks.)  jpegtran now also preserves
JFIF version and resolution information.

New decompressor library feature: COM and APPn markers found in the input
file can be saved in memory for later use by the application.  (Before,
you had to code this up yourself with a custom marker processor.)

There is an unused field "void * client_data" now in compress and decompress
parameter structs; this may be useful in some applications.

JFIF version number information is now saved by the decoder and accepted by
the encoder.  jpegtran uses this to copy the source file's version number,
to ensure "jpegtran -copy all" won't create bogus files that contain JFXX
extensions but claim to be version 1.01.  Applications that generate their
own JFXX extension markers also (finally) have a supported way to cause the
encoder to emit JFIF version number 1.02.

djpeg's trace mode reports JFIF 1.02 thumbnail images as such, rather
than as unknown APP0 markers.

In -verbose mode, djpeg and rdjpgcom will try to print the contents of
APP12 markers as text.  Some digital cameras store useful text information
in APP12 markers.

Handling of truncated data streams is more robust: blocks beyond the one in
which the error occurs will be output as uniform gray, or left unchanged
if decoding a progressive JPEG.  The appearance no longer depends on the
Huffman tables being used.

Huffman tables are checked for validity much more carefully than before.

To avoid the Unisys LZW patent, djpeg's GIF output capability has been
changed to produce "uncompressed GIFs", and cjpeg's GIF input capability
has been removed altogether.  We're not happy about it either, but there
seems to be no good alternative.

The configure script now supports building libjpeg as a shared library
on many flavors of Unix (all the ones that GNU libtool knows how to
build shared libraries for).  Use "./configure --enable-shared" to
try this out.

New jconfig file and makefiles for Microsoft Visual C++ and Developer Studio.
Also, a jconfig file and a build script for Metrowerks CodeWarrior
on Apple Macintosh.  makefile.dj has been updated for DJGPP v2, and there
are miscellaneous other minor improvements in the makefiles.

jmemmac.c now knows how to create temporary files following Mac System 7
conventions.

djpeg's -map switch is now able to read raw-format PPM files reliably.

cjpeg -progressive -restart no longer generates any unnecessary DRI markers.

Multiple calls to jpeg_simple_progression for a single JPEG object
no longer leak memory.


Version 6a  7-Feb-96
--------------------

Library initialization sequence modified to detect version mismatches
and struct field packing mismatches between library and calling application.
This change requires applications to be recompiled, but does not require
any application source code change.

All routine declarations changed to the style "GLOBAL(type) name ...",
that is, GLOBAL, LOCAL, METHODDEF, EXTERN are now macros taking the
routine's return type as an argument.  This makes it possible to add
Microsoft-style linkage keywords to all the routines by changing just
these macros.  Note that any application code that was using these macros
will have to be changed.

DCT coefficient quantization tables are now stored in normal array order
rather than zigzag order.  Application code that calls jpeg_add_quant_table,
or otherwise manipulates quantization tables directly, will need to be
changed.  If you need to make such code work with either older or newer
versions of the library, a test like "#if JPEG_LIB_VERSION >= 61" is
recommended.

djpeg's trace capability now dumps DQT tables in natural order, not zigzag
order.  This allows the trace output to be made into a "-qtables" file
more easily.

New system-dependent memory manager module for use on Apple Macintosh.

Fix bug in cjpeg's -smooth option: last one or two scanlines would be
duplicates of the prior line unless the image height mod 16 was 1 or 2.

Repair minor problems in VMS, BCC, MC6 makefiles.

New configure script based on latest GNU Autoconf.

Correct the list of include files needed by MetroWerks C for ccommand().

Numerous small documentation updates.


Version 6  2-Aug-95
-------------------

Progressive JPEG support: library can read and write full progressive JPEG
files.  A "buffered image" mode supports incremental decoding for on-the-fly
display of progressive images.  Simply recompiling an existing IJG-v5-based
decoder with v6 should allow it to read progressive files, though of course
without any special progressive display.

New "jpegtran" application performs lossless transcoding between different
JPEG formats; primarily, it can be used to convert baseline to progressive
JPEG and vice versa.  In support of jpegtran, the library now allows lossless
reading and writing of JPEG files as DCT coefficient arrays.  This ability
may be of use in other applications.

Notes for programmers:
* We changed jpeg_start_decompress() to be able to suspend; this makes all
decoding modes available to suspending-input applications.  However,
existing applications that use suspending input will need to be changed
to check the return value from jpeg_start_decompress().  You don't need to
do anything if you don't use a suspending data source.
* We changed the interface to the virtual array routines: access_virt_array
routines now take a count of the number of rows to access this time.  The
last parameter to request_virt_array routines is now interpreted as the
maximum number of rows that may be accessed at once, but not necessarily
the height of every access.


Version 5b  15-Mar-95
---------------------

Correct bugs with grayscale images having v_samp_factor > 1.

jpeg_write_raw_data() now supports output suspension.

Correct bugs in "configure" script for case of compiling in
a directory other than the one containing the source files.

Repair bug in jquant1.c: sometimes didn't use as many colors as it could.

Borland C makefile and jconfig file work under either MS-DOS or OS/2.

Miscellaneous improvements to documentation.


Version 5a  7-Dec-94
--------------------

Changed color conversion roundoff behavior so that grayscale values are
represented exactly.  (This causes test image files to change.)

Make ordered dither use 16x16 instead of 4x4 pattern for a small quality
improvement.

New configure script based on latest GNU Autoconf.
Fix configure script to handle CFLAGS correctly.
Rename *.auto files to *.cfg, so that configure script still works if
file names have been truncated for DOS.

Fix bug in rdbmp.c: didn't allow for extra data between header and image.

Modify rdppm.c/wrppm.c to handle 2-byte raw PPM/PGM formats for 12-bit data.

Fix several bugs in rdrle.c.

NEED_SHORT_EXTERNAL_NAMES option was broken.

Revise jerror.h/jerror.c for more flexibility in message table.

Repair oversight in jmemname.c NO_MKTEMP case: file could be there
but unreadable.


Version 5  24-Sep-94
--------------------

Version 5 represents a nearly complete redesign and rewrite of the IJG
software.  Major user-visible changes include:
  * Automatic configuration simplifies installation for most Unix systems.
  * A range of speed vs. image quality tradeoffs are supported.
    This includes resizing of an image during decompression: scaling down
    by a factor of 1/2, 1/4, or 1/8 is handled very efficiently.
  * New programs rdjpgcom and wrjpgcom allow insertion and extraction
    of text comments in a JPEG file.

The application programmer's interface to the library has changed completely.
Notable improvements include:
  * We have eliminated the use of callback routines for handling the
    uncompressed image data.  The application now sees the library as a
    set of routines that it calls to read or write image data on a
    scanline-by-scanline basis.
  * The application image data is represented in a conventional interleaved-
    pixel format, rather than as a separate array for each color channel.
    This can save a copying step in many programs.
  * The handling of compressed data has been cleaned up: the application can
    supply routines to source or sink the compressed data.  It is possible to
    suspend processing on source/sink buffer overrun, although this is not
    supported in all operating modes.
  * All static state has been eliminated from the library, so that multiple
    instances of compression or decompression can be active concurrently.
  * JPEG abbreviated datastream formats are supported, ie, quantization and
    Huffman tables can be stored separately from the image data.
  * And not only that, but the documentation of the library has improved
    considerably!


The last widely used release before the version 5 rewrite was version 4A of
18-Feb-93.  Change logs before that point have been discarded, since they
are not of much interest after the rewrite.
1	CHANGE LOG for Independent JPEG Group's JPEG software
2
3
4	Version 7 27-Jun-2009
5	----------------------
6
7	New scaled DCTs implemented.
8	djpeg now supports scalings N/8 with all N from 1 to 16.
9	cjpeg now supports scalings 8/N with all N from 1 to 16.
10	Scaled DCTs with size larger than 8 are now also used for resolving the
11	common 2x2 chroma subsampling case without additional spatial resampling.
12	Separate spatial resampling for those kind of files is now only necessary
13	for N>8 scaling cases.
14	Furthermore, separate scaled DCT functions are provided for direct resolving
15	of the common asymmetric subsampling cases (2x1 and 1x2) without additional
16	spatial resampling.
17
18	cjpeg -quality option has been extended for support of separate quality
19	settings for luminance and chrominance (or in general, for every provided
20	quantization table slot).
21	New API function jpeg_default_qtables() and q_scale_factor array in library.
22
23	Added -nosmooth option to cjpeg, complementary to djpeg.
24	New variable "do_fancy_downsampling" in library, complement to fancy
25	upsampling. Fancy upsampling now uses direct DCT scaling with sizes
26	larger than 8. The old method is not reversible and has been removed.
27
28	Support arithmetic entropy encoding and decoding.
29	Added files jaricom.c, jcarith.c, jdarith.c.
30
31	Straighten the file structure:
32	Removed files jidctred.c, jcphuff.c, jchuff.h, jdphuff.c, jdhuff.h.
33
34	jpegtran has a new "lossless" cropping feature.
35
36	Implement -perfect option in jpegtran, new API function
37	jtransform_perfect_transform() in transupp. (DP 204_perfect.dpatch)
38
39	Better error messages for jpegtran fopen failure.
40	(DP 203_jpegtran_errmsg.dpatch)
41
42	Fix byte order issue with 16bit PPM/PGM files in rdppm.c/wrppm.c:
43	according to Netpbm, the de facto standard implementation of the PNM formats,
44	the most significant byte is first. (DP 203_rdppm.dpatch)
45
46	Add -raw option to rdjpgcom not to mangle the output.
47	(DP 205_rdjpgcom_raw.dpatch)
48
49	Make rdjpgcom locale aware. (DP 201_rdjpgcom_locale.dpatch)
50
51	Add extern "C" to jpeglib.h.
52	This avoids the need to put extern "C" { ... } around #include "jpeglib.h"
53	in your C++ application. Defining the symbol DONT_USE_EXTERN_C in the
54	configuration prevents this. (DP 202_jpeglib.h_c++.dpatch)
55
56
57	Version 6b 27-Mar-1998
58	-----------------------
59
60	jpegtran has new features for lossless image transformations (rotation
61	and flipping) as well as "lossless" reduction to grayscale.
62
63	jpegtran now copies comments by default; it has a -copy switch to enable
64	copying all APPn blocks as well, or to suppress comments. (Formerly it
65	always suppressed comments and APPn blocks.) jpegtran now also preserves
66	JFIF version and resolution information.
67
68	New decompressor library feature: COM and APPn markers found in the input
69	file can be saved in memory for later use by the application. (Before,
70	you had to code this up yourself with a custom marker processor.)
71
72	There is an unused field "void * client_data" now in compress and decompress
73	parameter structs; this may be useful in some applications.
74
75	JFIF version number information is now saved by the decoder and accepted by
76	the encoder. jpegtran uses this to copy the source file's version number,
77	to ensure "jpegtran -copy all" won't create bogus files that contain JFXX
78	extensions but claim to be version 1.01. Applications that generate their
79	own JFXX extension markers also (finally) have a supported way to cause the
80	encoder to emit JFIF version number 1.02.
81
82	djpeg's trace mode reports JFIF 1.02 thumbnail images as such, rather
83	than as unknown APP0 markers.
84
85	In -verbose mode, djpeg and rdjpgcom will try to print the contents of
86	APP12 markers as text. Some digital cameras store useful text information
87	in APP12 markers.
88
89	Handling of truncated data streams is more robust: blocks beyond the one in
90	which the error occurs will be output as uniform gray, or left unchanged
91	if decoding a progressive JPEG. The appearance no longer depends on the
92	Huffman tables being used.
93
94	Huffman tables are checked for validity much more carefully than before.
95
96	To avoid the Unisys LZW patent, djpeg's GIF output capability has been
97	changed to produce "uncompressed GIFs", and cjpeg's GIF input capability
98	has been removed altogether. We're not happy about it either, but there
99	seems to be no good alternative.
100
101	The configure script now supports building libjpeg as a shared library
102	on many flavors of Unix (all the ones that GNU libtool knows how to
103	build shared libraries for). Use "./configure --enable-shared" to
104	try this out.
105
106	New jconfig file and makefiles for Microsoft Visual C++ and Developer Studio.
107	Also, a jconfig file and a build script for Metrowerks CodeWarrior
108	on Apple Macintosh. makefile.dj has been updated for DJGPP v2, and there
109	are miscellaneous other minor improvements in the makefiles.
110
111	jmemmac.c now knows how to create temporary files following Mac System 7
112	conventions.
113
114	djpeg's -map switch is now able to read raw-format PPM files reliably.
115
116	cjpeg -progressive -restart no longer generates any unnecessary DRI markers.
117
118	Multiple calls to jpeg_simple_progression for a single JPEG object
119	no longer leak memory.
120
121
122	Version 6a 7-Feb-96
123	--------------------
124
125	Library initialization sequence modified to detect version mismatches
126	and struct field packing mismatches between library and calling application.
127	This change requires applications to be recompiled, but does not require
128	any application source code change.
129
130	All routine declarations changed to the style "GLOBAL(type) name ...",
131	that is, GLOBAL, LOCAL, METHODDEF, EXTERN are now macros taking the
132	routine's return type as an argument. This makes it possible to add
133	Microsoft-style linkage keywords to all the routines by changing just
134	these macros. Note that any application code that was using these macros
135	will have to be changed.
136
137	DCT coefficient quantization tables are now stored in normal array order
138	rather than zigzag order. Application code that calls jpeg_add_quant_table,
139	or otherwise manipulates quantization tables directly, will need to be
140	changed. If you need to make such code work with either older or newer
141	versions of the library, a test like "#if JPEG_LIB_VERSION >= 61" is
142	recommended.
143
144	djpeg's trace capability now dumps DQT tables in natural order, not zigzag
145	order. This allows the trace output to be made into a "-qtables" file
146	more easily.
147
148	New system-dependent memory manager module for use on Apple Macintosh.
149
150	Fix bug in cjpeg's -smooth option: last one or two scanlines would be
151	duplicates of the prior line unless the image height mod 16 was 1 or 2.
152
153	Repair minor problems in VMS, BCC, MC6 makefiles.
154
155	New configure script based on latest GNU Autoconf.
156
157	Correct the list of include files needed by MetroWerks C for ccommand().
158
159	Numerous small documentation updates.
160
161
162	Version 6 2-Aug-95
163	-------------------
164
165	Progressive JPEG support: library can read and write full progressive JPEG
166	files. A "buffered image" mode supports incremental decoding for on-the-fly
167	display of progressive images. Simply recompiling an existing IJG-v5-based
168	decoder with v6 should allow it to read progressive files, though of course
169	without any special progressive display.
170
171	New "jpegtran" application performs lossless transcoding between different
172	JPEG formats; primarily, it can be used to convert baseline to progressive
173	JPEG and vice versa. In support of jpegtran, the library now allows lossless
174	reading and writing of JPEG files as DCT coefficient arrays. This ability
175	may be of use in other applications.
176
177	Notes for programmers:
178	* We changed jpeg_start_decompress() to be able to suspend; this makes all
179	decoding modes available to suspending-input applications. However,
180	existing applications that use suspending input will need to be changed
181	to check the return value from jpeg_start_decompress(). You don't need to
182	do anything if you don't use a suspending data source.
183	* We changed the interface to the virtual array routines: access_virt_array
184	routines now take a count of the number of rows to access this time. The
185	last parameter to request_virt_array routines is now interpreted as the
186	maximum number of rows that may be accessed at once, but not necessarily
187	the height of every access.
188
189
190	Version 5b 15-Mar-95
191	---------------------
192
193	Correct bugs with grayscale images having v_samp_factor > 1.
194
195	jpeg_write_raw_data() now supports output suspension.
196
197	Correct bugs in "configure" script for case of compiling in
198	a directory other than the one containing the source files.
199
200	Repair bug in jquant1.c: sometimes didn't use as many colors as it could.
201
202	Borland C makefile and jconfig file work under either MS-DOS or OS/2.
203
204	Miscellaneous improvements to documentation.
205
206
207	Version 5a 7-Dec-94
208	--------------------
209
210	Changed color conversion roundoff behavior so that grayscale values are
211	represented exactly. (This causes test image files to change.)
212
213	Make ordered dither use 16x16 instead of 4x4 pattern for a small quality
214	improvement.
215
216	New configure script based on latest GNU Autoconf.
217	Fix configure script to handle CFLAGS correctly.
218	Rename .auto files to .cfg, so that configure script still works if
219	file names have been truncated for DOS.
220
221	Fix bug in rdbmp.c: didn't allow for extra data between header and image.
222
223	Modify rdppm.c/wrppm.c to handle 2-byte raw PPM/PGM formats for 12-bit data.
224
225	Fix several bugs in rdrle.c.
226
227	NEED_SHORT_EXTERNAL_NAMES option was broken.
228
229	Revise jerror.h/jerror.c for more flexibility in message table.
230
231	Repair oversight in jmemname.c NO_MKTEMP case: file could be there
232	but unreadable.
233
234
235	Version 5 24-Sep-94
236	--------------------
237
238	Version 5 represents a nearly complete redesign and rewrite of the IJG
239	software. Major user-visible changes include:
240	* Automatic configuration simplifies installation for most Unix systems.
241	* A range of speed vs. image quality tradeoffs are supported.
242	This includes resizing of an image during decompression: scaling down
243	by a factor of 1/2, 1/4, or 1/8 is handled very efficiently.
244	* New programs rdjpgcom and wrjpgcom allow insertion and extraction
245	of text comments in a JPEG file.
246
247	The application programmer's interface to the library has changed completely.
248	Notable improvements include:
249	* We have eliminated the use of callback routines for handling the
250	uncompressed image data. The application now sees the library as a
251	set of routines that it calls to read or write image data on a
252	scanline-by-scanline basis.
253	* The application image data is represented in a conventional interleaved-
254	pixel format, rather than as a separate array for each color channel.
255	This can save a copying step in many programs.
256	* The handling of compressed data has been cleaned up: the application can
257	supply routines to source or sink the compressed data. It is possible to
258	suspend processing on source/sink buffer overrun, although this is not
259	supported in all operating modes.
260	* All static state has been eliminated from the library, so that multiple
261	instances of compression or decompression can be active concurrently.
262	* JPEG abbreviated datastream formats are supported, ie, quantization and
263	Huffman tables can be stored separately from the image data.
264	* And not only that, but the documentation of the library has improved
265	considerably!
266
267
268	The last widely used release before the version 5 rewrite was version 4A of
269	18-Feb-93. Change logs before that point have been discarded, since they
270	are not of much interest after the rewrite.