blob: e545606b6b333d34993533bc5a52d26e2205addf [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
DRC3ebcc322015-05-15 19:09:44 +000035[6] Performance has been improved significantly on 64-bit non-Linux and
36non-Windows platforms (generally 10-20% faster compression and 5-10% faster
37decompression.) Due to an oversight, the 64-bit version of the accelerated
38Huffman codec was not being compiled in when libjpeg-turbo was built on
39platforms other than Windows or Linux. Oops.
DRCf64b36f2015-04-22 08:43:04 +000040
DRCa8b6ea22015-05-06 22:41:12 +000041[7] Fixed an extremely rare bug in the Huffman encoder that caused 64-bit
42builds of libjpeg-turbo to incorrectly encode a few specific test images when
43quality=98, an optimized Huffman table, and the slow integer forward DCT were
44used.
45
DRCbec45b12015-05-17 15:56:18 +000046[8] The Windows (CMake) build system now supports building only static or only
DRC665c96e2015-05-15 22:08:21 +000047shared libraries. This is accomplished by adding either -DENABLE_STATIC=0 or
48-DENABLE_SHARED=0 to the CMake command line.
49
DRC1f79c7c2015-06-01 19:22:41 +000050[9] TurboJPEG API functions will now return an error code if a warning is
51triggered in the underlying libjpeg API. For instance, if a JPEG file is
52corrupt, the TurboJPEG decompression functions will attempt to decompress
53as much of the image as possible, but those functions will now return -1 to
54indicate that the decompression was not entirely successful.
55
DRCcbc99702015-01-16 06:29:52 +000056
DRCeb8d0962014-08-30 13:52:09 +0000571.4.0
DRCe0419b52012-07-03 20:01:31 +000058=====
59
DRCeb8d0962014-08-30 13:52:09 +000060[1] Fixed a build issue on OS X PowerPC platforms (md5cmp failed to build
61because OS X does not provide the le32toh() and htole32() functions.)
62
DRC72a3cc02014-08-30 20:37:50 +000063[2] The non-SIMD RGB565 color conversion code did not work correctly on big
64endian machines. This has been fixed.
65
DRC55620c62014-10-23 19:08:14 +000066[3] Fixed an issue in tjPlaneSizeYUV() whereby it would erroneously return 1
DRC22409742014-10-23 18:54:42 +000067instead of -1 if componentID was > 0 and subsamp was TJSAMP_GRAY.
68
DRC8f7f49a2015-01-12 08:36:37 +000069[3] Fixed an issue in tjBufSizeYUV2() whereby it would erroneously return 0
DRC55620c62014-10-23 19:08:14 +000070instead of -1 if width was < 1.
71
DRC803b5d22014-11-18 15:56:43 +000072[5] The Huffman encoder now uses clz and bsr instructions for bit counting on
73ARM64 platforms (see 1.4 beta1 [5].)
74
DRC3ebcf7c2014-11-18 21:45:34 +000075[6] The close() method in the TJCompressor and TJDecompressor Java classes is
76now idempotent. Previously, that method would call the native tjDestroy()
77function even if the TurboJPEG instance had already been destroyed. This
78caused an exception to be thrown during finalization, if the close() method had
79already been called. The exception was caught, but it was still an expensive
80operation.
81
DRCea1eea42014-11-19 00:55:28 +000082[7] The TurboJPEG API previously generated an error ("Could not determine
83subsampling type for JPEG image") when attempting to decompress grayscale JPEG
84images that were compressed with a sampling factor other than 1 (for instance,
85with 'cjpeg -grayscale -sample 2x2'). Subsampling technically has no meaning
86with grayscale JPEGs, and thus the horizontal and vertical sampling factors
87for such images are ignored by the decompressor. However, the TurboJPEG API
88was being too rigid and was expecting the sampling factors to be equal to 1
89before it treated the image as a grayscale JPEG.
90
DRC9665f5e2014-11-22 04:04:38 +000091[8] cjpeg, djpeg, and jpegtran now accept an argument of -version, which will
92print the library version and exit.
93
DRC402a7152014-11-22 22:09:30 +000094[9] Referring to 1.4 beta1 [15], another extremely rare circumstance was
95discovered under which the Huffman encoder's local buffer can be overrun
96when a buffered destination manager is being used and an
97extremely-high-frequency block (basically junk image data) is being encoded.
98Even though the Huffman local buffer was increased from 128 bytes to 136 bytes
99to address the previous issue, the new issue caused even the larger buffer to
100be overrun. Further analysis reveals that, in the absolute worst case (such as
101setting alternating AC coefficients to 32767 and -32768 in the JPEG scanning
102order), the Huffman encoder can produce encoded blocks that approach double the
103size of the unencoded blocks. Thus, the Huffman local buffer was increased to
104256 bytes, which should prevent any such issue from re-occurring in the future.
105
DRC0f4469c2014-11-22 23:56:26 +0000106[10] The new tjPlaneSizeYUV(), tjPlaneWidth(), and tjPlaneHeight() functions
107were not actually usable on any platform except OS X and Windows, because
108those functions were not included in the libturbojpeg mapfile. This has been
109fixed.
110
DRC2a6b8312014-11-25 10:07:43 +0000111[11] Restored the JPP(), JMETHOD(), and FAR macros in the libjpeg-turbo header
112files. The JPP() and JMETHOD() macros were originally implemented in libjpeg
113as a way of supporting non-ANSI compilers that lacked support for prototype
114parameters. libjpeg-turbo has never supported such compilers, but some
115software packages still use the macros to define their own prototypes.
116Similarly, libjpeg-turbo has never supported MS-DOS and other platforms that
117have far symbols, but some software packages still use the FAR macro. A pretty
DRCe2dd3e32014-11-25 09:48:15 +0000118good argument can be made that this is a bad practice on the part of the
119software in question, but since this affects more than one package, it's just
120easier to fix it here.
121
DRCd51e6c22014-12-19 18:18:46 +0000122[12] Fixed issues that were preventing the ARM 64-bit SIMD code from compiling
123for iOS, and included an ARMv8 architecture in all of the binaries installed by
124the "official" libjpeg-turbo SDK for OS X.
125
DRCeb8d0962014-08-30 13:52:09 +0000126
DRCfe77fa22014-08-30 13:48:45 +00001271.3.90 (1.4 beta1)
128==================
DRCf610d612013-04-26 10:33:29 +0000129
DRCfc26b652014-03-16 22:56:26 +0000130[1] New features in the TurboJPEG API:
131-- YUV planar images can now be generated with an arbitrary line padding
132(previously only 4-byte padding, which was compatible with X Video, was
133supported.)
134-- The decompress-to-YUV function has been extended to support image scaling.
135-- JPEG images can now be compressed from YUV planar source images.
136-- YUV planar images can now be decoded into RGB or grayscale images.
137-- 4:1:1 subsampling is now supported. This is mainly included for
138compatibility, since 4:1:1 is not fully accelerated in libjpeg-turbo and has no
139significant advantages relative to 4:2:0.
140-- CMYK images are now supported. This feature allows CMYK source images to be
141compressed to YCCK JPEGs and YCCK or CMYK JPEGs to be decompressed to CMYK
DRCf6d7b772014-08-20 16:02:49 +0000142destination images. Conversion between CMYK/YCCK and RGB or YUV images is not
143supported. Such conversion requires a color management system and is thus out
144of scope for a codec library.
DRCfc26b652014-03-16 22:56:26 +0000145-- The handling of YUV images in the Java API has been significantly refactored
146and should now be much more intuitive.
147-- The Java API now supports encoding a YUV image from an arbitrary position in
148a large image buffer.
DRCaecea382014-08-11 18:05:41 +0000149-- All of the YUV functions now have a corresponding function that operates on
150separate image planes instead of a unified image buffer. This allows for
DRCf6d7b772014-08-20 16:02:49 +0000151compressing/decoding from or decompressing/encoding to a subregion of a larger
152YUV image. It also allows for handling YUV formats that swap the order of the
153U and V planes.
DRCf610d612013-04-26 10:33:29 +0000154
DRCa6b7fbd2013-09-30 18:13:27 +0000155[2] Added SIMD acceleration for DSPr2-capable MIPS platforms. This speeds up
DRCd64e23e2013-10-08 02:32:07 +0000156the compression of full-color JPEGs by 70-80% on such platforms and
157decompression by 25-35%.
DRC0be9fa52013-07-24 21:50:20 +0000158
DRCfc26b652014-03-16 22:56:26 +0000159[3] If an application attempts to decompress a Huffman-coded JPEG image whose
DRCa1135062014-01-31 17:22:15 +0000160header does not contain Huffman tables, libjpeg-turbo will now insert the
161default Huffman tables. In order to save space, many motion JPEG video frames
162are encoded without the default Huffman tables, so these frames can now be
163successfully decompressed by libjpeg-turbo without additional work on the part
164of the application. An application can still override the Huffman tables, for
165instance to re-use tables from a previous frame of the same video.
166
DRCb1068fa2014-03-23 17:53:07 +0000167[4] The Mac packaging system now uses pkgbuild and productbuild rather than
168PackageMaker (which is obsolete and no longer supported.) This means that
169OS X 10.6 "Snow Leopard" or later must be used when packaging libjpeg-turbo,
170although the packages produced can be installed on OS X 10.5 "Leopard" or
171later. OS X 10.4 "Tiger" is no longer supported.
172
DRC0cfc4c12014-03-28 18:33:25 +0000173[5] The Huffman encoder now uses clz and bsr instructions for bit counting on
174ARM platforms rather than a lookup table. This reduces the memory footprint
175by 64k, which may be important for some mobile applications. Out of four
DRCfdd625e2014-04-15 03:07:44 +0000176Android devices that were tested, two demonstrated a small overall performance
177loss (~3-4% on average) with ARMv6 code and a small gain (also ~3-4%) with
178ARMv7 code when enabling this new feature, but the other two devices
179demonstrated a significant overall performance gain with both ARMv6 and ARMv7
DRCf6d7b772014-08-20 16:02:49 +0000180code (~10-20%) when enabling the feature. Actual mileage may vary.
DRC0cfc4c12014-03-28 18:33:25 +0000181
DRC0816d082014-04-20 06:57:52 +0000182[6] Worked around an issue with Visual C++ 2010 and later that caused incorrect
DRCbeb0b332014-04-20 07:36:33 +0000183pixels to be generated when decompressing a JPEG image to a 256-color bitmap,
184if compiler optimization was enabled when libjpeg-turbo was built. This caused
185the regression tests to fail when doing a release build under Visual C++ 2010
186and later.
187
DRC715bb412014-05-11 10:09:07 +0000188[7] Improved the accuracy and performance of the non-SIMD implementation of the
189floating point inverse DCT (using code borrowed from libjpeg v8a and later.)
190The accuracy of this implementation now matches the accuracy of the SSE/SSE2
191implementation. Note, however, that the floating point DCT/IDCT algorithms are
192mainly a legacy feature. They generally do not produce significantly better
193accuracy than the slow integer DCT/IDCT algorithms, and they are quite a bit
194slower.
195
DRC78df2e62014-05-12 09:23:57 +0000196[8] Added a new output colorspace (JCS_RGB565) to the libjpeg API that allows
DRCd729f4d2014-08-23 15:47:51 +0000197for decompressing JPEG images into RGB565 (16-bit) pixels. If dithering is not
198used, then this code path is SIMD-accelerated on ARM platforms.
DRC78df2e62014-05-12 09:23:57 +0000199
DRCf6d7b772014-08-20 16:02:49 +0000200[9] Numerous obsolete features, such as support for non-ANSI compilers and
201support for the MS-DOS memory model, were removed from the libjpeg code,
202greatly improving its readability and making it easier to maintain and extend.
DRC5033f3e2014-05-18 18:33:44 +0000203
DRCcf55f0b2014-05-28 20:19:54 +0000204[10] Fixed a segfault that occurred when calling output_message() with msg_code
205set to JMSG_COPYRIGHT.
206
DRCb7d6e842014-06-22 20:36:50 +0000207[11] Fixed an issue whereby wrjpgcom was allowing comments longer than 65k
208characters to be passed on the command line, which was causing it to generate
209incorrect JPEG files.
210
DRC73821bf2014-06-22 20:46:48 +0000211[12] Fixed a bug in the build system that was causing the Windows version of
DRCf6d7b772014-08-20 16:02:49 +0000212wrjpgcom to be built using the rdjpgcom source code.
DRCb7d6e842014-06-22 20:36:50 +0000213
DRCaee4f722014-08-09 23:06:07 +0000214[13] Restored 12-bit-per-component JPEG support. A 12-bit version of
215libjpeg-turbo can now be built by passing an argument of --with-12bit to
216configure (Unix) or -DWITH_12BIT=1 to cmake (Windows.) 12-bit JPEG support is
217included only for convenience. Enabling this feature disables all of the
218performance features in libjpeg-turbo, as well as arithmetic coding and the
DRCf6d7b772014-08-20 16:02:49 +0000219TurboJPEG API. The resulting library still contains the other libjpeg-turbo
220features (such as the colorspace extensions), but in general, it performs no
221faster than libjpeg v6b.
DRCaee4f722014-08-09 23:06:07 +0000222
DRCbc3c1682014-08-20 15:40:43 +0000223[14] Added ARM 64-bit SIMD acceleration for the YCC-to-RGB color conversion
224and IDCT algorithms (both are used during JPEG decompression.) For unknown
225reasons (probably related to clang), this code cannot currently be compiled for
226iOS.
227
DRC2261e1e2014-08-21 03:40:37 +0000228[15] Fixed an extremely rare bug that could cause the Huffman encoder's local
DRCeddc3552014-08-21 03:38:14 +0000229buffer to overrun when a very high-frequency MCU is compressed using quality
230100 and no subsampling, and when the JPEG output buffer is being dynamically
231resized by the destination manager. This issue was so rare that, even with a
232test program specifically designed to make the bug occur (by injecting random
233high-frequency YUV data into the compressor), it was reproducible only once in
234about every 25 million iterations.
235
DRCfe80ec22014-08-21 15:51:47 +0000236[16] Fixed an oversight in the TurboJPEG C wrapper: if any of the JPEG
237compression functions was called repeatedly with the same
238automatically-allocated destination buffer, then TurboJPEG would erroneously
239assume that the jpegSize parameter was equal to the size of the buffer, when in
240fact that parameter was probably equal to the size of the most recently
241compressed JPEG image. If the size of the previous JPEG image was not as large
242as the current JPEG image, then TurboJPEG would unnecessarily reallocate the
243destination buffer.
244
DRCf610d612013-04-26 10:33:29 +0000245
DRC96573d02013-08-11 23:23:41 +00002461.3.1
247=====
248
249[1] On Un*x systems, 'make install' now installs the libjpeg-turbo libraries
250into /opt/libjpeg-turbo/lib32 by default on any 32-bit system, not just x86,
251and into /opt/libjpeg-turbo/lib64 by default on any 64-bit system, not just
252x86-64. You can override this by overriding either the 'prefix' or 'libdir'
253configure variables.
254
DRC4d877932013-09-19 22:55:57 +0000255[2] The Windows installer now places a copy of the TurboJPEG DLLs in the same
256directory as the rest of the libjpeg-turbo binaries. This was mainly done
257to support TurboVNC 1.3, which bundles the DLLs in its Windows installation.
258When using a 32-bit version of CMake on 64-bit Windows, it is impossible to
259access the c:\WINDOWS\system32 directory, which made it impossible for the
260TurboVNC build scripts to bundle the 64-bit TurboJPEG DLL.
261
DRCcadabd42013-09-28 03:10:31 +0000262[3] Fixed a bug whereby attempting to encode a progressive JPEG with arithmetic
263entropy coding (by passing arguments of -progressive -arithmetic to cjpeg or
264jpegtran, for instance) would result in an error, "Requested feature was
265omitted at compile time".
DRC1370f102013-09-24 03:21:38 +0000266
DRC7ebf2942013-11-21 18:32:48 +0000267[4] Fixed a couple of issues whereby malformed JPEG images would cause
DRC43d8cf42013-11-21 18:34:39 +0000268libjpeg-turbo to use uninitialized memory during decompression.
269
DRC38c99702014-02-11 09:45:18 +0000270[5] Fixed an error ("Buffer passed to JPEG library is too small") that occurred
271when calling the TurboJPEG YUV encoding function with a very small (< 5x5)
272source image, and added a unit test to check for this error.
273
DRCd45c5492014-03-11 06:21:46 +0000274[6] The Java classes should now build properly under Visual Studio 2010 and
275later.
276
DRCde23dd82014-03-22 20:43:03 +0000277[7] Fixed an issue that prevented SRPMs generated using the in-tree packaging
278tools from being rebuilt on certain newer Linux distributions.
279
280[8] Numerous minor fixes to eliminate compilation and build/packaging system
281warnings, fix cosmetic issues, improve documentation clarity, and other general
282source cleanup.
283
DRC96573d02013-08-11 23:23:41 +0000284
DRC0bf58f22013-02-06 23:51:08 +00002851.3.0
286=====
287
288[1] 'make test' now works properly on FreeBSD, and it no longer requires the
289md5sum executable to be present on other Un*x platforms.
290
DRCd7a642b2013-04-24 06:40:25 +0000291[2] Overhauled the packaging system:
DRC764e1e22013-04-19 04:25:14 +0000292-- To avoid conflict with vendor-supplied libjpeg-turbo packages, the
293official RPMs and DEBs for libjpeg-turbo have been renamed to
DRCd7a642b2013-04-24 06:40:25 +0000294"libjpeg-turbo-official".
295-- The TurboJPEG libraries are now located under /opt/libjpeg-turbo in the
296official Linux and Mac packages, to avoid conflict with vendor-supplied
297packages and also to streamline the packaging system.
298-- Release packages are now created with the directory structure defined
299by the configure variables "prefix", "bindir", "libdir", etc. (Un*x) or by the
300CMAKE_INSTALL_PREFIX variable (Windows.) The exception is that the docs are
301always located under the system default documentation directory on Un*x and Mac
302systems, and on Windows, the TurboJPEG DLL is always located in the Windows
303system directory.
DRC764e1e22013-04-19 04:25:14 +0000304-- To avoid confusion, official libjpeg-turbo packages on Linux/Unix platforms
305(except for Mac) will always install the 32-bit libraries in
306/opt/libjpeg-turbo/lib32 and the 64-bit libraries in /opt/libjpeg-turbo/lib64.
DRCd7a642b2013-04-24 06:40:25 +0000307-- Fixed an issue whereby, in some cases, the libjpeg-turbo executables on Un*x
308systems were not properly linking with the shared libraries installed by the
309same package.
310-- Fixed an issue whereby building the "installer" target on Windows when
311WITH_JAVA=1 would fail if the TurboJPEG JAR had not been previously built.
312-- Building the "install" target on Windows now installs files into the same
313places that the installer does.
DRC764e1e22013-04-19 04:25:14 +0000314
DRC4c17a452013-04-25 08:55:31 +0000315[3] Fixed a Huffman encoder bug that prevented I/O suspension from working
316properly.
317
DRC0bf58f22013-02-06 23:51:08 +0000318
DRC84f71222012-12-31 09:44:31 +00003191.2.90 (1.3 beta1)
320==================
DRC27fb3fc2012-01-28 01:48:07 +0000321
322[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 +000032311/8, 3/2, 13/8, 7/4, 15/8, and 2) when decompressing. Note that the IDCT will
324not be SIMD-accelerated when using any of these new scaling factors.
DRC27fb3fc2012-01-28 01:48:07 +0000325
DRC575317b2012-06-15 22:00:47 +0000326[2] The TurboJPEG dynamic library is now versioned. It was not strictly
DRCfd407772012-03-23 03:24:39 +0000327necessary to do so, because TurboJPEG uses versioned symbols, and if a function
328changes in an ABI-incompatible way, that function is renamed and a legacy
329function is provided to maintain backward compatibility. However, certain
DRC5a84a0e2013-02-14 07:31:35 +0000330Linux distro maintainers have a policy against accepting any library that isn't
331versioned.
DRCfd407772012-03-23 03:24:39 +0000332
DRCfac3bea2012-09-24 02:27:55 +0000333[3] Extended the TurboJPEG Java API so that it can be used to compress a JPEG
334image from and decompress a JPEG image to an arbitrary position in a large
335image buffer.
DRC575317b2012-06-15 22:00:47 +0000336
DRC21868092012-07-03 20:02:49 +0000337[4] The tjDecompressToYUV() function now supports the TJFLAG_FASTDCT flag.
DRCe0419b52012-07-03 20:01:31 +0000338
DRCa394bf72012-08-07 18:44:24 +0000339[5] The 32-bit supplementary package for amd64 Debian systems now provides
DRC0a0f8d12012-08-07 18:42:07 +0000340symlinks in /usr/lib/i386-linux-gnu for the TurboJPEG libraries in /usr/lib32.
341This allows those libraries to be used on MultiArch-compatible systems (such as
342Ubuntu 11 and later) without setting the linker path.
343
DRC61e13412012-08-24 02:44:39 +0000344[6] The TurboJPEG Java wrapper should now find the JNI library on Mac systems
345without having to pass -Djava.library.path=/usr/lib to java.
346
DRCd9d1d672012-10-02 04:20:43 +0000347[7] TJBench has been ported to Java to provide a convenient way of validating
348the performance of the TurboJPEG Java API. It can be run with
349'java -cp turbojpeg.jar TJBench'.
350
DRCf73a27c2013-01-01 10:25:43 +0000351[8] cjpeg can now be used to generate JPEG files with the RGB colorspace
352(feature ported from jpeg-8d.)
353
DRC8cbf8932013-01-01 10:44:00 +0000354[9] The width and height in the -crop argument passed to jpegtran can now be
355suffixed with "f" to indicate that, when the upper left corner of the cropping
356region is automatically moved to the nearest iMCU boundary, the bottom right
357corner should be moved by the same amount. In other words, this feature causes
358jpegtran to strictly honor the specified width/height rather than the specified
359bottom right corner (feature ported from jpeg-8d.)
360
DRCf37e4da2013-01-01 10:52:29 +0000361[10] JPEG files using the RGB colorspace can now be decompressed into grayscale
362images (feature ported from jpeg-8d.)
363
DRC00c2cf32013-01-13 12:12:53 +0000364[11] Fixed a regression caused by 1.2.1[7] whereby the build would fail with
DRCb87a0b42013-01-13 12:15:58 +0000365multiple "Mismatch in operand sizes" errors when attempting to build the x86
366SIMD code with NASM 0.98.
367
DRCab706232013-01-18 23:42:31 +0000368[12] The in-memory source/destination managers (jpeg_mem_src() and
369jpeg_mem_dest()) are now included by default when building libjpeg-turbo with
370libjpeg v6b or v7 emulation, so that programs can take advantage of these
371functions without requiring the use of the backward-incompatible libjpeg v8
372ABI. The "age number" of the libjpeg-turbo library on Un*x systems has been
373incremented by 1 to reflect this. You can disable this feature with a
374configure/CMake switch in order to retain strict API/ABI compatibility with the
375libjpeg v6b or v7 API/ABI (or with previous versions of libjpeg-turbo.) See
376README-turbo.txt for more details.
377
DRC6e6b28c2014-12-19 17:34:30 +0000378[13] Added ARMv7s architecture to libjpeg.a and libturbojpeg.a in the official
DRCa2a2cd62013-02-04 22:29:57 +0000379libjpeg-turbo binary package for OS X, so that those libraries can be used to
380build applications that leverage the faster CPUs in the iPhone 5 and iPad 4.
381
DRC575317b2012-06-15 22:00:47 +0000382
3831.2.1
384=====
385
386[1] Creating or decoding a JPEG file that uses the RGB colorspace should now
387properly work when the input or output colorspace is one of the libjpeg-turbo
388colorspace extensions.
389
390[2] When libjpeg-turbo was built without SIMD support and merged (non-fancy)
391upsampling was used along with an alpha-enabled colorspace during
392decompression, the unused byte of the decompressed pixels was not being set to
3930xFF. This has been fixed. TJUnitTest has also been extended to test for the
394correct behavior of the colorspace extensions when merged upsampling is used.
395
396[3] Fixed a bug whereby the libjpeg-turbo SSE2 SIMD code would not preserve the
DRC4f240162012-04-26 19:50:37 +0000397upper 64 bits of xmm6 and xmm7 on Win64 platforms, which violated the Win64
398calling conventions.
399
DRC575317b2012-06-15 22:00:47 +0000400[4] Fixed a regression caused by 1.2.0[6] whereby decompressing corrupt JPEG
DRCdd2b6512012-05-30 20:36:42 +0000401images (specifically, images in which the component count was erroneously set
402to a large value) would cause libjpeg-turbo to segfault.
403
DRC575317b2012-06-15 22:00:47 +0000404[5] Worked around a severe performance issue with "Bobcat" (AMD Embedded APU)
DRC69799272012-06-13 01:21:29 +0000405processors. The MASKMOVDQU instruction, which was used by the libjpeg-turbo
406SSE2 SIMD code, is apparently implemented in microcode on AMD processors, and
407it is painfully slow on Bobcat processors in particular. Eliminating the use
408of this instruction improved performance by an order of magnitude on Bobcat
409processors and by a small amount (typically 5%) on AMD desktop processors.
410
DRC575317b2012-06-15 22:00:47 +0000411[6] Added SIMD acceleration for performing 4:2:2 upsampling on NEON-capable ARM
412platforms. This speeds up the decompression of 4:2:2 JPEGs by 20-25% on such
413platforms.
414
DRCde37e072012-06-18 00:08:18 +0000415[7] Fixed a regression caused by 1.2.0[2] whereby, on Linux/x86 platforms
416running the 32-bit SSE2 SIMD code in libjpeg-turbo, decompressing a 4:2:0 or
4174:2:2 JPEG image into a 32-bit (RGBX, BGRX, etc.) buffer without using fancy
418upsampling would produce several incorrect columns of pixels at the right-hand
419side of the output image if each row in the output image was not evenly
420divisible by 16 bytes.
DRC8126d0c2012-06-15 21:54:45 +0000421
DRC112a0bb2012-06-28 23:25:34 +0000422[8] Fixed an issue whereby attempting to build the SIMD extensions with Xcode
4234.3 on OS X platforms would cause NASM to return numerous errors of the form
424"'%define' expects a macro identifier".
425
DRC73d74c12012-06-29 23:46:38 +0000426[9] Added flags to the TurboJPEG API that allow the caller to force the use of
427either the fast or the accurate DCT/IDCT algorithms in the underlying codec.
428
DRC27fb3fc2012-01-28 01:48:07 +0000429
DRC1ca924a2011-11-29 08:58:27 +00004301.2.0
431=====
432
433[1] Fixed build issue with YASM on Unix systems (the libjpeg-turbo build system
434was not adding the current directory to the assembler include path, so YASM
435was not able to find jsimdcfg.inc.)
436
DRCebfe9e42011-12-01 10:58:36 +0000437[2] Fixed out-of-bounds read in SSE2 SIMD code that occurred when decompressing
438a JPEG image to a bitmap buffer whose size was not a multiple of 16 bytes.
439This was more of an annoyance than an actual bug, since it did not cause any
440actual run-time problems, but the issue showed up when running libjpeg-turbo in
441valgrind. See http://crbug.com/72399 for more information.
442
DRCab64b622011-12-18 16:29:35 +0000443[3] Added a compile-time macro (LIBJPEG_TURBO_VERSION) that can be used to
444check the version of libjpeg-turbo against which an application was compiled.
445
DRC67ce3b22011-12-19 02:21:03 +0000446[4] Added new RGBA/BGRA/ABGR/ARGB colorspace extension constants (libjpeg API)
447and pixel formats (TurboJPEG API), which allow applications to specify that,
448when decompressing to a 4-component RGB buffer, the unused byte should be set
449to 0xFF so that it can be interpreted as an opaque alpha channel.
450
DRCa7466c92012-01-26 22:20:31 +0000451[5] Fixed regression issue whereby DevIL failed to build against libjpeg-turbo
452because libjpeg-turbo's distributed version of jconfig.h contained an INLINE
453macro, which conflicted with a similar macro in DevIL. This macro is used only
454internally when building libjpeg-turbo, so it was moved into config.h.
455
DRC12781cb2012-01-27 01:23:20 +0000456[6] libjpeg-turbo will now correctly decompress erroneous CMYK/YCCK JPEGs whose
457K component is assigned a component ID of 1 instead of 4. Although these files
458are in violation of the spec, other JPEG implementations handle them
459correctly.
460
DRC6e6b28c2014-12-19 17:34:30 +0000461[7] Added ARMv6 and ARMv7 architectures to libjpeg.a and libturbojpeg.a in
DRCa2a2cd62013-02-04 22:29:57 +0000462the official libjpeg-turbo binary package for OS X, so that those libraries can
463be used to build both OS X and iOS applications.
DRCc0526462012-02-10 01:44:55 +0000464
DRC1ca924a2011-11-29 08:58:27 +0000465
DRCf8e00552011-02-04 11:06:36 +00004661.1.90 (1.2 beta1)
467==================
468
DRC7bc3fb52011-10-28 06:45:53 +0000469[1] Added a Java wrapper for the TurboJPEG API. See java/README for more
470details.
DRCf8e00552011-02-04 11:06:36 +0000471
DRC7bc3fb52011-10-28 06:45:53 +0000472[2] The TurboJPEG API can now be used to scale down images during
473decompression.
DRCa3c30592011-02-07 08:06:16 +0000474
DRC15866ac2011-03-04 13:46:55 +0000475[3] Added SIMD routines for RGB-to-grayscale color conversion, which
476significantly improves the performance of grayscale JPEG compression from an
477RGB source image.
478
DRC3c21b082011-10-28 06:25:13 +0000479[4] Improved the performance of the C color conversion routines, which are used
480on platforms for which SIMD acceleration is not available.
DRC15866ac2011-03-04 13:46:55 +0000481
DRC3c21b082011-10-28 06:25:13 +0000482[5] Added a function to the TurboJPEG API that performs lossless transforms.
483This function is implemented using the same back end as jpegtran, but it
484performs transcoding entirely in memory and allows multiple transforms and/or
485crop operations to be batched together, so the source coefficients only need to
486be read once. This is useful when generating image tiles from a single source
487JPEG.
DRC15866ac2011-03-04 13:46:55 +0000488
DRC3c21b082011-10-28 06:25:13 +0000489[6] Added tests for the new TurboJPEG scaled decompression and lossless
DRC77fee432011-11-01 17:14:22 +0000490transform features to tjbench (the TurboJPEG benchmark, formerly called
491"jpgtest".)
DRC15866ac2011-03-04 13:46:55 +0000492
493[7] Added support for 4:4:0 (transposed 4:2:2) subsampling in TurboJPEG, which
494was necessary in order for it to read 4:2:2 JPEG files that had been losslessly
495transposed or rotated 90 degrees.
496
DRC67d1fc12011-05-24 14:13:01 +0000497[8] All legacy VirtualGL code has been re-factored, and this has allowed
498libjpeg-turbo, in its entirety, to be re-licensed under a BSD-style license.
DRCee269922011-04-26 23:46:38 +0000499
DRCf89dd1e2011-05-21 14:23:30 +0000500[9] libjpeg-turbo can now be built with YASM.
DRC56fb2372011-05-03 06:32:41 +0000501
DRCe5c6eb52011-08-17 20:59:56 +0000502[10] Added SIMD acceleration for ARM Linux and iOS platforms that support
503NEON instructions.
DRC321e0682011-05-03 08:47:43 +0000504
DRC3c21b082011-10-28 06:25:13 +0000505[11] Refactored the TurboJPEG C API and documented it using Doxygen. The
506TurboJPEG 1.2 API uses pixel formats to define the size and component order of
507the uncompressed source/destination images, and it includes a more efficient
508version of TJBUFSIZE() that computes a worst-case JPEG size based on the level
DRC5039d732013-01-21 23:42:12 +0000509of chrominance subsampling. The refactored implementation of the TurboJPEG API
DRC3c21b082011-10-28 06:25:13 +0000510now uses the libjpeg memory source and destination managers, which allows the
511TurboJPEG compressor to grow the JPEG buffer as necessary.
DRC9b28def2011-05-21 14:37:15 +0000512
DRCe9f9ec42011-05-25 06:02:50 +0000513[12] Eliminated errors in the output of jpegtran on Windows that occurred when
DRC7e3fd2f2011-05-25 06:04:43 +0000514the application was invoked using I/O redirection
515(jpegtran <input.jpg >output.jpg).
516
DRCb8c6ee32011-05-31 20:22:37 +0000517[13] The inclusion of libjpeg v7 and v8 emulation as well as arithmetic coding
DRC0571e172011-05-31 20:17:16 +0000518support in libjpeg-turbo v1.1.0 introduced several new error constants in
519jerror.h, and these were mistakenly enabled for all emulation modes, causing
DRCfa9ff8e2011-06-21 06:17:10 +0000520the error enum in libjpeg-turbo to sometimes have different values than the
521same enum in libjpeg. This represents an ABI incompatibility, and it caused
522problems with rare applications that took specific action based on a particular
523error value. The fix was to include the new error constants conditionally
524based on whether libjpeg v7 or v8 emulation was enabled.
DRC0571e172011-05-31 20:17:16 +0000525
DRCeed08612011-06-21 04:56:02 +0000526[14] Fixed an issue whereby Windows applications that used libjpeg-turbo would
DRCb7120ca2011-06-21 04:57:32 +0000527fail to compile if the Windows system headers were included before jpeglib.h.
528This issue was caused by a conflict in the definition of the INT32 type.
DRC6ca69532011-02-18 03:31:11 +0000529
DRC3c21b082011-10-28 06:25:13 +0000530[15] Fixed 32-bit supplementary package for amd64 Debian systems, which was
DRC68a086a2011-07-19 09:26:23 +0000531broken by enhancements to the packaging system in 1.1.
532
DRC3c21b082011-10-28 06:25:13 +0000533[16] When decompressing a JPEG image using an output colorspace of
DRCc08e8c12011-09-08 23:54:40 +0000534JCS_EXT_RGBX, JCS_EXT_BGRX, JCS_EXT_XBGR, or JCS_EXT_XRGB, libjpeg-turbo will
535now set the unused byte to 0xFF, which allows applications to interpret that
536byte as an alpha channel (0xFF = opaque).
537
DRCf8e00552011-02-04 11:06:36 +0000538
DRC6ee54592011-03-01 08:18:30 +00005391.1.1
540=====
541
542[1] Fixed a 1-pixel error in row 0, column 21 of the luminance plane generated
543by tjEncodeYUV().
544
DRC8071c392011-04-17 15:29:17 +0000545[2] libjpeg-turbo's accelerated Huffman decoder previously ignored unexpected
546markers found in the middle of the JPEG data stream during decompression. It
547will now hand off decoding of a particular block to the unaccelerated Huffman
548decoder if an unexpected marker is found, so that the unaccelerated Huffman
549decoder can generate an appropriate warning.
DRC6ee54592011-03-01 08:18:30 +0000550
DRC47aaf6f2011-03-22 05:40:39 +0000551[3] Older versions of MinGW64 prefixed symbol names with underscores by
DRC1da78582011-03-22 09:34:01 +0000552default, which differed from the behavior of 64-bit Visual C++. MinGW64 1.0
553has adopted the behavior of 64-bit Visual C++ as the default, so to accommodate
554this, the libjpeg-turbo SIMD function names are no longer prefixed with an
555underscore when building with MinGW64. This means that, when building
556libjpeg-turbo with older versions of MinGW64, you will now have to add
557-fno-leading-underscore to the CFLAGS.
558
DRCd8840112011-04-25 22:46:25 +0000559[4] Fixed a regression bug in the NSIS script that caused the Windows installer
560build to fail when using the Visual Studio IDE.
561
562[5] Fixed a bug in jpeg_read_coefficients() whereby it would not initialize
563cinfo->image_width and cinfo->image_height if libjpeg v7 or v8 emulation was
564enabled. This specifically caused the jpegoptim program to fail if it was
565linked against a version of libjpeg-turbo that was built with libjpeg v7 or v8
566emulation.
567
DRC049aef52011-04-25 22:41:14 +0000568[6] Eliminated excessive I/O overhead that occurred when reading BMP files in
569cjpeg.
570
DRC5ee81f42011-05-02 00:35:50 +0000571[7] Eliminated errors in the output of cjpeg on Windows that occurred when the
DRC34a8e352011-05-10 22:14:38 +0000572application was invoked using I/O redirection (cjpeg <inputfile >output.jpg).
DRC5ee81f42011-05-02 00:35:50 +0000573
DRCf5c3bb32011-03-18 05:59:07 +0000574
DRC958b2c02011-01-28 08:00:40 +00005751.1.0
576=====
DRCfa1d1832011-01-26 05:35:20 +0000577
DRCa49c4e52011-02-18 20:50:08 +0000578[1] The algorithm used by the SIMD quantization function cannot produce correct
579results when the JPEG quality is >= 98 and the fast integer forward DCT is
580used. Thus, the non-SIMD quantization function is now used for those cases,
581and libjpeg-turbo should now produce identical output to libjpeg v6b in all
582cases.
DRCe1716b82011-02-18 03:19:43 +0000583
DRCa49c4e52011-02-18 20:50:08 +0000584[2] Despite the above, the fast integer forward DCT still degrades somewhat for
DRC5039d732013-01-21 23:42:12 +0000585JPEG qualities greater than 95, so the TurboJPEG wrapper will now automatically
586use the slow integer forward DCT when generating JPEG images of quality 96 or
587greater. This reduces compression performance by as much as 15% for these
588high-quality images but is necessary to ensure that the images are perceptually
589lossless. It also ensures that the library can avoid the performance pitfall
590created by [1].
DRCa49c4e52011-02-18 20:50:08 +0000591
592[3] Ported jpgtest.cxx to pure C to avoid the need for a C++ compiler.
593
594[4] Fixed visual artifacts in grayscale JPEG compression caused by a typo in
DRCd9ee65c2011-04-05 07:01:26 +0000595the RGB-to-luminance lookup tables.
DRC8ed7b812011-02-15 08:31:34 +0000596
DRC240d82f2011-02-19 00:00:34 +0000597[5] The Windows distribution packages now include the libjpeg run-time programs
598(cjpeg, etc.)
599
DRC9cd2c422011-02-19 17:52:45 +0000600[6] All packages now include jpgtest.
DRC240d82f2011-02-19 00:00:34 +0000601
DRCe4d9b5b2011-02-25 06:17:17 +0000602[7] The TurboJPEG dynamic library now uses versioned symbols.
603
604[8] Added two new TurboJPEG API functions, tjEncodeYUV() and
605tjDecompressToYUV(), to replace the somewhat hackish TJ_YUV flag.
606
DRC2d94e262011-01-25 06:52:31 +0000607
DRC958b2c02011-01-28 08:00:40 +00006081.0.90 (1.1 beta1)
609==================
DRC766dc5c2010-10-12 02:50:18 +0000610
DRCf38eee02011-02-18 07:00:38 +0000611[1] Added emulation of the libjpeg v7 and v8 APIs and ABIs. See
DRCefa618e2010-10-18 08:41:11 +0000612README-turbo.txt for more details. This feature was sponsored by CamTrace SAS.
613
614[2] Created a new CMake-based build system for the Visual C++ and MinGW builds.
DRC766dc5c2010-10-12 02:50:18 +0000615
DRC2c62da32012-01-17 22:55:03 +0000616[3] Grayscale bitmaps can now be compressed from/decompressed to using the
617TurboJPEG API.
DRC09854f52010-11-04 22:39:59 +0000618
DRC01e69092011-01-06 01:19:43 +0000619[4] jpgtest can now be used to test decompression performance with existing
620JPEG images.
DRCe89bbae2010-11-12 10:18:08 +0000621
DRCd1c281a2010-11-17 22:44:40 +0000622[5] If the default install prefix (/opt/libjpeg-turbo) is used, then
623'make install' now creates /opt/libjpeg-turbo/lib32 and
624/opt/libjpeg-turbo/lib64 sym links to duplicate the behavior of the binary
625packages.
626
DRCec311932010-11-22 19:51:42 +0000627[6] All symbols in the libjpeg-turbo dynamic library are now versioned, even
628when the library is built with libjpeg v6b emulation.
629
DRC01e69092011-01-06 01:19:43 +0000630[7] Added arithmetic encoding and decoding support (can be disabled with
DRC245cfdf2010-11-23 17:11:06 +0000631configure or CMake options)
DRC66f97e62010-11-23 05:49:54 +0000632
DRC2c62da32012-01-17 22:55:03 +0000633[8] Added a TJ_YUV flag to the TurboJPEG API, which causes both the compressor
634and decompressor to output planar YUV images.
DRCfbb67472010-11-24 04:02:37 +0000635
DRC2c62da32012-01-17 22:55:03 +0000636[9] Added an extended version of tjDecompressHeader() to the TurboJPEG API,
637which allows the caller to determine the type of subsampling used in a JPEG
638image.
DRC50c657b2010-12-14 01:23:16 +0000639
DRC958b2c02011-01-28 08:00:40 +0000640[10] Added further protections against invalid Huffman codes.
DRCfa1d1832011-01-26 05:35:20 +0000641
DRC766dc5c2010-10-12 02:50:18 +0000642
DRC958b2c02011-01-28 08:00:40 +00006431.0.1
644=====
DRC0fbb28e2010-07-30 17:15:52 +0000645
646[1] The Huffman decoder will now handle erroneous Huffman codes (for instance,
647from a corrupt JPEG image.) Previously, these would cause libjpeg-turbo to
648crash under certain circumstances.
649
DRC81a50f72012-01-17 22:56:22 +0000650[2] Fixed typo in SIMD dispatch routines that was causing 4:2:2 upsampling to
DRC025a2792010-08-07 16:27:56 +0000651be used instead of 4:2:0 when decompressing JPEG images using SSE2 code.
DRC30959712010-08-07 16:06:56 +0000652
DRCbdb12882010-08-21 21:14:17 +0000653[3] configure script will now automatically determine whether the
654INCOMPLETE_TYPES_BROKEN macro should be defined.
655
DRC0fbb28e2010-07-30 17:15:52 +0000656
DRC958b2c02011-01-28 08:00:40 +00006571.0.0
658=====
DRC49597872010-05-17 20:47:57 +0000659
DRCc773d102010-06-05 06:58:22 +0000660[1] 2983700: Further FreeBSD build tweaks (no longer necessary to specify
661--host when configuring on a 64-bit system)
DRC49597872010-05-17 20:47:57 +0000662
DRCd5e964c2013-01-10 11:47:39 +0000663[2] Created symlinks in the Unix/Linux packages so that the TurboJPEG
DRCf12c7db2010-05-18 19:04:47 +0000664include file can always be found in /opt/libjpeg-turbo/include, the 32-bit
665static libraries can always be found in /opt/libjpeg-turbo/lib32, and the
66664-bit static libraries can always be found in /opt/libjpeg-turbo/lib64.
667
DRC4bf3b582010-06-05 01:03:23 +0000668[3] The Unix/Linux distribution packages now include the libjpeg run-time
669programs (cjpeg, etc.) and man pages.
670
DRC81a50f72012-01-17 22:56:22 +0000671[4] Created a 32-bit supplementary package for amd64 Debian systems, which
DRC4bf3b582010-06-05 01:03:23 +0000672contains just the 32-bit libjpeg-turbo libraries.
673
674[5] Moved the libraries from */lib32 to */lib in the i386 Debian package.
675
DRCdf3337c2010-07-02 09:13:58 +0000676[6] Include distribution package for Cygwin
DRC4bf3b582010-06-05 01:03:23 +0000677
DRCdf3337c2010-07-02 09:13:58 +0000678[7] No longer necessary to specify --without-simd on non-x86 architectures, and
DRC38ccf852010-06-10 19:49:49 +0000679unit tests now work on those architectures.
680
DRC49597872010-05-17 20:47:57 +0000681
DRC958b2c02011-01-28 08:00:40 +00006820.0.93
683======
DRC0f413b22010-04-06 20:05:39 +0000684
DRCc773d102010-06-05 06:58:22 +0000685[1] 2982659, Fixed x86-64 build on FreeBSD systems
DRC0f413b22010-04-06 20:05:39 +0000686
DRCc773d102010-06-05 06:58:22 +0000687[2] 2988188: Added support for Windows 64-bit systems
DRC1a2219e2010-05-10 20:03:36 +0000688
DRC0f413b22010-04-06 20:05:39 +0000689
DRC958b2c02011-01-28 08:00:40 +00006900.0.91
691======
DRCae19bf62010-03-15 11:40:31 +0000692
693[1] Added documentation to .deb packages
694
695[2] 2968313: Fixed data corruption issues when decompressing large JPEG images
696and/or using buffered I/O with the libjpeg-turbo decompressor
DRC958b2c02011-01-28 08:00:40 +0000697
698
6990.0.90
700======
701
702Initial release