blob: f31938e3f71e8c59a4267b10d0e09e67f3d6abe6 [file] [log] [blame]
DRCcbc99702015-01-16 06:29:52 +000011.4.1
2=====
3
4[1] tjbench now properly handles CMYK/YCCK JPEG files. Passing an argument of
5-cmyk (instead of, for instance, -rgb) will cause tjbench to internally convert
6the source bitmap to CMYK prior to compression, to generate YCCK JPEG files,
7and to internally convert the decompressed CMYK pixels back to RGB after
8decompression (the latter is done automatically if a CMYK or YCCK JPEG is
9passed to tjbench as a source image.) The CMYK<->RGB conversion operation is
10not benchmarked. NOTE: The quick & dirty CMYK<->RGB conversions that tjbench
11uses are suitable for testing only. Proper conversion between CMYK and RGB
12requires a color management system.
13
DRCdd7f03b2015-01-16 06:45:54 +000014[2] 'make test' now performs additional bitwise regression tests using tjbench,
15mainly for the purpose of testing compression from/decompression to a subregion
16of a larger image buffer.
17
DRC3af282d2015-01-16 06:53:36 +000018[3] 'make test' no longer tests the regression of the floating point DCT/IDCT
19by default, since the results of those tests can vary if the algorithms in
20question are not implemented using SIMD instructions on a particular platform.
21See the comments in Makefile.am for information on how to re-enable the tests
22and to specify an expected result for them based on the particulars of your
23platform.
24
DRC0e940252015-01-20 10:33:32 +000025[4] The NULL color conversion routines have been significantly optimized,
26which speeds up the compression of RGB and CMYK JPEGs by 5-20% when using
2764-bit code and 0-3% when using 32-bit code, and the decompression of those
28images by 10-30% when using 64-bit code and 3-12% when using 32-bit code.
29
DRC8b5a0092015-01-21 17:42:28 +000030[5] Fixed an "illegal instruction" error that occurred when djpeg from a
31SIMD-enabled libjpeg-turbo MIPS build was executed with the -nosmooth option on
32a MIPS machine that lacked DSPr2 support. The MIPS SIMD routines for h2v1 and
33h2v2 merged upsampling were not properly checking for the existence of DSPr2.
34
DRCf64b36f2015-04-22 08:43:04 +000035[6] Performance has been improved significantly on 64-bit Mac platforms
36(particularly compression performance.) Due to an oversight, the 64-bit
37version of the accelerated Huffman codec was not being compiled in when
38libjpeg-turbo was built on OS X. Oops.
39
DRCa8b6ea22015-05-06 22:41:12 +000040[7] Fixed an extremely rare bug in the Huffman encoder that caused 64-bit
41builds of libjpeg-turbo to incorrectly encode a few specific test images when
42quality=98, an optimized Huffman table, and the slow integer forward DCT were
43used.
44
DRCcbc99702015-01-16 06:29:52 +000045
DRCeb8d0962014-08-30 13:52:09 +0000461.4.0
DRCe0419b52012-07-03 20:01:31 +000047=====
48
DRCeb8d0962014-08-30 13:52:09 +000049[1] Fixed a build issue on OS X PowerPC platforms (md5cmp failed to build
50because OS X does not provide the le32toh() and htole32() functions.)
51
DRC72a3cc02014-08-30 20:37:50 +000052[2] The non-SIMD RGB565 color conversion code did not work correctly on big
53endian machines. This has been fixed.
54
DRC55620c62014-10-23 19:08:14 +000055[3] Fixed an issue in tjPlaneSizeYUV() whereby it would erroneously return 1
DRC22409742014-10-23 18:54:42 +000056instead of -1 if componentID was > 0 and subsamp was TJSAMP_GRAY.
57
DRC8f7f49a2015-01-12 08:36:37 +000058[3] Fixed an issue in tjBufSizeYUV2() whereby it would erroneously return 0
DRC55620c62014-10-23 19:08:14 +000059instead of -1 if width was < 1.
60
DRC803b5d22014-11-18 15:56:43 +000061[5] The Huffman encoder now uses clz and bsr instructions for bit counting on
62ARM64 platforms (see 1.4 beta1 [5].)
63
DRC3ebcf7c2014-11-18 21:45:34 +000064[6] The close() method in the TJCompressor and TJDecompressor Java classes is
65now idempotent. Previously, that method would call the native tjDestroy()
66function even if the TurboJPEG instance had already been destroyed. This
67caused an exception to be thrown during finalization, if the close() method had
68already been called. The exception was caught, but it was still an expensive
69operation.
70
DRCea1eea42014-11-19 00:55:28 +000071[7] The TurboJPEG API previously generated an error ("Could not determine
72subsampling type for JPEG image") when attempting to decompress grayscale JPEG
73images that were compressed with a sampling factor other than 1 (for instance,
74with 'cjpeg -grayscale -sample 2x2'). Subsampling technically has no meaning
75with grayscale JPEGs, and thus the horizontal and vertical sampling factors
76for such images are ignored by the decompressor. However, the TurboJPEG API
77was being too rigid and was expecting the sampling factors to be equal to 1
78before it treated the image as a grayscale JPEG.
79
DRC9665f5e2014-11-22 04:04:38 +000080[8] cjpeg, djpeg, and jpegtran now accept an argument of -version, which will
81print the library version and exit.
82
DRC402a7152014-11-22 22:09:30 +000083[9] Referring to 1.4 beta1 [15], another extremely rare circumstance was
84discovered under which the Huffman encoder's local buffer can be overrun
85when a buffered destination manager is being used and an
86extremely-high-frequency block (basically junk image data) is being encoded.
87Even though the Huffman local buffer was increased from 128 bytes to 136 bytes
88to address the previous issue, the new issue caused even the larger buffer to
89be overrun. Further analysis reveals that, in the absolute worst case (such as
90setting alternating AC coefficients to 32767 and -32768 in the JPEG scanning
91order), the Huffman encoder can produce encoded blocks that approach double the
92size of the unencoded blocks. Thus, the Huffman local buffer was increased to
93256 bytes, which should prevent any such issue from re-occurring in the future.
94
DRC0f4469c2014-11-22 23:56:26 +000095[10] The new tjPlaneSizeYUV(), tjPlaneWidth(), and tjPlaneHeight() functions
96were not actually usable on any platform except OS X and Windows, because
97those functions were not included in the libturbojpeg mapfile. This has been
98fixed.
99
DRC2a6b8312014-11-25 10:07:43 +0000100[11] Restored the JPP(), JMETHOD(), and FAR macros in the libjpeg-turbo header
101files. The JPP() and JMETHOD() macros were originally implemented in libjpeg
102as a way of supporting non-ANSI compilers that lacked support for prototype
103parameters. libjpeg-turbo has never supported such compilers, but some
104software packages still use the macros to define their own prototypes.
105Similarly, libjpeg-turbo has never supported MS-DOS and other platforms that
106have far symbols, but some software packages still use the FAR macro. A pretty
DRCe2dd3e32014-11-25 09:48:15 +0000107good argument can be made that this is a bad practice on the part of the
108software in question, but since this affects more than one package, it's just
109easier to fix it here.
110
DRCd51e6c22014-12-19 18:18:46 +0000111[12] Fixed issues that were preventing the ARM 64-bit SIMD code from compiling
112for iOS, and included an ARMv8 architecture in all of the binaries installed by
113the "official" libjpeg-turbo SDK for OS X.
114
DRCeb8d0962014-08-30 13:52:09 +0000115
DRCfe77fa22014-08-30 13:48:45 +00001161.3.90 (1.4 beta1)
117==================
DRCf610d612013-04-26 10:33:29 +0000118
DRCfc26b652014-03-16 22:56:26 +0000119[1] New features in the TurboJPEG API:
120-- YUV planar images can now be generated with an arbitrary line padding
121(previously only 4-byte padding, which was compatible with X Video, was
122supported.)
123-- The decompress-to-YUV function has been extended to support image scaling.
124-- JPEG images can now be compressed from YUV planar source images.
125-- YUV planar images can now be decoded into RGB or grayscale images.
126-- 4:1:1 subsampling is now supported. This is mainly included for
127compatibility, since 4:1:1 is not fully accelerated in libjpeg-turbo and has no
128significant advantages relative to 4:2:0.
129-- CMYK images are now supported. This feature allows CMYK source images to be
130compressed to YCCK JPEGs and YCCK or CMYK JPEGs to be decompressed to CMYK
DRCf6d7b772014-08-20 16:02:49 +0000131destination images. Conversion between CMYK/YCCK and RGB or YUV images is not
132supported. Such conversion requires a color management system and is thus out
133of scope for a codec library.
DRCfc26b652014-03-16 22:56:26 +0000134-- The handling of YUV images in the Java API has been significantly refactored
135and should now be much more intuitive.
136-- The Java API now supports encoding a YUV image from an arbitrary position in
137a large image buffer.
DRCaecea382014-08-11 18:05:41 +0000138-- All of the YUV functions now have a corresponding function that operates on
139separate image planes instead of a unified image buffer. This allows for
DRCf6d7b772014-08-20 16:02:49 +0000140compressing/decoding from or decompressing/encoding to a subregion of a larger
141YUV image. It also allows for handling YUV formats that swap the order of the
142U and V planes.
DRCf610d612013-04-26 10:33:29 +0000143
DRCa6b7fbd2013-09-30 18:13:27 +0000144[2] Added SIMD acceleration for DSPr2-capable MIPS platforms. This speeds up
DRCd64e23e2013-10-08 02:32:07 +0000145the compression of full-color JPEGs by 70-80% on such platforms and
146decompression by 25-35%.
DRC0be9fa52013-07-24 21:50:20 +0000147
DRCfc26b652014-03-16 22:56:26 +0000148[3] If an application attempts to decompress a Huffman-coded JPEG image whose
DRCa1135062014-01-31 17:22:15 +0000149header does not contain Huffman tables, libjpeg-turbo will now insert the
150default Huffman tables. In order to save space, many motion JPEG video frames
151are encoded without the default Huffman tables, so these frames can now be
152successfully decompressed by libjpeg-turbo without additional work on the part
153of the application. An application can still override the Huffman tables, for
154instance to re-use tables from a previous frame of the same video.
155
DRCb1068fa2014-03-23 17:53:07 +0000156[4] The Mac packaging system now uses pkgbuild and productbuild rather than
157PackageMaker (which is obsolete and no longer supported.) This means that
158OS X 10.6 "Snow Leopard" or later must be used when packaging libjpeg-turbo,
159although the packages produced can be installed on OS X 10.5 "Leopard" or
160later. OS X 10.4 "Tiger" is no longer supported.
161
DRC0cfc4c12014-03-28 18:33:25 +0000162[5] The Huffman encoder now uses clz and bsr instructions for bit counting on
163ARM platforms rather than a lookup table. This reduces the memory footprint
164by 64k, which may be important for some mobile applications. Out of four
DRCfdd625e2014-04-15 03:07:44 +0000165Android devices that were tested, two demonstrated a small overall performance
166loss (~3-4% on average) with ARMv6 code and a small gain (also ~3-4%) with
167ARMv7 code when enabling this new feature, but the other two devices
168demonstrated a significant overall performance gain with both ARMv6 and ARMv7
DRCf6d7b772014-08-20 16:02:49 +0000169code (~10-20%) when enabling the feature. Actual mileage may vary.
DRC0cfc4c12014-03-28 18:33:25 +0000170
DRC0816d082014-04-20 06:57:52 +0000171[6] Worked around an issue with Visual C++ 2010 and later that caused incorrect
DRCbeb0b332014-04-20 07:36:33 +0000172pixels to be generated when decompressing a JPEG image to a 256-color bitmap,
173if compiler optimization was enabled when libjpeg-turbo was built. This caused
174the regression tests to fail when doing a release build under Visual C++ 2010
175and later.
176
DRC715bb412014-05-11 10:09:07 +0000177[7] Improved the accuracy and performance of the non-SIMD implementation of the
178floating point inverse DCT (using code borrowed from libjpeg v8a and later.)
179The accuracy of this implementation now matches the accuracy of the SSE/SSE2
180implementation. Note, however, that the floating point DCT/IDCT algorithms are
181mainly a legacy feature. They generally do not produce significantly better
182accuracy than the slow integer DCT/IDCT algorithms, and they are quite a bit
183slower.
184
DRC78df2e62014-05-12 09:23:57 +0000185[8] Added a new output colorspace (JCS_RGB565) to the libjpeg API that allows
DRCd729f4d2014-08-23 15:47:51 +0000186for decompressing JPEG images into RGB565 (16-bit) pixels. If dithering is not
187used, then this code path is SIMD-accelerated on ARM platforms.
DRC78df2e62014-05-12 09:23:57 +0000188
DRCf6d7b772014-08-20 16:02:49 +0000189[9] Numerous obsolete features, such as support for non-ANSI compilers and
190support for the MS-DOS memory model, were removed from the libjpeg code,
191greatly improving its readability and making it easier to maintain and extend.
DRC5033f3e2014-05-18 18:33:44 +0000192
DRCcf55f0b2014-05-28 20:19:54 +0000193[10] Fixed a segfault that occurred when calling output_message() with msg_code
194set to JMSG_COPYRIGHT.
195
DRCb7d6e842014-06-22 20:36:50 +0000196[11] Fixed an issue whereby wrjpgcom was allowing comments longer than 65k
197characters to be passed on the command line, which was causing it to generate
198incorrect JPEG files.
199
DRC73821bf2014-06-22 20:46:48 +0000200[12] Fixed a bug in the build system that was causing the Windows version of
DRCf6d7b772014-08-20 16:02:49 +0000201wrjpgcom to be built using the rdjpgcom source code.
DRCb7d6e842014-06-22 20:36:50 +0000202
DRCaee4f722014-08-09 23:06:07 +0000203[13] Restored 12-bit-per-component JPEG support. A 12-bit version of
204libjpeg-turbo can now be built by passing an argument of --with-12bit to
205configure (Unix) or -DWITH_12BIT=1 to cmake (Windows.) 12-bit JPEG support is
206included only for convenience. Enabling this feature disables all of the
207performance features in libjpeg-turbo, as well as arithmetic coding and the
DRCf6d7b772014-08-20 16:02:49 +0000208TurboJPEG API. The resulting library still contains the other libjpeg-turbo
209features (such as the colorspace extensions), but in general, it performs no
210faster than libjpeg v6b.
DRCaee4f722014-08-09 23:06:07 +0000211
DRCbc3c1682014-08-20 15:40:43 +0000212[14] Added ARM 64-bit SIMD acceleration for the YCC-to-RGB color conversion
213and IDCT algorithms (both are used during JPEG decompression.) For unknown
214reasons (probably related to clang), this code cannot currently be compiled for
215iOS.
216
DRC2261e1e2014-08-21 03:40:37 +0000217[15] Fixed an extremely rare bug that could cause the Huffman encoder's local
DRCeddc3552014-08-21 03:38:14 +0000218buffer to overrun when a very high-frequency MCU is compressed using quality
219100 and no subsampling, and when the JPEG output buffer is being dynamically
220resized by the destination manager. This issue was so rare that, even with a
221test program specifically designed to make the bug occur (by injecting random
222high-frequency YUV data into the compressor), it was reproducible only once in
223about every 25 million iterations.
224
DRCfe80ec22014-08-21 15:51:47 +0000225[16] Fixed an oversight in the TurboJPEG C wrapper: if any of the JPEG
226compression functions was called repeatedly with the same
227automatically-allocated destination buffer, then TurboJPEG would erroneously
228assume that the jpegSize parameter was equal to the size of the buffer, when in
229fact that parameter was probably equal to the size of the most recently
230compressed JPEG image. If the size of the previous JPEG image was not as large
231as the current JPEG image, then TurboJPEG would unnecessarily reallocate the
232destination buffer.
233
DRCf610d612013-04-26 10:33:29 +0000234
DRC96573d02013-08-11 23:23:41 +00002351.3.1
236=====
237
238[1] On Un*x systems, 'make install' now installs the libjpeg-turbo libraries
239into /opt/libjpeg-turbo/lib32 by default on any 32-bit system, not just x86,
240and into /opt/libjpeg-turbo/lib64 by default on any 64-bit system, not just
241x86-64. You can override this by overriding either the 'prefix' or 'libdir'
242configure variables.
243
DRC4d877932013-09-19 22:55:57 +0000244[2] The Windows installer now places a copy of the TurboJPEG DLLs in the same
245directory as the rest of the libjpeg-turbo binaries. This was mainly done
246to support TurboVNC 1.3, which bundles the DLLs in its Windows installation.
247When using a 32-bit version of CMake on 64-bit Windows, it is impossible to
248access the c:\WINDOWS\system32 directory, which made it impossible for the
249TurboVNC build scripts to bundle the 64-bit TurboJPEG DLL.
250
DRCcadabd42013-09-28 03:10:31 +0000251[3] Fixed a bug whereby attempting to encode a progressive JPEG with arithmetic
252entropy coding (by passing arguments of -progressive -arithmetic to cjpeg or
253jpegtran, for instance) would result in an error, "Requested feature was
254omitted at compile time".
DRC1370f102013-09-24 03:21:38 +0000255
DRC7ebf2942013-11-21 18:32:48 +0000256[4] Fixed a couple of issues whereby malformed JPEG images would cause
DRC43d8cf42013-11-21 18:34:39 +0000257libjpeg-turbo to use uninitialized memory during decompression.
258
DRC38c99702014-02-11 09:45:18 +0000259[5] Fixed an error ("Buffer passed to JPEG library is too small") that occurred
260when calling the TurboJPEG YUV encoding function with a very small (< 5x5)
261source image, and added a unit test to check for this error.
262
DRCd45c5492014-03-11 06:21:46 +0000263[6] The Java classes should now build properly under Visual Studio 2010 and
264later.
265
DRCde23dd82014-03-22 20:43:03 +0000266[7] Fixed an issue that prevented SRPMs generated using the in-tree packaging
267tools from being rebuilt on certain newer Linux distributions.
268
269[8] Numerous minor fixes to eliminate compilation and build/packaging system
270warnings, fix cosmetic issues, improve documentation clarity, and other general
271source cleanup.
272
DRC96573d02013-08-11 23:23:41 +0000273
DRC0bf58f22013-02-06 23:51:08 +00002741.3.0
275=====
276
277[1] 'make test' now works properly on FreeBSD, and it no longer requires the
278md5sum executable to be present on other Un*x platforms.
279
DRCd7a642b2013-04-24 06:40:25 +0000280[2] Overhauled the packaging system:
DRC764e1e22013-04-19 04:25:14 +0000281-- To avoid conflict with vendor-supplied libjpeg-turbo packages, the
282official RPMs and DEBs for libjpeg-turbo have been renamed to
DRCd7a642b2013-04-24 06:40:25 +0000283"libjpeg-turbo-official".
284-- The TurboJPEG libraries are now located under /opt/libjpeg-turbo in the
285official Linux and Mac packages, to avoid conflict with vendor-supplied
286packages and also to streamline the packaging system.
287-- Release packages are now created with the directory structure defined
288by the configure variables "prefix", "bindir", "libdir", etc. (Un*x) or by the
289CMAKE_INSTALL_PREFIX variable (Windows.) The exception is that the docs are
290always located under the system default documentation directory on Un*x and Mac
291systems, and on Windows, the TurboJPEG DLL is always located in the Windows
292system directory.
DRC764e1e22013-04-19 04:25:14 +0000293-- To avoid confusion, official libjpeg-turbo packages on Linux/Unix platforms
294(except for Mac) will always install the 32-bit libraries in
295/opt/libjpeg-turbo/lib32 and the 64-bit libraries in /opt/libjpeg-turbo/lib64.
DRCd7a642b2013-04-24 06:40:25 +0000296-- Fixed an issue whereby, in some cases, the libjpeg-turbo executables on Un*x
297systems were not properly linking with the shared libraries installed by the
298same package.
299-- Fixed an issue whereby building the "installer" target on Windows when
300WITH_JAVA=1 would fail if the TurboJPEG JAR had not been previously built.
301-- Building the "install" target on Windows now installs files into the same
302places that the installer does.
DRC764e1e22013-04-19 04:25:14 +0000303
DRC4c17a452013-04-25 08:55:31 +0000304[3] Fixed a Huffman encoder bug that prevented I/O suspension from working
305properly.
306
DRC0bf58f22013-02-06 23:51:08 +0000307
DRC84f71222012-12-31 09:44:31 +00003081.2.90 (1.3 beta1)
309==================
DRC27fb3fc2012-01-28 01:48:07 +0000310
311[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 +000031211/8, 3/2, 13/8, 7/4, 15/8, and 2) when decompressing. Note that the IDCT will
313not be SIMD-accelerated when using any of these new scaling factors.
DRC27fb3fc2012-01-28 01:48:07 +0000314
DRC575317b2012-06-15 22:00:47 +0000315[2] The TurboJPEG dynamic library is now versioned. It was not strictly
DRCfd407772012-03-23 03:24:39 +0000316necessary to do so, because TurboJPEG uses versioned symbols, and if a function
317changes in an ABI-incompatible way, that function is renamed and a legacy
318function is provided to maintain backward compatibility. However, certain
DRC5a84a0e2013-02-14 07:31:35 +0000319Linux distro maintainers have a policy against accepting any library that isn't
320versioned.
DRCfd407772012-03-23 03:24:39 +0000321
DRCfac3bea2012-09-24 02:27:55 +0000322[3] Extended the TurboJPEG Java API so that it can be used to compress a JPEG
323image from and decompress a JPEG image to an arbitrary position in a large
324image buffer.
DRC575317b2012-06-15 22:00:47 +0000325
DRC21868092012-07-03 20:02:49 +0000326[4] The tjDecompressToYUV() function now supports the TJFLAG_FASTDCT flag.
DRCe0419b52012-07-03 20:01:31 +0000327
DRCa394bf72012-08-07 18:44:24 +0000328[5] The 32-bit supplementary package for amd64 Debian systems now provides
DRC0a0f8d12012-08-07 18:42:07 +0000329symlinks in /usr/lib/i386-linux-gnu for the TurboJPEG libraries in /usr/lib32.
330This allows those libraries to be used on MultiArch-compatible systems (such as
331Ubuntu 11 and later) without setting the linker path.
332
DRC61e13412012-08-24 02:44:39 +0000333[6] The TurboJPEG Java wrapper should now find the JNI library on Mac systems
334without having to pass -Djava.library.path=/usr/lib to java.
335
DRCd9d1d672012-10-02 04:20:43 +0000336[7] TJBench has been ported to Java to provide a convenient way of validating
337the performance of the TurboJPEG Java API. It can be run with
338'java -cp turbojpeg.jar TJBench'.
339
DRCf73a27c2013-01-01 10:25:43 +0000340[8] cjpeg can now be used to generate JPEG files with the RGB colorspace
341(feature ported from jpeg-8d.)
342
DRC8cbf8932013-01-01 10:44:00 +0000343[9] The width and height in the -crop argument passed to jpegtran can now be
344suffixed with "f" to indicate that, when the upper left corner of the cropping
345region is automatically moved to the nearest iMCU boundary, the bottom right
346corner should be moved by the same amount. In other words, this feature causes
347jpegtran to strictly honor the specified width/height rather than the specified
348bottom right corner (feature ported from jpeg-8d.)
349
DRCf37e4da2013-01-01 10:52:29 +0000350[10] JPEG files using the RGB colorspace can now be decompressed into grayscale
351images (feature ported from jpeg-8d.)
352
DRC00c2cf32013-01-13 12:12:53 +0000353[11] Fixed a regression caused by 1.2.1[7] whereby the build would fail with
DRCb87a0b42013-01-13 12:15:58 +0000354multiple "Mismatch in operand sizes" errors when attempting to build the x86
355SIMD code with NASM 0.98.
356
DRCab706232013-01-18 23:42:31 +0000357[12] The in-memory source/destination managers (jpeg_mem_src() and
358jpeg_mem_dest()) are now included by default when building libjpeg-turbo with
359libjpeg v6b or v7 emulation, so that programs can take advantage of these
360functions without requiring the use of the backward-incompatible libjpeg v8
361ABI. The "age number" of the libjpeg-turbo library on Un*x systems has been
362incremented by 1 to reflect this. You can disable this feature with a
363configure/CMake switch in order to retain strict API/ABI compatibility with the
364libjpeg v6b or v7 API/ABI (or with previous versions of libjpeg-turbo.) See
365README-turbo.txt for more details.
366
DRC6e6b28c2014-12-19 17:34:30 +0000367[13] Added ARMv7s architecture to libjpeg.a and libturbojpeg.a in the official
DRCa2a2cd62013-02-04 22:29:57 +0000368libjpeg-turbo binary package for OS X, so that those libraries can be used to
369build applications that leverage the faster CPUs in the iPhone 5 and iPad 4.
370
DRC575317b2012-06-15 22:00:47 +0000371
3721.2.1
373=====
374
375[1] Creating or decoding a JPEG file that uses the RGB colorspace should now
376properly work when the input or output colorspace is one of the libjpeg-turbo
377colorspace extensions.
378
379[2] When libjpeg-turbo was built without SIMD support and merged (non-fancy)
380upsampling was used along with an alpha-enabled colorspace during
381decompression, the unused byte of the decompressed pixels was not being set to
3820xFF. This has been fixed. TJUnitTest has also been extended to test for the
383correct behavior of the colorspace extensions when merged upsampling is used.
384
385[3] Fixed a bug whereby the libjpeg-turbo SSE2 SIMD code would not preserve the
DRC4f240162012-04-26 19:50:37 +0000386upper 64 bits of xmm6 and xmm7 on Win64 platforms, which violated the Win64
387calling conventions.
388
DRC575317b2012-06-15 22:00:47 +0000389[4] Fixed a regression caused by 1.2.0[6] whereby decompressing corrupt JPEG
DRCdd2b6512012-05-30 20:36:42 +0000390images (specifically, images in which the component count was erroneously set
391to a large value) would cause libjpeg-turbo to segfault.
392
DRC575317b2012-06-15 22:00:47 +0000393[5] Worked around a severe performance issue with "Bobcat" (AMD Embedded APU)
DRC69799272012-06-13 01:21:29 +0000394processors. The MASKMOVDQU instruction, which was used by the libjpeg-turbo
395SSE2 SIMD code, is apparently implemented in microcode on AMD processors, and
396it is painfully slow on Bobcat processors in particular. Eliminating the use
397of this instruction improved performance by an order of magnitude on Bobcat
398processors and by a small amount (typically 5%) on AMD desktop processors.
399
DRC575317b2012-06-15 22:00:47 +0000400[6] Added SIMD acceleration for performing 4:2:2 upsampling on NEON-capable ARM
401platforms. This speeds up the decompression of 4:2:2 JPEGs by 20-25% on such
402platforms.
403
DRCde37e072012-06-18 00:08:18 +0000404[7] Fixed a regression caused by 1.2.0[2] whereby, on Linux/x86 platforms
405running the 32-bit SSE2 SIMD code in libjpeg-turbo, decompressing a 4:2:0 or
4064:2:2 JPEG image into a 32-bit (RGBX, BGRX, etc.) buffer without using fancy
407upsampling would produce several incorrect columns of pixels at the right-hand
408side of the output image if each row in the output image was not evenly
409divisible by 16 bytes.
DRC8126d0c2012-06-15 21:54:45 +0000410
DRC112a0bb2012-06-28 23:25:34 +0000411[8] Fixed an issue whereby attempting to build the SIMD extensions with Xcode
4124.3 on OS X platforms would cause NASM to return numerous errors of the form
413"'%define' expects a macro identifier".
414
DRC73d74c12012-06-29 23:46:38 +0000415[9] Added flags to the TurboJPEG API that allow the caller to force the use of
416either the fast or the accurate DCT/IDCT algorithms in the underlying codec.
417
DRC27fb3fc2012-01-28 01:48:07 +0000418
DRC1ca924a2011-11-29 08:58:27 +00004191.2.0
420=====
421
422[1] Fixed build issue with YASM on Unix systems (the libjpeg-turbo build system
423was not adding the current directory to the assembler include path, so YASM
424was not able to find jsimdcfg.inc.)
425
DRCebfe9e42011-12-01 10:58:36 +0000426[2] Fixed out-of-bounds read in SSE2 SIMD code that occurred when decompressing
427a JPEG image to a bitmap buffer whose size was not a multiple of 16 bytes.
428This was more of an annoyance than an actual bug, since it did not cause any
429actual run-time problems, but the issue showed up when running libjpeg-turbo in
430valgrind. See http://crbug.com/72399 for more information.
431
DRCab64b622011-12-18 16:29:35 +0000432[3] Added a compile-time macro (LIBJPEG_TURBO_VERSION) that can be used to
433check the version of libjpeg-turbo against which an application was compiled.
434
DRC67ce3b22011-12-19 02:21:03 +0000435[4] Added new RGBA/BGRA/ABGR/ARGB colorspace extension constants (libjpeg API)
436and pixel formats (TurboJPEG API), which allow applications to specify that,
437when decompressing to a 4-component RGB buffer, the unused byte should be set
438to 0xFF so that it can be interpreted as an opaque alpha channel.
439
DRCa7466c92012-01-26 22:20:31 +0000440[5] Fixed regression issue whereby DevIL failed to build against libjpeg-turbo
441because libjpeg-turbo's distributed version of jconfig.h contained an INLINE
442macro, which conflicted with a similar macro in DevIL. This macro is used only
443internally when building libjpeg-turbo, so it was moved into config.h.
444
DRC12781cb2012-01-27 01:23:20 +0000445[6] libjpeg-turbo will now correctly decompress erroneous CMYK/YCCK JPEGs whose
446K component is assigned a component ID of 1 instead of 4. Although these files
447are in violation of the spec, other JPEG implementations handle them
448correctly.
449
DRC6e6b28c2014-12-19 17:34:30 +0000450[7] Added ARMv6 and ARMv7 architectures to libjpeg.a and libturbojpeg.a in
DRCa2a2cd62013-02-04 22:29:57 +0000451the official libjpeg-turbo binary package for OS X, so that those libraries can
452be used to build both OS X and iOS applications.
DRCc0526462012-02-10 01:44:55 +0000453
DRC1ca924a2011-11-29 08:58:27 +0000454
DRCf8e00552011-02-04 11:06:36 +00004551.1.90 (1.2 beta1)
456==================
457
DRC7bc3fb52011-10-28 06:45:53 +0000458[1] Added a Java wrapper for the TurboJPEG API. See java/README for more
459details.
DRCf8e00552011-02-04 11:06:36 +0000460
DRC7bc3fb52011-10-28 06:45:53 +0000461[2] The TurboJPEG API can now be used to scale down images during
462decompression.
DRCa3c30592011-02-07 08:06:16 +0000463
DRC15866ac2011-03-04 13:46:55 +0000464[3] Added SIMD routines for RGB-to-grayscale color conversion, which
465significantly improves the performance of grayscale JPEG compression from an
466RGB source image.
467
DRC3c21b082011-10-28 06:25:13 +0000468[4] Improved the performance of the C color conversion routines, which are used
469on platforms for which SIMD acceleration is not available.
DRC15866ac2011-03-04 13:46:55 +0000470
DRC3c21b082011-10-28 06:25:13 +0000471[5] Added a function to the TurboJPEG API that performs lossless transforms.
472This function is implemented using the same back end as jpegtran, but it
473performs transcoding entirely in memory and allows multiple transforms and/or
474crop operations to be batched together, so the source coefficients only need to
475be read once. This is useful when generating image tiles from a single source
476JPEG.
DRC15866ac2011-03-04 13:46:55 +0000477
DRC3c21b082011-10-28 06:25:13 +0000478[6] Added tests for the new TurboJPEG scaled decompression and lossless
DRC77fee432011-11-01 17:14:22 +0000479transform features to tjbench (the TurboJPEG benchmark, formerly called
480"jpgtest".)
DRC15866ac2011-03-04 13:46:55 +0000481
482[7] Added support for 4:4:0 (transposed 4:2:2) subsampling in TurboJPEG, which
483was necessary in order for it to read 4:2:2 JPEG files that had been losslessly
484transposed or rotated 90 degrees.
485
DRC67d1fc12011-05-24 14:13:01 +0000486[8] All legacy VirtualGL code has been re-factored, and this has allowed
487libjpeg-turbo, in its entirety, to be re-licensed under a BSD-style license.
DRCee269922011-04-26 23:46:38 +0000488
DRCf89dd1e2011-05-21 14:23:30 +0000489[9] libjpeg-turbo can now be built with YASM.
DRC56fb2372011-05-03 06:32:41 +0000490
DRCe5c6eb52011-08-17 20:59:56 +0000491[10] Added SIMD acceleration for ARM Linux and iOS platforms that support
492NEON instructions.
DRC321e0682011-05-03 08:47:43 +0000493
DRC3c21b082011-10-28 06:25:13 +0000494[11] Refactored the TurboJPEG C API and documented it using Doxygen. The
495TurboJPEG 1.2 API uses pixel formats to define the size and component order of
496the uncompressed source/destination images, and it includes a more efficient
497version of TJBUFSIZE() that computes a worst-case JPEG size based on the level
DRC5039d732013-01-21 23:42:12 +0000498of chrominance subsampling. The refactored implementation of the TurboJPEG API
DRC3c21b082011-10-28 06:25:13 +0000499now uses the libjpeg memory source and destination managers, which allows the
500TurboJPEG compressor to grow the JPEG buffer as necessary.
DRC9b28def2011-05-21 14:37:15 +0000501
DRCe9f9ec42011-05-25 06:02:50 +0000502[12] Eliminated errors in the output of jpegtran on Windows that occurred when
DRC7e3fd2f2011-05-25 06:04:43 +0000503the application was invoked using I/O redirection
504(jpegtran <input.jpg >output.jpg).
505
DRCb8c6ee32011-05-31 20:22:37 +0000506[13] The inclusion of libjpeg v7 and v8 emulation as well as arithmetic coding
DRC0571e172011-05-31 20:17:16 +0000507support in libjpeg-turbo v1.1.0 introduced several new error constants in
508jerror.h, and these were mistakenly enabled for all emulation modes, causing
DRCfa9ff8e2011-06-21 06:17:10 +0000509the error enum in libjpeg-turbo to sometimes have different values than the
510same enum in libjpeg. This represents an ABI incompatibility, and it caused
511problems with rare applications that took specific action based on a particular
512error value. The fix was to include the new error constants conditionally
513based on whether libjpeg v7 or v8 emulation was enabled.
DRC0571e172011-05-31 20:17:16 +0000514
DRCeed08612011-06-21 04:56:02 +0000515[14] Fixed an issue whereby Windows applications that used libjpeg-turbo would
DRCb7120ca2011-06-21 04:57:32 +0000516fail to compile if the Windows system headers were included before jpeglib.h.
517This issue was caused by a conflict in the definition of the INT32 type.
DRC6ca69532011-02-18 03:31:11 +0000518
DRC3c21b082011-10-28 06:25:13 +0000519[15] Fixed 32-bit supplementary package for amd64 Debian systems, which was
DRC68a086a2011-07-19 09:26:23 +0000520broken by enhancements to the packaging system in 1.1.
521
DRC3c21b082011-10-28 06:25:13 +0000522[16] When decompressing a JPEG image using an output colorspace of
DRCc08e8c12011-09-08 23:54:40 +0000523JCS_EXT_RGBX, JCS_EXT_BGRX, JCS_EXT_XBGR, or JCS_EXT_XRGB, libjpeg-turbo will
524now set the unused byte to 0xFF, which allows applications to interpret that
525byte as an alpha channel (0xFF = opaque).
526
DRCf8e00552011-02-04 11:06:36 +0000527
DRC6ee54592011-03-01 08:18:30 +00005281.1.1
529=====
530
531[1] Fixed a 1-pixel error in row 0, column 21 of the luminance plane generated
532by tjEncodeYUV().
533
DRC8071c392011-04-17 15:29:17 +0000534[2] libjpeg-turbo's accelerated Huffman decoder previously ignored unexpected
535markers found in the middle of the JPEG data stream during decompression. It
536will now hand off decoding of a particular block to the unaccelerated Huffman
537decoder if an unexpected marker is found, so that the unaccelerated Huffman
538decoder can generate an appropriate warning.
DRC6ee54592011-03-01 08:18:30 +0000539
DRC47aaf6f2011-03-22 05:40:39 +0000540[3] Older versions of MinGW64 prefixed symbol names with underscores by
DRC1da78582011-03-22 09:34:01 +0000541default, which differed from the behavior of 64-bit Visual C++. MinGW64 1.0
542has adopted the behavior of 64-bit Visual C++ as the default, so to accommodate
543this, the libjpeg-turbo SIMD function names are no longer prefixed with an
544underscore when building with MinGW64. This means that, when building
545libjpeg-turbo with older versions of MinGW64, you will now have to add
546-fno-leading-underscore to the CFLAGS.
547
DRCd8840112011-04-25 22:46:25 +0000548[4] Fixed a regression bug in the NSIS script that caused the Windows installer
549build to fail when using the Visual Studio IDE.
550
551[5] Fixed a bug in jpeg_read_coefficients() whereby it would not initialize
552cinfo->image_width and cinfo->image_height if libjpeg v7 or v8 emulation was
553enabled. This specifically caused the jpegoptim program to fail if it was
554linked against a version of libjpeg-turbo that was built with libjpeg v7 or v8
555emulation.
556
DRC049aef52011-04-25 22:41:14 +0000557[6] Eliminated excessive I/O overhead that occurred when reading BMP files in
558cjpeg.
559
DRC5ee81f42011-05-02 00:35:50 +0000560[7] Eliminated errors in the output of cjpeg on Windows that occurred when the
DRC34a8e352011-05-10 22:14:38 +0000561application was invoked using I/O redirection (cjpeg <inputfile >output.jpg).
DRC5ee81f42011-05-02 00:35:50 +0000562
DRCf5c3bb32011-03-18 05:59:07 +0000563
DRC958b2c02011-01-28 08:00:40 +00005641.1.0
565=====
DRCfa1d1832011-01-26 05:35:20 +0000566
DRCa49c4e52011-02-18 20:50:08 +0000567[1] The algorithm used by the SIMD quantization function cannot produce correct
568results when the JPEG quality is >= 98 and the fast integer forward DCT is
569used. Thus, the non-SIMD quantization function is now used for those cases,
570and libjpeg-turbo should now produce identical output to libjpeg v6b in all
571cases.
DRCe1716b82011-02-18 03:19:43 +0000572
DRCa49c4e52011-02-18 20:50:08 +0000573[2] Despite the above, the fast integer forward DCT still degrades somewhat for
DRC5039d732013-01-21 23:42:12 +0000574JPEG qualities greater than 95, so the TurboJPEG wrapper will now automatically
575use the slow integer forward DCT when generating JPEG images of quality 96 or
576greater. This reduces compression performance by as much as 15% for these
577high-quality images but is necessary to ensure that the images are perceptually
578lossless. It also ensures that the library can avoid the performance pitfall
579created by [1].
DRCa49c4e52011-02-18 20:50:08 +0000580
581[3] Ported jpgtest.cxx to pure C to avoid the need for a C++ compiler.
582
583[4] Fixed visual artifacts in grayscale JPEG compression caused by a typo in
DRCd9ee65c2011-04-05 07:01:26 +0000584the RGB-to-luminance lookup tables.
DRC8ed7b812011-02-15 08:31:34 +0000585
DRC240d82f2011-02-19 00:00:34 +0000586[5] The Windows distribution packages now include the libjpeg run-time programs
587(cjpeg, etc.)
588
DRC9cd2c422011-02-19 17:52:45 +0000589[6] All packages now include jpgtest.
DRC240d82f2011-02-19 00:00:34 +0000590
DRCe4d9b5b2011-02-25 06:17:17 +0000591[7] The TurboJPEG dynamic library now uses versioned symbols.
592
593[8] Added two new TurboJPEG API functions, tjEncodeYUV() and
594tjDecompressToYUV(), to replace the somewhat hackish TJ_YUV flag.
595
DRC2d94e262011-01-25 06:52:31 +0000596
DRC958b2c02011-01-28 08:00:40 +00005971.0.90 (1.1 beta1)
598==================
DRC766dc5c2010-10-12 02:50:18 +0000599
DRCf38eee02011-02-18 07:00:38 +0000600[1] Added emulation of the libjpeg v7 and v8 APIs and ABIs. See
DRCefa618e2010-10-18 08:41:11 +0000601README-turbo.txt for more details. This feature was sponsored by CamTrace SAS.
602
603[2] Created a new CMake-based build system for the Visual C++ and MinGW builds.
DRC766dc5c2010-10-12 02:50:18 +0000604
DRC2c62da32012-01-17 22:55:03 +0000605[3] Grayscale bitmaps can now be compressed from/decompressed to using the
606TurboJPEG API.
DRC09854f52010-11-04 22:39:59 +0000607
DRC01e69092011-01-06 01:19:43 +0000608[4] jpgtest can now be used to test decompression performance with existing
609JPEG images.
DRCe89bbae2010-11-12 10:18:08 +0000610
DRCd1c281a2010-11-17 22:44:40 +0000611[5] If the default install prefix (/opt/libjpeg-turbo) is used, then
612'make install' now creates /opt/libjpeg-turbo/lib32 and
613/opt/libjpeg-turbo/lib64 sym links to duplicate the behavior of the binary
614packages.
615
DRCec311932010-11-22 19:51:42 +0000616[6] All symbols in the libjpeg-turbo dynamic library are now versioned, even
617when the library is built with libjpeg v6b emulation.
618
DRC01e69092011-01-06 01:19:43 +0000619[7] Added arithmetic encoding and decoding support (can be disabled with
DRC245cfdf2010-11-23 17:11:06 +0000620configure or CMake options)
DRC66f97e62010-11-23 05:49:54 +0000621
DRC2c62da32012-01-17 22:55:03 +0000622[8] Added a TJ_YUV flag to the TurboJPEG API, which causes both the compressor
623and decompressor to output planar YUV images.
DRCfbb67472010-11-24 04:02:37 +0000624
DRC2c62da32012-01-17 22:55:03 +0000625[9] Added an extended version of tjDecompressHeader() to the TurboJPEG API,
626which allows the caller to determine the type of subsampling used in a JPEG
627image.
DRC50c657b2010-12-14 01:23:16 +0000628
DRC958b2c02011-01-28 08:00:40 +0000629[10] Added further protections against invalid Huffman codes.
DRCfa1d1832011-01-26 05:35:20 +0000630
DRC766dc5c2010-10-12 02:50:18 +0000631
DRC958b2c02011-01-28 08:00:40 +00006321.0.1
633=====
DRC0fbb28e2010-07-30 17:15:52 +0000634
635[1] The Huffman decoder will now handle erroneous Huffman codes (for instance,
636from a corrupt JPEG image.) Previously, these would cause libjpeg-turbo to
637crash under certain circumstances.
638
DRC81a50f72012-01-17 22:56:22 +0000639[2] Fixed typo in SIMD dispatch routines that was causing 4:2:2 upsampling to
DRC025a2792010-08-07 16:27:56 +0000640be used instead of 4:2:0 when decompressing JPEG images using SSE2 code.
DRC30959712010-08-07 16:06:56 +0000641
DRCbdb12882010-08-21 21:14:17 +0000642[3] configure script will now automatically determine whether the
643INCOMPLETE_TYPES_BROKEN macro should be defined.
644
DRC0fbb28e2010-07-30 17:15:52 +0000645
DRC958b2c02011-01-28 08:00:40 +00006461.0.0
647=====
DRC49597872010-05-17 20:47:57 +0000648
DRCc773d102010-06-05 06:58:22 +0000649[1] 2983700: Further FreeBSD build tweaks (no longer necessary to specify
650--host when configuring on a 64-bit system)
DRC49597872010-05-17 20:47:57 +0000651
DRCd5e964c2013-01-10 11:47:39 +0000652[2] Created symlinks in the Unix/Linux packages so that the TurboJPEG
DRCf12c7db2010-05-18 19:04:47 +0000653include file can always be found in /opt/libjpeg-turbo/include, the 32-bit
654static libraries can always be found in /opt/libjpeg-turbo/lib32, and the
65564-bit static libraries can always be found in /opt/libjpeg-turbo/lib64.
656
DRC4bf3b582010-06-05 01:03:23 +0000657[3] The Unix/Linux distribution packages now include the libjpeg run-time
658programs (cjpeg, etc.) and man pages.
659
DRC81a50f72012-01-17 22:56:22 +0000660[4] Created a 32-bit supplementary package for amd64 Debian systems, which
DRC4bf3b582010-06-05 01:03:23 +0000661contains just the 32-bit libjpeg-turbo libraries.
662
663[5] Moved the libraries from */lib32 to */lib in the i386 Debian package.
664
DRCdf3337c2010-07-02 09:13:58 +0000665[6] Include distribution package for Cygwin
DRC4bf3b582010-06-05 01:03:23 +0000666
DRCdf3337c2010-07-02 09:13:58 +0000667[7] No longer necessary to specify --without-simd on non-x86 architectures, and
DRC38ccf852010-06-10 19:49:49 +0000668unit tests now work on those architectures.
669
DRC49597872010-05-17 20:47:57 +0000670
DRC958b2c02011-01-28 08:00:40 +00006710.0.93
672======
DRC0f413b22010-04-06 20:05:39 +0000673
DRCc773d102010-06-05 06:58:22 +0000674[1] 2982659, Fixed x86-64 build on FreeBSD systems
DRC0f413b22010-04-06 20:05:39 +0000675
DRCc773d102010-06-05 06:58:22 +0000676[2] 2988188: Added support for Windows 64-bit systems
DRC1a2219e2010-05-10 20:03:36 +0000677
DRC0f413b22010-04-06 20:05:39 +0000678
DRC958b2c02011-01-28 08:00:40 +00006790.0.91
680======
DRCae19bf62010-03-15 11:40:31 +0000681
682[1] Added documentation to .deb packages
683
684[2] 2968313: Fixed data corruption issues when decompressing large JPEG images
685and/or using buffered I/O with the libjpeg-turbo decompressor
DRC958b2c02011-01-28 08:00:40 +0000686
687
6880.0.90
689======
690
691Initial release