blob: ac6aad33ef7f767d60998923bf0472c8c94106ff [file] [log] [blame]
DRCeb8d0962014-08-30 13:52:09 +000011.4.0
DRCe0419b52012-07-03 20:01:31 +00002=====
3
DRCeb8d0962014-08-30 13:52:09 +00004[1] Fixed a build issue on OS X PowerPC platforms (md5cmp failed to build
5because OS X does not provide the le32toh() and htole32() functions.)
6
DRC72a3cc02014-08-30 20:37:50 +00007[2] The non-SIMD RGB565 color conversion code did not work correctly on big
8endian machines. This has been fixed.
9
DRC55620c62014-10-23 19:08:14 +000010[3] Fixed an issue in tjPlaneSizeYUV() whereby it would erroneously return 1
DRC22409742014-10-23 18:54:42 +000011instead of -1 if componentID was > 0 and subsamp was TJSAMP_GRAY.
12
DRC55620c62014-10-23 19:08:14 +000013[3] Fixed an issue in tjBufSizeYUV2() wherby it would erroneously return 0
14instead of -1 if width was < 1.
15
DRC803b5d22014-11-18 15:56:43 +000016[5] The Huffman encoder now uses clz and bsr instructions for bit counting on
17ARM64 platforms (see 1.4 beta1 [5].)
18
DRC3ebcf7c2014-11-18 21:45:34 +000019[6] The close() method in the TJCompressor and TJDecompressor Java classes is
20now idempotent. Previously, that method would call the native tjDestroy()
21function even if the TurboJPEG instance had already been destroyed. This
22caused an exception to be thrown during finalization, if the close() method had
23already been called. The exception was caught, but it was still an expensive
24operation.
25
DRCea1eea42014-11-19 00:55:28 +000026[7] The TurboJPEG API previously generated an error ("Could not determine
27subsampling type for JPEG image") when attempting to decompress grayscale JPEG
28images that were compressed with a sampling factor other than 1 (for instance,
29with 'cjpeg -grayscale -sample 2x2'). Subsampling technically has no meaning
30with grayscale JPEGs, and thus the horizontal and vertical sampling factors
31for such images are ignored by the decompressor. However, the TurboJPEG API
32was being too rigid and was expecting the sampling factors to be equal to 1
33before it treated the image as a grayscale JPEG.
34
DRC9665f5e2014-11-22 04:04:38 +000035[8] cjpeg, djpeg, and jpegtran now accept an argument of -version, which will
36print the library version and exit.
37
DRC402a7152014-11-22 22:09:30 +000038[9] Referring to 1.4 beta1 [15], another extremely rare circumstance was
39discovered under which the Huffman encoder's local buffer can be overrun
40when a buffered destination manager is being used and an
41extremely-high-frequency block (basically junk image data) is being encoded.
42Even though the Huffman local buffer was increased from 128 bytes to 136 bytes
43to address the previous issue, the new issue caused even the larger buffer to
44be overrun. Further analysis reveals that, in the absolute worst case (such as
45setting alternating AC coefficients to 32767 and -32768 in the JPEG scanning
46order), the Huffman encoder can produce encoded blocks that approach double the
47size of the unencoded blocks. Thus, the Huffman local buffer was increased to
48256 bytes, which should prevent any such issue from re-occurring in the future.
49
DRC0f4469c2014-11-22 23:56:26 +000050[10] The new tjPlaneSizeYUV(), tjPlaneWidth(), and tjPlaneHeight() functions
51were not actually usable on any platform except OS X and Windows, because
52those functions were not included in the libturbojpeg mapfile. This has been
53fixed.
54
DRCeb8d0962014-08-30 13:52:09 +000055
DRCfe77fa22014-08-30 13:48:45 +0000561.3.90 (1.4 beta1)
57==================
DRCf610d612013-04-26 10:33:29 +000058
DRCfc26b652014-03-16 22:56:26 +000059[1] New features in the TurboJPEG API:
60-- YUV planar images can now be generated with an arbitrary line padding
61(previously only 4-byte padding, which was compatible with X Video, was
62supported.)
63-- The decompress-to-YUV function has been extended to support image scaling.
64-- JPEG images can now be compressed from YUV planar source images.
65-- YUV planar images can now be decoded into RGB or grayscale images.
66-- 4:1:1 subsampling is now supported. This is mainly included for
67compatibility, since 4:1:1 is not fully accelerated in libjpeg-turbo and has no
68significant advantages relative to 4:2:0.
69-- CMYK images are now supported. This feature allows CMYK source images to be
70compressed to YCCK JPEGs and YCCK or CMYK JPEGs to be decompressed to CMYK
DRCf6d7b772014-08-20 16:02:49 +000071destination images. Conversion between CMYK/YCCK and RGB or YUV images is not
72supported. Such conversion requires a color management system and is thus out
73of scope for a codec library.
DRCfc26b652014-03-16 22:56:26 +000074-- The handling of YUV images in the Java API has been significantly refactored
75and should now be much more intuitive.
76-- The Java API now supports encoding a YUV image from an arbitrary position in
77a large image buffer.
DRCaecea382014-08-11 18:05:41 +000078-- All of the YUV functions now have a corresponding function that operates on
79separate image planes instead of a unified image buffer. This allows for
DRCf6d7b772014-08-20 16:02:49 +000080compressing/decoding from or decompressing/encoding to a subregion of a larger
81YUV image. It also allows for handling YUV formats that swap the order of the
82U and V planes.
DRCf610d612013-04-26 10:33:29 +000083
DRCa6b7fbd2013-09-30 18:13:27 +000084[2] Added SIMD acceleration for DSPr2-capable MIPS platforms. This speeds up
DRCd64e23e2013-10-08 02:32:07 +000085the compression of full-color JPEGs by 70-80% on such platforms and
86decompression by 25-35%.
DRC0be9fa52013-07-24 21:50:20 +000087
DRCfc26b652014-03-16 22:56:26 +000088[3] If an application attempts to decompress a Huffman-coded JPEG image whose
DRCa1135062014-01-31 17:22:15 +000089header does not contain Huffman tables, libjpeg-turbo will now insert the
90default Huffman tables. In order to save space, many motion JPEG video frames
91are encoded without the default Huffman tables, so these frames can now be
92successfully decompressed by libjpeg-turbo without additional work on the part
93of the application. An application can still override the Huffman tables, for
94instance to re-use tables from a previous frame of the same video.
95
DRCb1068fa2014-03-23 17:53:07 +000096[4] The Mac packaging system now uses pkgbuild and productbuild rather than
97PackageMaker (which is obsolete and no longer supported.) This means that
98OS X 10.6 "Snow Leopard" or later must be used when packaging libjpeg-turbo,
99although the packages produced can be installed on OS X 10.5 "Leopard" or
100later. OS X 10.4 "Tiger" is no longer supported.
101
DRC0cfc4c12014-03-28 18:33:25 +0000102[5] The Huffman encoder now uses clz and bsr instructions for bit counting on
103ARM platforms rather than a lookup table. This reduces the memory footprint
104by 64k, which may be important for some mobile applications. Out of four
DRCfdd625e2014-04-15 03:07:44 +0000105Android devices that were tested, two demonstrated a small overall performance
106loss (~3-4% on average) with ARMv6 code and a small gain (also ~3-4%) with
107ARMv7 code when enabling this new feature, but the other two devices
108demonstrated a significant overall performance gain with both ARMv6 and ARMv7
DRCf6d7b772014-08-20 16:02:49 +0000109code (~10-20%) when enabling the feature. Actual mileage may vary.
DRC0cfc4c12014-03-28 18:33:25 +0000110
DRC0816d082014-04-20 06:57:52 +0000111[6] Worked around an issue with Visual C++ 2010 and later that caused incorrect
DRCbeb0b332014-04-20 07:36:33 +0000112pixels to be generated when decompressing a JPEG image to a 256-color bitmap,
113if compiler optimization was enabled when libjpeg-turbo was built. This caused
114the regression tests to fail when doing a release build under Visual C++ 2010
115and later.
116
DRC715bb412014-05-11 10:09:07 +0000117[7] Improved the accuracy and performance of the non-SIMD implementation of the
118floating point inverse DCT (using code borrowed from libjpeg v8a and later.)
119The accuracy of this implementation now matches the accuracy of the SSE/SSE2
120implementation. Note, however, that the floating point DCT/IDCT algorithms are
121mainly a legacy feature. They generally do not produce significantly better
122accuracy than the slow integer DCT/IDCT algorithms, and they are quite a bit
123slower.
124
DRC78df2e62014-05-12 09:23:57 +0000125[8] Added a new output colorspace (JCS_RGB565) to the libjpeg API that allows
DRCd729f4d2014-08-23 15:47:51 +0000126for decompressing JPEG images into RGB565 (16-bit) pixels. If dithering is not
127used, then this code path is SIMD-accelerated on ARM platforms.
DRC78df2e62014-05-12 09:23:57 +0000128
DRCf6d7b772014-08-20 16:02:49 +0000129[9] Numerous obsolete features, such as support for non-ANSI compilers and
130support for the MS-DOS memory model, were removed from the libjpeg code,
131greatly improving its readability and making it easier to maintain and extend.
DRC5033f3e2014-05-18 18:33:44 +0000132
DRCcf55f0b2014-05-28 20:19:54 +0000133[10] Fixed a segfault that occurred when calling output_message() with msg_code
134set to JMSG_COPYRIGHT.
135
DRCb7d6e842014-06-22 20:36:50 +0000136[11] Fixed an issue whereby wrjpgcom was allowing comments longer than 65k
137characters to be passed on the command line, which was causing it to generate
138incorrect JPEG files.
139
DRC73821bf2014-06-22 20:46:48 +0000140[12] Fixed a bug in the build system that was causing the Windows version of
DRCf6d7b772014-08-20 16:02:49 +0000141wrjpgcom to be built using the rdjpgcom source code.
DRCb7d6e842014-06-22 20:36:50 +0000142
DRCaee4f722014-08-09 23:06:07 +0000143[13] Restored 12-bit-per-component JPEG support. A 12-bit version of
144libjpeg-turbo can now be built by passing an argument of --with-12bit to
145configure (Unix) or -DWITH_12BIT=1 to cmake (Windows.) 12-bit JPEG support is
146included only for convenience. Enabling this feature disables all of the
147performance features in libjpeg-turbo, as well as arithmetic coding and the
DRCf6d7b772014-08-20 16:02:49 +0000148TurboJPEG API. The resulting library still contains the other libjpeg-turbo
149features (such as the colorspace extensions), but in general, it performs no
150faster than libjpeg v6b.
DRCaee4f722014-08-09 23:06:07 +0000151
DRCbc3c1682014-08-20 15:40:43 +0000152[14] Added ARM 64-bit SIMD acceleration for the YCC-to-RGB color conversion
153and IDCT algorithms (both are used during JPEG decompression.) For unknown
154reasons (probably related to clang), this code cannot currently be compiled for
155iOS.
156
DRC2261e1e2014-08-21 03:40:37 +0000157[15] Fixed an extremely rare bug that could cause the Huffman encoder's local
DRCeddc3552014-08-21 03:38:14 +0000158buffer to overrun when a very high-frequency MCU is compressed using quality
159100 and no subsampling, and when the JPEG output buffer is being dynamically
160resized by the destination manager. This issue was so rare that, even with a
161test program specifically designed to make the bug occur (by injecting random
162high-frequency YUV data into the compressor), it was reproducible only once in
163about every 25 million iterations.
164
DRCfe80ec22014-08-21 15:51:47 +0000165[16] Fixed an oversight in the TurboJPEG C wrapper: if any of the JPEG
166compression functions was called repeatedly with the same
167automatically-allocated destination buffer, then TurboJPEG would erroneously
168assume that the jpegSize parameter was equal to the size of the buffer, when in
169fact that parameter was probably equal to the size of the most recently
170compressed JPEG image. If the size of the previous JPEG image was not as large
171as the current JPEG image, then TurboJPEG would unnecessarily reallocate the
172destination buffer.
173
DRCf610d612013-04-26 10:33:29 +0000174
DRC96573d02013-08-11 23:23:41 +00001751.3.1
176=====
177
178[1] On Un*x systems, 'make install' now installs the libjpeg-turbo libraries
179into /opt/libjpeg-turbo/lib32 by default on any 32-bit system, not just x86,
180and into /opt/libjpeg-turbo/lib64 by default on any 64-bit system, not just
181x86-64. You can override this by overriding either the 'prefix' or 'libdir'
182configure variables.
183
DRC4d877932013-09-19 22:55:57 +0000184[2] The Windows installer now places a copy of the TurboJPEG DLLs in the same
185directory as the rest of the libjpeg-turbo binaries. This was mainly done
186to support TurboVNC 1.3, which bundles the DLLs in its Windows installation.
187When using a 32-bit version of CMake on 64-bit Windows, it is impossible to
188access the c:\WINDOWS\system32 directory, which made it impossible for the
189TurboVNC build scripts to bundle the 64-bit TurboJPEG DLL.
190
DRCcadabd42013-09-28 03:10:31 +0000191[3] Fixed a bug whereby attempting to encode a progressive JPEG with arithmetic
192entropy coding (by passing arguments of -progressive -arithmetic to cjpeg or
193jpegtran, for instance) would result in an error, "Requested feature was
194omitted at compile time".
DRC1370f102013-09-24 03:21:38 +0000195
DRC7ebf2942013-11-21 18:32:48 +0000196[4] Fixed a couple of issues whereby malformed JPEG images would cause
DRC43d8cf42013-11-21 18:34:39 +0000197libjpeg-turbo to use uninitialized memory during decompression.
198
DRC38c99702014-02-11 09:45:18 +0000199[5] Fixed an error ("Buffer passed to JPEG library is too small") that occurred
200when calling the TurboJPEG YUV encoding function with a very small (< 5x5)
201source image, and added a unit test to check for this error.
202
DRCd45c5492014-03-11 06:21:46 +0000203[6] The Java classes should now build properly under Visual Studio 2010 and
204later.
205
DRCde23dd82014-03-22 20:43:03 +0000206[7] Fixed an issue that prevented SRPMs generated using the in-tree packaging
207tools from being rebuilt on certain newer Linux distributions.
208
209[8] Numerous minor fixes to eliminate compilation and build/packaging system
210warnings, fix cosmetic issues, improve documentation clarity, and other general
211source cleanup.
212
DRC96573d02013-08-11 23:23:41 +0000213
DRC0bf58f22013-02-06 23:51:08 +00002141.3.0
215=====
216
217[1] 'make test' now works properly on FreeBSD, and it no longer requires the
218md5sum executable to be present on other Un*x platforms.
219
DRCd7a642b2013-04-24 06:40:25 +0000220[2] Overhauled the packaging system:
DRC764e1e22013-04-19 04:25:14 +0000221-- To avoid conflict with vendor-supplied libjpeg-turbo packages, the
222official RPMs and DEBs for libjpeg-turbo have been renamed to
DRCd7a642b2013-04-24 06:40:25 +0000223"libjpeg-turbo-official".
224-- The TurboJPEG libraries are now located under /opt/libjpeg-turbo in the
225official Linux and Mac packages, to avoid conflict with vendor-supplied
226packages and also to streamline the packaging system.
227-- Release packages are now created with the directory structure defined
228by the configure variables "prefix", "bindir", "libdir", etc. (Un*x) or by the
229CMAKE_INSTALL_PREFIX variable (Windows.) The exception is that the docs are
230always located under the system default documentation directory on Un*x and Mac
231systems, and on Windows, the TurboJPEG DLL is always located in the Windows
232system directory.
DRC764e1e22013-04-19 04:25:14 +0000233-- To avoid confusion, official libjpeg-turbo packages on Linux/Unix platforms
234(except for Mac) will always install the 32-bit libraries in
235/opt/libjpeg-turbo/lib32 and the 64-bit libraries in /opt/libjpeg-turbo/lib64.
DRCd7a642b2013-04-24 06:40:25 +0000236-- Fixed an issue whereby, in some cases, the libjpeg-turbo executables on Un*x
237systems were not properly linking with the shared libraries installed by the
238same package.
239-- Fixed an issue whereby building the "installer" target on Windows when
240WITH_JAVA=1 would fail if the TurboJPEG JAR had not been previously built.
241-- Building the "install" target on Windows now installs files into the same
242places that the installer does.
DRC764e1e22013-04-19 04:25:14 +0000243
DRC4c17a452013-04-25 08:55:31 +0000244[3] Fixed a Huffman encoder bug that prevented I/O suspension from working
245properly.
246
DRC0bf58f22013-02-06 23:51:08 +0000247
DRC84f71222012-12-31 09:44:31 +00002481.2.90 (1.3 beta1)
249==================
DRC27fb3fc2012-01-28 01:48:07 +0000250
251[1] Added support for additional scaling factors (3/8, 5/8, 3/4, 7/8, 9/8, 5/4,
DRCffe4fc12012-03-16 14:30:46 +000025211/8, 3/2, 13/8, 7/4, 15/8, and 2) when decompressing. Note that the IDCT will
253not be SIMD-accelerated when using any of these new scaling factors.
DRC27fb3fc2012-01-28 01:48:07 +0000254
DRC575317b2012-06-15 22:00:47 +0000255[2] The TurboJPEG dynamic library is now versioned. It was not strictly
DRCfd407772012-03-23 03:24:39 +0000256necessary to do so, because TurboJPEG uses versioned symbols, and if a function
257changes in an ABI-incompatible way, that function is renamed and a legacy
258function is provided to maintain backward compatibility. However, certain
DRC5a84a0e2013-02-14 07:31:35 +0000259Linux distro maintainers have a policy against accepting any library that isn't
260versioned.
DRCfd407772012-03-23 03:24:39 +0000261
DRCfac3bea2012-09-24 02:27:55 +0000262[3] Extended the TurboJPEG Java API so that it can be used to compress a JPEG
263image from and decompress a JPEG image to an arbitrary position in a large
264image buffer.
DRC575317b2012-06-15 22:00:47 +0000265
DRC21868092012-07-03 20:02:49 +0000266[4] The tjDecompressToYUV() function now supports the TJFLAG_FASTDCT flag.
DRCe0419b52012-07-03 20:01:31 +0000267
DRCa394bf72012-08-07 18:44:24 +0000268[5] The 32-bit supplementary package for amd64 Debian systems now provides
DRC0a0f8d12012-08-07 18:42:07 +0000269symlinks in /usr/lib/i386-linux-gnu for the TurboJPEG libraries in /usr/lib32.
270This allows those libraries to be used on MultiArch-compatible systems (such as
271Ubuntu 11 and later) without setting the linker path.
272
DRC61e13412012-08-24 02:44:39 +0000273[6] The TurboJPEG Java wrapper should now find the JNI library on Mac systems
274without having to pass -Djava.library.path=/usr/lib to java.
275
DRCd9d1d672012-10-02 04:20:43 +0000276[7] TJBench has been ported to Java to provide a convenient way of validating
277the performance of the TurboJPEG Java API. It can be run with
278'java -cp turbojpeg.jar TJBench'.
279
DRCf73a27c2013-01-01 10:25:43 +0000280[8] cjpeg can now be used to generate JPEG files with the RGB colorspace
281(feature ported from jpeg-8d.)
282
DRC8cbf8932013-01-01 10:44:00 +0000283[9] The width and height in the -crop argument passed to jpegtran can now be
284suffixed with "f" to indicate that, when the upper left corner of the cropping
285region is automatically moved to the nearest iMCU boundary, the bottom right
286corner should be moved by the same amount. In other words, this feature causes
287jpegtran to strictly honor the specified width/height rather than the specified
288bottom right corner (feature ported from jpeg-8d.)
289
DRCf37e4da2013-01-01 10:52:29 +0000290[10] JPEG files using the RGB colorspace can now be decompressed into grayscale
291images (feature ported from jpeg-8d.)
292
DRC00c2cf32013-01-13 12:12:53 +0000293[11] Fixed a regression caused by 1.2.1[7] whereby the build would fail with
DRCb87a0b42013-01-13 12:15:58 +0000294multiple "Mismatch in operand sizes" errors when attempting to build the x86
295SIMD code with NASM 0.98.
296
DRCab706232013-01-18 23:42:31 +0000297[12] The in-memory source/destination managers (jpeg_mem_src() and
298jpeg_mem_dest()) are now included by default when building libjpeg-turbo with
299libjpeg v6b or v7 emulation, so that programs can take advantage of these
300functions without requiring the use of the backward-incompatible libjpeg v8
301ABI. The "age number" of the libjpeg-turbo library on Un*x systems has been
302incremented by 1 to reflect this. You can disable this feature with a
303configure/CMake switch in order to retain strict API/ABI compatibility with the
304libjpeg v6b or v7 API/ABI (or with previous versions of libjpeg-turbo.) See
305README-turbo.txt for more details.
306
DRCa2a2cd62013-02-04 22:29:57 +0000307[13] Added ARM v7s architecture to libjpeg.a and libturbojpeg.a in the official
308libjpeg-turbo binary package for OS X, so that those libraries can be used to
309build applications that leverage the faster CPUs in the iPhone 5 and iPad 4.
310
DRC575317b2012-06-15 22:00:47 +0000311
3121.2.1
313=====
314
315[1] Creating or decoding a JPEG file that uses the RGB colorspace should now
316properly work when the input or output colorspace is one of the libjpeg-turbo
317colorspace extensions.
318
319[2] When libjpeg-turbo was built without SIMD support and merged (non-fancy)
320upsampling was used along with an alpha-enabled colorspace during
321decompression, the unused byte of the decompressed pixels was not being set to
3220xFF. This has been fixed. TJUnitTest has also been extended to test for the
323correct behavior of the colorspace extensions when merged upsampling is used.
324
325[3] Fixed a bug whereby the libjpeg-turbo SSE2 SIMD code would not preserve the
DRC4f240162012-04-26 19:50:37 +0000326upper 64 bits of xmm6 and xmm7 on Win64 platforms, which violated the Win64
327calling conventions.
328
DRC575317b2012-06-15 22:00:47 +0000329[4] Fixed a regression caused by 1.2.0[6] whereby decompressing corrupt JPEG
DRCdd2b6512012-05-30 20:36:42 +0000330images (specifically, images in which the component count was erroneously set
331to a large value) would cause libjpeg-turbo to segfault.
332
DRC575317b2012-06-15 22:00:47 +0000333[5] Worked around a severe performance issue with "Bobcat" (AMD Embedded APU)
DRC69799272012-06-13 01:21:29 +0000334processors. The MASKMOVDQU instruction, which was used by the libjpeg-turbo
335SSE2 SIMD code, is apparently implemented in microcode on AMD processors, and
336it is painfully slow on Bobcat processors in particular. Eliminating the use
337of this instruction improved performance by an order of magnitude on Bobcat
338processors and by a small amount (typically 5%) on AMD desktop processors.
339
DRC575317b2012-06-15 22:00:47 +0000340[6] Added SIMD acceleration for performing 4:2:2 upsampling on NEON-capable ARM
341platforms. This speeds up the decompression of 4:2:2 JPEGs by 20-25% on such
342platforms.
343
DRCde37e072012-06-18 00:08:18 +0000344[7] Fixed a regression caused by 1.2.0[2] whereby, on Linux/x86 platforms
345running the 32-bit SSE2 SIMD code in libjpeg-turbo, decompressing a 4:2:0 or
3464:2:2 JPEG image into a 32-bit (RGBX, BGRX, etc.) buffer without using fancy
347upsampling would produce several incorrect columns of pixels at the right-hand
348side of the output image if each row in the output image was not evenly
349divisible by 16 bytes.
DRC8126d0c2012-06-15 21:54:45 +0000350
DRC112a0bb2012-06-28 23:25:34 +0000351[8] Fixed an issue whereby attempting to build the SIMD extensions with Xcode
3524.3 on OS X platforms would cause NASM to return numerous errors of the form
353"'%define' expects a macro identifier".
354
DRC73d74c12012-06-29 23:46:38 +0000355[9] Added flags to the TurboJPEG API that allow the caller to force the use of
356either the fast or the accurate DCT/IDCT algorithms in the underlying codec.
357
DRC27fb3fc2012-01-28 01:48:07 +0000358
DRC1ca924a2011-11-29 08:58:27 +00003591.2.0
360=====
361
362[1] Fixed build issue with YASM on Unix systems (the libjpeg-turbo build system
363was not adding the current directory to the assembler include path, so YASM
364was not able to find jsimdcfg.inc.)
365
DRCebfe9e42011-12-01 10:58:36 +0000366[2] Fixed out-of-bounds read in SSE2 SIMD code that occurred when decompressing
367a JPEG image to a bitmap buffer whose size was not a multiple of 16 bytes.
368This was more of an annoyance than an actual bug, since it did not cause any
369actual run-time problems, but the issue showed up when running libjpeg-turbo in
370valgrind. See http://crbug.com/72399 for more information.
371
DRCab64b622011-12-18 16:29:35 +0000372[3] Added a compile-time macro (LIBJPEG_TURBO_VERSION) that can be used to
373check the version of libjpeg-turbo against which an application was compiled.
374
DRC67ce3b22011-12-19 02:21:03 +0000375[4] Added new RGBA/BGRA/ABGR/ARGB colorspace extension constants (libjpeg API)
376and pixel formats (TurboJPEG API), which allow applications to specify that,
377when decompressing to a 4-component RGB buffer, the unused byte should be set
378to 0xFF so that it can be interpreted as an opaque alpha channel.
379
DRCa7466c92012-01-26 22:20:31 +0000380[5] Fixed regression issue whereby DevIL failed to build against libjpeg-turbo
381because libjpeg-turbo's distributed version of jconfig.h contained an INLINE
382macro, which conflicted with a similar macro in DevIL. This macro is used only
383internally when building libjpeg-turbo, so it was moved into config.h.
384
DRC12781cb2012-01-27 01:23:20 +0000385[6] libjpeg-turbo will now correctly decompress erroneous CMYK/YCCK JPEGs whose
386K component is assigned a component ID of 1 instead of 4. Although these files
387are in violation of the spec, other JPEG implementations handle them
388correctly.
389
DRCc0526462012-02-10 01:44:55 +0000390[7] Added ARM v6 and ARM v7 architectures to libjpeg.a and libturbojpeg.a in
DRCa2a2cd62013-02-04 22:29:57 +0000391the official libjpeg-turbo binary package for OS X, so that those libraries can
392be used to build both OS X and iOS applications.
DRCc0526462012-02-10 01:44:55 +0000393
DRC1ca924a2011-11-29 08:58:27 +0000394
DRCf8e00552011-02-04 11:06:36 +00003951.1.90 (1.2 beta1)
396==================
397
DRC7bc3fb52011-10-28 06:45:53 +0000398[1] Added a Java wrapper for the TurboJPEG API. See java/README for more
399details.
DRCf8e00552011-02-04 11:06:36 +0000400
DRC7bc3fb52011-10-28 06:45:53 +0000401[2] The TurboJPEG API can now be used to scale down images during
402decompression.
DRCa3c30592011-02-07 08:06:16 +0000403
DRC15866ac2011-03-04 13:46:55 +0000404[3] Added SIMD routines for RGB-to-grayscale color conversion, which
405significantly improves the performance of grayscale JPEG compression from an
406RGB source image.
407
DRC3c21b082011-10-28 06:25:13 +0000408[4] Improved the performance of the C color conversion routines, which are used
409on platforms for which SIMD acceleration is not available.
DRC15866ac2011-03-04 13:46:55 +0000410
DRC3c21b082011-10-28 06:25:13 +0000411[5] Added a function to the TurboJPEG API that performs lossless transforms.
412This function is implemented using the same back end as jpegtran, but it
413performs transcoding entirely in memory and allows multiple transforms and/or
414crop operations to be batched together, so the source coefficients only need to
415be read once. This is useful when generating image tiles from a single source
416JPEG.
DRC15866ac2011-03-04 13:46:55 +0000417
DRC3c21b082011-10-28 06:25:13 +0000418[6] Added tests for the new TurboJPEG scaled decompression and lossless
DRC77fee432011-11-01 17:14:22 +0000419transform features to tjbench (the TurboJPEG benchmark, formerly called
420"jpgtest".)
DRC15866ac2011-03-04 13:46:55 +0000421
422[7] Added support for 4:4:0 (transposed 4:2:2) subsampling in TurboJPEG, which
423was necessary in order for it to read 4:2:2 JPEG files that had been losslessly
424transposed or rotated 90 degrees.
425
DRC67d1fc12011-05-24 14:13:01 +0000426[8] All legacy VirtualGL code has been re-factored, and this has allowed
427libjpeg-turbo, in its entirety, to be re-licensed under a BSD-style license.
DRCee269922011-04-26 23:46:38 +0000428
DRCf89dd1e2011-05-21 14:23:30 +0000429[9] libjpeg-turbo can now be built with YASM.
DRC56fb2372011-05-03 06:32:41 +0000430
DRCe5c6eb52011-08-17 20:59:56 +0000431[10] Added SIMD acceleration for ARM Linux and iOS platforms that support
432NEON instructions.
DRC321e0682011-05-03 08:47:43 +0000433
DRC3c21b082011-10-28 06:25:13 +0000434[11] Refactored the TurboJPEG C API and documented it using Doxygen. The
435TurboJPEG 1.2 API uses pixel formats to define the size and component order of
436the uncompressed source/destination images, and it includes a more efficient
437version of TJBUFSIZE() that computes a worst-case JPEG size based on the level
DRC5039d732013-01-21 23:42:12 +0000438of chrominance subsampling. The refactored implementation of the TurboJPEG API
DRC3c21b082011-10-28 06:25:13 +0000439now uses the libjpeg memory source and destination managers, which allows the
440TurboJPEG compressor to grow the JPEG buffer as necessary.
DRC9b28def2011-05-21 14:37:15 +0000441
DRCe9f9ec42011-05-25 06:02:50 +0000442[12] Eliminated errors in the output of jpegtran on Windows that occurred when
DRC7e3fd2f2011-05-25 06:04:43 +0000443the application was invoked using I/O redirection
444(jpegtran <input.jpg >output.jpg).
445
DRCb8c6ee32011-05-31 20:22:37 +0000446[13] The inclusion of libjpeg v7 and v8 emulation as well as arithmetic coding
DRC0571e172011-05-31 20:17:16 +0000447support in libjpeg-turbo v1.1.0 introduced several new error constants in
448jerror.h, and these were mistakenly enabled for all emulation modes, causing
DRCfa9ff8e2011-06-21 06:17:10 +0000449the error enum in libjpeg-turbo to sometimes have different values than the
450same enum in libjpeg. This represents an ABI incompatibility, and it caused
451problems with rare applications that took specific action based on a particular
452error value. The fix was to include the new error constants conditionally
453based on whether libjpeg v7 or v8 emulation was enabled.
DRC0571e172011-05-31 20:17:16 +0000454
DRCeed08612011-06-21 04:56:02 +0000455[14] Fixed an issue whereby Windows applications that used libjpeg-turbo would
DRCb7120ca2011-06-21 04:57:32 +0000456fail to compile if the Windows system headers were included before jpeglib.h.
457This issue was caused by a conflict in the definition of the INT32 type.
DRC6ca69532011-02-18 03:31:11 +0000458
DRC3c21b082011-10-28 06:25:13 +0000459[15] Fixed 32-bit supplementary package for amd64 Debian systems, which was
DRC68a086a2011-07-19 09:26:23 +0000460broken by enhancements to the packaging system in 1.1.
461
DRC3c21b082011-10-28 06:25:13 +0000462[16] When decompressing a JPEG image using an output colorspace of
DRCc08e8c12011-09-08 23:54:40 +0000463JCS_EXT_RGBX, JCS_EXT_BGRX, JCS_EXT_XBGR, or JCS_EXT_XRGB, libjpeg-turbo will
464now set the unused byte to 0xFF, which allows applications to interpret that
465byte as an alpha channel (0xFF = opaque).
466
DRCf8e00552011-02-04 11:06:36 +0000467
DRC6ee54592011-03-01 08:18:30 +00004681.1.1
469=====
470
471[1] Fixed a 1-pixel error in row 0, column 21 of the luminance plane generated
472by tjEncodeYUV().
473
DRC8071c392011-04-17 15:29:17 +0000474[2] libjpeg-turbo's accelerated Huffman decoder previously ignored unexpected
475markers found in the middle of the JPEG data stream during decompression. It
476will now hand off decoding of a particular block to the unaccelerated Huffman
477decoder if an unexpected marker is found, so that the unaccelerated Huffman
478decoder can generate an appropriate warning.
DRC6ee54592011-03-01 08:18:30 +0000479
DRC47aaf6f2011-03-22 05:40:39 +0000480[3] Older versions of MinGW64 prefixed symbol names with underscores by
DRC1da78582011-03-22 09:34:01 +0000481default, which differed from the behavior of 64-bit Visual C++. MinGW64 1.0
482has adopted the behavior of 64-bit Visual C++ as the default, so to accommodate
483this, the libjpeg-turbo SIMD function names are no longer prefixed with an
484underscore when building with MinGW64. This means that, when building
485libjpeg-turbo with older versions of MinGW64, you will now have to add
486-fno-leading-underscore to the CFLAGS.
487
DRCd8840112011-04-25 22:46:25 +0000488[4] Fixed a regression bug in the NSIS script that caused the Windows installer
489build to fail when using the Visual Studio IDE.
490
491[5] Fixed a bug in jpeg_read_coefficients() whereby it would not initialize
492cinfo->image_width and cinfo->image_height if libjpeg v7 or v8 emulation was
493enabled. This specifically caused the jpegoptim program to fail if it was
494linked against a version of libjpeg-turbo that was built with libjpeg v7 or v8
495emulation.
496
DRC049aef52011-04-25 22:41:14 +0000497[6] Eliminated excessive I/O overhead that occurred when reading BMP files in
498cjpeg.
499
DRC5ee81f42011-05-02 00:35:50 +0000500[7] Eliminated errors in the output of cjpeg on Windows that occurred when the
DRC34a8e352011-05-10 22:14:38 +0000501application was invoked using I/O redirection (cjpeg <inputfile >output.jpg).
DRC5ee81f42011-05-02 00:35:50 +0000502
DRCf5c3bb32011-03-18 05:59:07 +0000503
DRC958b2c02011-01-28 08:00:40 +00005041.1.0
505=====
DRCfa1d1832011-01-26 05:35:20 +0000506
DRCa49c4e52011-02-18 20:50:08 +0000507[1] The algorithm used by the SIMD quantization function cannot produce correct
508results when the JPEG quality is >= 98 and the fast integer forward DCT is
509used. Thus, the non-SIMD quantization function is now used for those cases,
510and libjpeg-turbo should now produce identical output to libjpeg v6b in all
511cases.
DRCe1716b82011-02-18 03:19:43 +0000512
DRCa49c4e52011-02-18 20:50:08 +0000513[2] Despite the above, the fast integer forward DCT still degrades somewhat for
DRC5039d732013-01-21 23:42:12 +0000514JPEG qualities greater than 95, so the TurboJPEG wrapper will now automatically
515use the slow integer forward DCT when generating JPEG images of quality 96 or
516greater. This reduces compression performance by as much as 15% for these
517high-quality images but is necessary to ensure that the images are perceptually
518lossless. It also ensures that the library can avoid the performance pitfall
519created by [1].
DRCa49c4e52011-02-18 20:50:08 +0000520
521[3] Ported jpgtest.cxx to pure C to avoid the need for a C++ compiler.
522
523[4] Fixed visual artifacts in grayscale JPEG compression caused by a typo in
DRCd9ee65c2011-04-05 07:01:26 +0000524the RGB-to-luminance lookup tables.
DRC8ed7b812011-02-15 08:31:34 +0000525
DRC240d82f2011-02-19 00:00:34 +0000526[5] The Windows distribution packages now include the libjpeg run-time programs
527(cjpeg, etc.)
528
DRC9cd2c422011-02-19 17:52:45 +0000529[6] All packages now include jpgtest.
DRC240d82f2011-02-19 00:00:34 +0000530
DRCe4d9b5b2011-02-25 06:17:17 +0000531[7] The TurboJPEG dynamic library now uses versioned symbols.
532
533[8] Added two new TurboJPEG API functions, tjEncodeYUV() and
534tjDecompressToYUV(), to replace the somewhat hackish TJ_YUV flag.
535
DRC2d94e262011-01-25 06:52:31 +0000536
DRC958b2c02011-01-28 08:00:40 +00005371.0.90 (1.1 beta1)
538==================
DRC766dc5c2010-10-12 02:50:18 +0000539
DRCf38eee02011-02-18 07:00:38 +0000540[1] Added emulation of the libjpeg v7 and v8 APIs and ABIs. See
DRCefa618e2010-10-18 08:41:11 +0000541README-turbo.txt for more details. This feature was sponsored by CamTrace SAS.
542
543[2] Created a new CMake-based build system for the Visual C++ and MinGW builds.
DRC766dc5c2010-10-12 02:50:18 +0000544
DRC2c62da32012-01-17 22:55:03 +0000545[3] Grayscale bitmaps can now be compressed from/decompressed to using the
546TurboJPEG API.
DRC09854f52010-11-04 22:39:59 +0000547
DRC01e69092011-01-06 01:19:43 +0000548[4] jpgtest can now be used to test decompression performance with existing
549JPEG images.
DRCe89bbae2010-11-12 10:18:08 +0000550
DRCd1c281a2010-11-17 22:44:40 +0000551[5] If the default install prefix (/opt/libjpeg-turbo) is used, then
552'make install' now creates /opt/libjpeg-turbo/lib32 and
553/opt/libjpeg-turbo/lib64 sym links to duplicate the behavior of the binary
554packages.
555
DRCec311932010-11-22 19:51:42 +0000556[6] All symbols in the libjpeg-turbo dynamic library are now versioned, even
557when the library is built with libjpeg v6b emulation.
558
DRC01e69092011-01-06 01:19:43 +0000559[7] Added arithmetic encoding and decoding support (can be disabled with
DRC245cfdf2010-11-23 17:11:06 +0000560configure or CMake options)
DRC66f97e62010-11-23 05:49:54 +0000561
DRC2c62da32012-01-17 22:55:03 +0000562[8] Added a TJ_YUV flag to the TurboJPEG API, which causes both the compressor
563and decompressor to output planar YUV images.
DRCfbb67472010-11-24 04:02:37 +0000564
DRC2c62da32012-01-17 22:55:03 +0000565[9] Added an extended version of tjDecompressHeader() to the TurboJPEG API,
566which allows the caller to determine the type of subsampling used in a JPEG
567image.
DRC50c657b2010-12-14 01:23:16 +0000568
DRC958b2c02011-01-28 08:00:40 +0000569[10] Added further protections against invalid Huffman codes.
DRCfa1d1832011-01-26 05:35:20 +0000570
DRC766dc5c2010-10-12 02:50:18 +0000571
DRC958b2c02011-01-28 08:00:40 +00005721.0.1
573=====
DRC0fbb28e2010-07-30 17:15:52 +0000574
575[1] The Huffman decoder will now handle erroneous Huffman codes (for instance,
576from a corrupt JPEG image.) Previously, these would cause libjpeg-turbo to
577crash under certain circumstances.
578
DRC81a50f72012-01-17 22:56:22 +0000579[2] Fixed typo in SIMD dispatch routines that was causing 4:2:2 upsampling to
DRC025a2792010-08-07 16:27:56 +0000580be used instead of 4:2:0 when decompressing JPEG images using SSE2 code.
DRC30959712010-08-07 16:06:56 +0000581
DRCbdb12882010-08-21 21:14:17 +0000582[3] configure script will now automatically determine whether the
583INCOMPLETE_TYPES_BROKEN macro should be defined.
584
DRC0fbb28e2010-07-30 17:15:52 +0000585
DRC958b2c02011-01-28 08:00:40 +00005861.0.0
587=====
DRC49597872010-05-17 20:47:57 +0000588
DRCc773d102010-06-05 06:58:22 +0000589[1] 2983700: Further FreeBSD build tweaks (no longer necessary to specify
590--host when configuring on a 64-bit system)
DRC49597872010-05-17 20:47:57 +0000591
DRCd5e964c2013-01-10 11:47:39 +0000592[2] Created symlinks in the Unix/Linux packages so that the TurboJPEG
DRCf12c7db2010-05-18 19:04:47 +0000593include file can always be found in /opt/libjpeg-turbo/include, the 32-bit
594static libraries can always be found in /opt/libjpeg-turbo/lib32, and the
59564-bit static libraries can always be found in /opt/libjpeg-turbo/lib64.
596
DRC4bf3b582010-06-05 01:03:23 +0000597[3] The Unix/Linux distribution packages now include the libjpeg run-time
598programs (cjpeg, etc.) and man pages.
599
DRC81a50f72012-01-17 22:56:22 +0000600[4] Created a 32-bit supplementary package for amd64 Debian systems, which
DRC4bf3b582010-06-05 01:03:23 +0000601contains just the 32-bit libjpeg-turbo libraries.
602
603[5] Moved the libraries from */lib32 to */lib in the i386 Debian package.
604
DRCdf3337c2010-07-02 09:13:58 +0000605[6] Include distribution package for Cygwin
DRC4bf3b582010-06-05 01:03:23 +0000606
DRCdf3337c2010-07-02 09:13:58 +0000607[7] No longer necessary to specify --without-simd on non-x86 architectures, and
DRC38ccf852010-06-10 19:49:49 +0000608unit tests now work on those architectures.
609
DRC49597872010-05-17 20:47:57 +0000610
DRC958b2c02011-01-28 08:00:40 +00006110.0.93
612======
DRC0f413b22010-04-06 20:05:39 +0000613
DRCc773d102010-06-05 06:58:22 +0000614[1] 2982659, Fixed x86-64 build on FreeBSD systems
DRC0f413b22010-04-06 20:05:39 +0000615
DRCc773d102010-06-05 06:58:22 +0000616[2] 2988188: Added support for Windows 64-bit systems
DRC1a2219e2010-05-10 20:03:36 +0000617
DRC0f413b22010-04-06 20:05:39 +0000618
DRC958b2c02011-01-28 08:00:40 +00006190.0.91
620======
DRCae19bf62010-03-15 11:40:31 +0000621
622[1] Added documentation to .deb packages
623
624[2] 2968313: Fixed data corruption issues when decompressing large JPEG images
625and/or using buffered I/O with the libjpeg-turbo decompressor
DRC958b2c02011-01-28 08:00:40 +0000626
627
6280.0.90
629======
630
631Initial release