blob: 139bcca56680c17cb07418070bb7788d7043acad [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
DRCcbc99702015-01-16 06:29:52 +000035
DRCeb8d0962014-08-30 13:52:09 +0000361.4.0
DRCe0419b52012-07-03 20:01:31 +000037=====
38
DRCeb8d0962014-08-30 13:52:09 +000039[1] Fixed a build issue on OS X PowerPC platforms (md5cmp failed to build
40because OS X does not provide the le32toh() and htole32() functions.)
41
DRC72a3cc02014-08-30 20:37:50 +000042[2] The non-SIMD RGB565 color conversion code did not work correctly on big
43endian machines. This has been fixed.
44
DRC55620c62014-10-23 19:08:14 +000045[3] Fixed an issue in tjPlaneSizeYUV() whereby it would erroneously return 1
DRC22409742014-10-23 18:54:42 +000046instead of -1 if componentID was > 0 and subsamp was TJSAMP_GRAY.
47
DRC8f7f49a2015-01-12 08:36:37 +000048[3] Fixed an issue in tjBufSizeYUV2() whereby it would erroneously return 0
DRC55620c62014-10-23 19:08:14 +000049instead of -1 if width was < 1.
50
DRC803b5d22014-11-18 15:56:43 +000051[5] The Huffman encoder now uses clz and bsr instructions for bit counting on
52ARM64 platforms (see 1.4 beta1 [5].)
53
DRC3ebcf7c2014-11-18 21:45:34 +000054[6] The close() method in the TJCompressor and TJDecompressor Java classes is
55now idempotent. Previously, that method would call the native tjDestroy()
56function even if the TurboJPEG instance had already been destroyed. This
57caused an exception to be thrown during finalization, if the close() method had
58already been called. The exception was caught, but it was still an expensive
59operation.
60
DRCea1eea42014-11-19 00:55:28 +000061[7] The TurboJPEG API previously generated an error ("Could not determine
62subsampling type for JPEG image") when attempting to decompress grayscale JPEG
63images that were compressed with a sampling factor other than 1 (for instance,
64with 'cjpeg -grayscale -sample 2x2'). Subsampling technically has no meaning
65with grayscale JPEGs, and thus the horizontal and vertical sampling factors
66for such images are ignored by the decompressor. However, the TurboJPEG API
67was being too rigid and was expecting the sampling factors to be equal to 1
68before it treated the image as a grayscale JPEG.
69
DRC9665f5e2014-11-22 04:04:38 +000070[8] cjpeg, djpeg, and jpegtran now accept an argument of -version, which will
71print the library version and exit.
72
DRC402a7152014-11-22 22:09:30 +000073[9] Referring to 1.4 beta1 [15], another extremely rare circumstance was
74discovered under which the Huffman encoder's local buffer can be overrun
75when a buffered destination manager is being used and an
76extremely-high-frequency block (basically junk image data) is being encoded.
77Even though the Huffman local buffer was increased from 128 bytes to 136 bytes
78to address the previous issue, the new issue caused even the larger buffer to
79be overrun. Further analysis reveals that, in the absolute worst case (such as
80setting alternating AC coefficients to 32767 and -32768 in the JPEG scanning
81order), the Huffman encoder can produce encoded blocks that approach double the
82size of the unencoded blocks. Thus, the Huffman local buffer was increased to
83256 bytes, which should prevent any such issue from re-occurring in the future.
84
DRC0f4469c2014-11-22 23:56:26 +000085[10] The new tjPlaneSizeYUV(), tjPlaneWidth(), and tjPlaneHeight() functions
86were not actually usable on any platform except OS X and Windows, because
87those functions were not included in the libturbojpeg mapfile. This has been
88fixed.
89
DRC2a6b8312014-11-25 10:07:43 +000090[11] Restored the JPP(), JMETHOD(), and FAR macros in the libjpeg-turbo header
91files. The JPP() and JMETHOD() macros were originally implemented in libjpeg
92as a way of supporting non-ANSI compilers that lacked support for prototype
93parameters. libjpeg-turbo has never supported such compilers, but some
94software packages still use the macros to define their own prototypes.
95Similarly, libjpeg-turbo has never supported MS-DOS and other platforms that
96have far symbols, but some software packages still use the FAR macro. A pretty
DRCe2dd3e32014-11-25 09:48:15 +000097good argument can be made that this is a bad practice on the part of the
98software in question, but since this affects more than one package, it's just
99easier to fix it here.
100
DRCd51e6c22014-12-19 18:18:46 +0000101[12] Fixed issues that were preventing the ARM 64-bit SIMD code from compiling
102for iOS, and included an ARMv8 architecture in all of the binaries installed by
103the "official" libjpeg-turbo SDK for OS X.
104
DRCeb8d0962014-08-30 13:52:09 +0000105
DRCfe77fa22014-08-30 13:48:45 +00001061.3.90 (1.4 beta1)
107==================
DRCf610d612013-04-26 10:33:29 +0000108
DRCfc26b652014-03-16 22:56:26 +0000109[1] New features in the TurboJPEG API:
110-- YUV planar images can now be generated with an arbitrary line padding
111(previously only 4-byte padding, which was compatible with X Video, was
112supported.)
113-- The decompress-to-YUV function has been extended to support image scaling.
114-- JPEG images can now be compressed from YUV planar source images.
115-- YUV planar images can now be decoded into RGB or grayscale images.
116-- 4:1:1 subsampling is now supported. This is mainly included for
117compatibility, since 4:1:1 is not fully accelerated in libjpeg-turbo and has no
118significant advantages relative to 4:2:0.
119-- CMYK images are now supported. This feature allows CMYK source images to be
120compressed to YCCK JPEGs and YCCK or CMYK JPEGs to be decompressed to CMYK
DRCf6d7b772014-08-20 16:02:49 +0000121destination images. Conversion between CMYK/YCCK and RGB or YUV images is not
122supported. Such conversion requires a color management system and is thus out
123of scope for a codec library.
DRCfc26b652014-03-16 22:56:26 +0000124-- The handling of YUV images in the Java API has been significantly refactored
125and should now be much more intuitive.
126-- The Java API now supports encoding a YUV image from an arbitrary position in
127a large image buffer.
DRCaecea382014-08-11 18:05:41 +0000128-- All of the YUV functions now have a corresponding function that operates on
129separate image planes instead of a unified image buffer. This allows for
DRCf6d7b772014-08-20 16:02:49 +0000130compressing/decoding from or decompressing/encoding to a subregion of a larger
131YUV image. It also allows for handling YUV formats that swap the order of the
132U and V planes.
DRCf610d612013-04-26 10:33:29 +0000133
DRCa6b7fbd2013-09-30 18:13:27 +0000134[2] Added SIMD acceleration for DSPr2-capable MIPS platforms. This speeds up
DRCd64e23e2013-10-08 02:32:07 +0000135the compression of full-color JPEGs by 70-80% on such platforms and
136decompression by 25-35%.
DRC0be9fa52013-07-24 21:50:20 +0000137
DRCfc26b652014-03-16 22:56:26 +0000138[3] If an application attempts to decompress a Huffman-coded JPEG image whose
DRCa1135062014-01-31 17:22:15 +0000139header does not contain Huffman tables, libjpeg-turbo will now insert the
140default Huffman tables. In order to save space, many motion JPEG video frames
141are encoded without the default Huffman tables, so these frames can now be
142successfully decompressed by libjpeg-turbo without additional work on the part
143of the application. An application can still override the Huffman tables, for
144instance to re-use tables from a previous frame of the same video.
145
DRCb1068fa2014-03-23 17:53:07 +0000146[4] The Mac packaging system now uses pkgbuild and productbuild rather than
147PackageMaker (which is obsolete and no longer supported.) This means that
148OS X 10.6 "Snow Leopard" or later must be used when packaging libjpeg-turbo,
149although the packages produced can be installed on OS X 10.5 "Leopard" or
150later. OS X 10.4 "Tiger" is no longer supported.
151
DRC0cfc4c12014-03-28 18:33:25 +0000152[5] The Huffman encoder now uses clz and bsr instructions for bit counting on
153ARM platforms rather than a lookup table. This reduces the memory footprint
154by 64k, which may be important for some mobile applications. Out of four
DRCfdd625e2014-04-15 03:07:44 +0000155Android devices that were tested, two demonstrated a small overall performance
156loss (~3-4% on average) with ARMv6 code and a small gain (also ~3-4%) with
157ARMv7 code when enabling this new feature, but the other two devices
158demonstrated a significant overall performance gain with both ARMv6 and ARMv7
DRCf6d7b772014-08-20 16:02:49 +0000159code (~10-20%) when enabling the feature. Actual mileage may vary.
DRC0cfc4c12014-03-28 18:33:25 +0000160
DRC0816d082014-04-20 06:57:52 +0000161[6] Worked around an issue with Visual C++ 2010 and later that caused incorrect
DRCbeb0b332014-04-20 07:36:33 +0000162pixels to be generated when decompressing a JPEG image to a 256-color bitmap,
163if compiler optimization was enabled when libjpeg-turbo was built. This caused
164the regression tests to fail when doing a release build under Visual C++ 2010
165and later.
166
DRC715bb412014-05-11 10:09:07 +0000167[7] Improved the accuracy and performance of the non-SIMD implementation of the
168floating point inverse DCT (using code borrowed from libjpeg v8a and later.)
169The accuracy of this implementation now matches the accuracy of the SSE/SSE2
170implementation. Note, however, that the floating point DCT/IDCT algorithms are
171mainly a legacy feature. They generally do not produce significantly better
172accuracy than the slow integer DCT/IDCT algorithms, and they are quite a bit
173slower.
174
DRC78df2e62014-05-12 09:23:57 +0000175[8] Added a new output colorspace (JCS_RGB565) to the libjpeg API that allows
DRCd729f4d2014-08-23 15:47:51 +0000176for decompressing JPEG images into RGB565 (16-bit) pixels. If dithering is not
177used, then this code path is SIMD-accelerated on ARM platforms.
DRC78df2e62014-05-12 09:23:57 +0000178
DRCf6d7b772014-08-20 16:02:49 +0000179[9] Numerous obsolete features, such as support for non-ANSI compilers and
180support for the MS-DOS memory model, were removed from the libjpeg code,
181greatly improving its readability and making it easier to maintain and extend.
DRC5033f3e2014-05-18 18:33:44 +0000182
DRCcf55f0b2014-05-28 20:19:54 +0000183[10] Fixed a segfault that occurred when calling output_message() with msg_code
184set to JMSG_COPYRIGHT.
185
DRCb7d6e842014-06-22 20:36:50 +0000186[11] Fixed an issue whereby wrjpgcom was allowing comments longer than 65k
187characters to be passed on the command line, which was causing it to generate
188incorrect JPEG files.
189
DRC73821bf2014-06-22 20:46:48 +0000190[12] Fixed a bug in the build system that was causing the Windows version of
DRCf6d7b772014-08-20 16:02:49 +0000191wrjpgcom to be built using the rdjpgcom source code.
DRCb7d6e842014-06-22 20:36:50 +0000192
DRCaee4f722014-08-09 23:06:07 +0000193[13] Restored 12-bit-per-component JPEG support. A 12-bit version of
194libjpeg-turbo can now be built by passing an argument of --with-12bit to
195configure (Unix) or -DWITH_12BIT=1 to cmake (Windows.) 12-bit JPEG support is
196included only for convenience. Enabling this feature disables all of the
197performance features in libjpeg-turbo, as well as arithmetic coding and the
DRCf6d7b772014-08-20 16:02:49 +0000198TurboJPEG API. The resulting library still contains the other libjpeg-turbo
199features (such as the colorspace extensions), but in general, it performs no
200faster than libjpeg v6b.
DRCaee4f722014-08-09 23:06:07 +0000201
DRCbc3c1682014-08-20 15:40:43 +0000202[14] Added ARM 64-bit SIMD acceleration for the YCC-to-RGB color conversion
203and IDCT algorithms (both are used during JPEG decompression.) For unknown
204reasons (probably related to clang), this code cannot currently be compiled for
205iOS.
206
DRC2261e1e2014-08-21 03:40:37 +0000207[15] Fixed an extremely rare bug that could cause the Huffman encoder's local
DRCeddc3552014-08-21 03:38:14 +0000208buffer to overrun when a very high-frequency MCU is compressed using quality
209100 and no subsampling, and when the JPEG output buffer is being dynamically
210resized by the destination manager. This issue was so rare that, even with a
211test program specifically designed to make the bug occur (by injecting random
212high-frequency YUV data into the compressor), it was reproducible only once in
213about every 25 million iterations.
214
DRCfe80ec22014-08-21 15:51:47 +0000215[16] Fixed an oversight in the TurboJPEG C wrapper: if any of the JPEG
216compression functions was called repeatedly with the same
217automatically-allocated destination buffer, then TurboJPEG would erroneously
218assume that the jpegSize parameter was equal to the size of the buffer, when in
219fact that parameter was probably equal to the size of the most recently
220compressed JPEG image. If the size of the previous JPEG image was not as large
221as the current JPEG image, then TurboJPEG would unnecessarily reallocate the
222destination buffer.
223
DRCf610d612013-04-26 10:33:29 +0000224
DRC96573d02013-08-11 23:23:41 +00002251.3.1
226=====
227
228[1] On Un*x systems, 'make install' now installs the libjpeg-turbo libraries
229into /opt/libjpeg-turbo/lib32 by default on any 32-bit system, not just x86,
230and into /opt/libjpeg-turbo/lib64 by default on any 64-bit system, not just
231x86-64. You can override this by overriding either the 'prefix' or 'libdir'
232configure variables.
233
DRC4d877932013-09-19 22:55:57 +0000234[2] The Windows installer now places a copy of the TurboJPEG DLLs in the same
235directory as the rest of the libjpeg-turbo binaries. This was mainly done
236to support TurboVNC 1.3, which bundles the DLLs in its Windows installation.
237When using a 32-bit version of CMake on 64-bit Windows, it is impossible to
238access the c:\WINDOWS\system32 directory, which made it impossible for the
239TurboVNC build scripts to bundle the 64-bit TurboJPEG DLL.
240
DRCcadabd42013-09-28 03:10:31 +0000241[3] Fixed a bug whereby attempting to encode a progressive JPEG with arithmetic
242entropy coding (by passing arguments of -progressive -arithmetic to cjpeg or
243jpegtran, for instance) would result in an error, "Requested feature was
244omitted at compile time".
DRC1370f102013-09-24 03:21:38 +0000245
DRC7ebf2942013-11-21 18:32:48 +0000246[4] Fixed a couple of issues whereby malformed JPEG images would cause
DRC43d8cf42013-11-21 18:34:39 +0000247libjpeg-turbo to use uninitialized memory during decompression.
248
DRC38c99702014-02-11 09:45:18 +0000249[5] Fixed an error ("Buffer passed to JPEG library is too small") that occurred
250when calling the TurboJPEG YUV encoding function with a very small (< 5x5)
251source image, and added a unit test to check for this error.
252
DRCd45c5492014-03-11 06:21:46 +0000253[6] The Java classes should now build properly under Visual Studio 2010 and
254later.
255
DRCde23dd82014-03-22 20:43:03 +0000256[7] Fixed an issue that prevented SRPMs generated using the in-tree packaging
257tools from being rebuilt on certain newer Linux distributions.
258
259[8] Numerous minor fixes to eliminate compilation and build/packaging system
260warnings, fix cosmetic issues, improve documentation clarity, and other general
261source cleanup.
262
DRC96573d02013-08-11 23:23:41 +0000263
DRC0bf58f22013-02-06 23:51:08 +00002641.3.0
265=====
266
267[1] 'make test' now works properly on FreeBSD, and it no longer requires the
268md5sum executable to be present on other Un*x platforms.
269
DRCd7a642b2013-04-24 06:40:25 +0000270[2] Overhauled the packaging system:
DRC764e1e22013-04-19 04:25:14 +0000271-- To avoid conflict with vendor-supplied libjpeg-turbo packages, the
272official RPMs and DEBs for libjpeg-turbo have been renamed to
DRCd7a642b2013-04-24 06:40:25 +0000273"libjpeg-turbo-official".
274-- The TurboJPEG libraries are now located under /opt/libjpeg-turbo in the
275official Linux and Mac packages, to avoid conflict with vendor-supplied
276packages and also to streamline the packaging system.
277-- Release packages are now created with the directory structure defined
278by the configure variables "prefix", "bindir", "libdir", etc. (Un*x) or by the
279CMAKE_INSTALL_PREFIX variable (Windows.) The exception is that the docs are
280always located under the system default documentation directory on Un*x and Mac
281systems, and on Windows, the TurboJPEG DLL is always located in the Windows
282system directory.
DRC764e1e22013-04-19 04:25:14 +0000283-- To avoid confusion, official libjpeg-turbo packages on Linux/Unix platforms
284(except for Mac) will always install the 32-bit libraries in
285/opt/libjpeg-turbo/lib32 and the 64-bit libraries in /opt/libjpeg-turbo/lib64.
DRCd7a642b2013-04-24 06:40:25 +0000286-- Fixed an issue whereby, in some cases, the libjpeg-turbo executables on Un*x
287systems were not properly linking with the shared libraries installed by the
288same package.
289-- Fixed an issue whereby building the "installer" target on Windows when
290WITH_JAVA=1 would fail if the TurboJPEG JAR had not been previously built.
291-- Building the "install" target on Windows now installs files into the same
292places that the installer does.
DRC764e1e22013-04-19 04:25:14 +0000293
DRC4c17a452013-04-25 08:55:31 +0000294[3] Fixed a Huffman encoder bug that prevented I/O suspension from working
295properly.
296
DRC0bf58f22013-02-06 23:51:08 +0000297
DRC84f71222012-12-31 09:44:31 +00002981.2.90 (1.3 beta1)
299==================
DRC27fb3fc2012-01-28 01:48:07 +0000300
301[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 +000030211/8, 3/2, 13/8, 7/4, 15/8, and 2) when decompressing. Note that the IDCT will
303not be SIMD-accelerated when using any of these new scaling factors.
DRC27fb3fc2012-01-28 01:48:07 +0000304
DRC575317b2012-06-15 22:00:47 +0000305[2] The TurboJPEG dynamic library is now versioned. It was not strictly
DRCfd407772012-03-23 03:24:39 +0000306necessary to do so, because TurboJPEG uses versioned symbols, and if a function
307changes in an ABI-incompatible way, that function is renamed and a legacy
308function is provided to maintain backward compatibility. However, certain
DRC5a84a0e2013-02-14 07:31:35 +0000309Linux distro maintainers have a policy against accepting any library that isn't
310versioned.
DRCfd407772012-03-23 03:24:39 +0000311
DRCfac3bea2012-09-24 02:27:55 +0000312[3] Extended the TurboJPEG Java API so that it can be used to compress a JPEG
313image from and decompress a JPEG image to an arbitrary position in a large
314image buffer.
DRC575317b2012-06-15 22:00:47 +0000315
DRC21868092012-07-03 20:02:49 +0000316[4] The tjDecompressToYUV() function now supports the TJFLAG_FASTDCT flag.
DRCe0419b52012-07-03 20:01:31 +0000317
DRCa394bf72012-08-07 18:44:24 +0000318[5] The 32-bit supplementary package for amd64 Debian systems now provides
DRC0a0f8d12012-08-07 18:42:07 +0000319symlinks in /usr/lib/i386-linux-gnu for the TurboJPEG libraries in /usr/lib32.
320This allows those libraries to be used on MultiArch-compatible systems (such as
321Ubuntu 11 and later) without setting the linker path.
322
DRC61e13412012-08-24 02:44:39 +0000323[6] The TurboJPEG Java wrapper should now find the JNI library on Mac systems
324without having to pass -Djava.library.path=/usr/lib to java.
325
DRCd9d1d672012-10-02 04:20:43 +0000326[7] TJBench has been ported to Java to provide a convenient way of validating
327the performance of the TurboJPEG Java API. It can be run with
328'java -cp turbojpeg.jar TJBench'.
329
DRCf73a27c2013-01-01 10:25:43 +0000330[8] cjpeg can now be used to generate JPEG files with the RGB colorspace
331(feature ported from jpeg-8d.)
332
DRC8cbf8932013-01-01 10:44:00 +0000333[9] The width and height in the -crop argument passed to jpegtran can now be
334suffixed with "f" to indicate that, when the upper left corner of the cropping
335region is automatically moved to the nearest iMCU boundary, the bottom right
336corner should be moved by the same amount. In other words, this feature causes
337jpegtran to strictly honor the specified width/height rather than the specified
338bottom right corner (feature ported from jpeg-8d.)
339
DRCf37e4da2013-01-01 10:52:29 +0000340[10] JPEG files using the RGB colorspace can now be decompressed into grayscale
341images (feature ported from jpeg-8d.)
342
DRC00c2cf32013-01-13 12:12:53 +0000343[11] Fixed a regression caused by 1.2.1[7] whereby the build would fail with
DRCb87a0b42013-01-13 12:15:58 +0000344multiple "Mismatch in operand sizes" errors when attempting to build the x86
345SIMD code with NASM 0.98.
346
DRCab706232013-01-18 23:42:31 +0000347[12] The in-memory source/destination managers (jpeg_mem_src() and
348jpeg_mem_dest()) are now included by default when building libjpeg-turbo with
349libjpeg v6b or v7 emulation, so that programs can take advantage of these
350functions without requiring the use of the backward-incompatible libjpeg v8
351ABI. The "age number" of the libjpeg-turbo library on Un*x systems has been
352incremented by 1 to reflect this. You can disable this feature with a
353configure/CMake switch in order to retain strict API/ABI compatibility with the
354libjpeg v6b or v7 API/ABI (or with previous versions of libjpeg-turbo.) See
355README-turbo.txt for more details.
356
DRC6e6b28c2014-12-19 17:34:30 +0000357[13] Added ARMv7s architecture to libjpeg.a and libturbojpeg.a in the official
DRCa2a2cd62013-02-04 22:29:57 +0000358libjpeg-turbo binary package for OS X, so that those libraries can be used to
359build applications that leverage the faster CPUs in the iPhone 5 and iPad 4.
360
DRC575317b2012-06-15 22:00:47 +0000361
3621.2.1
363=====
364
365[1] Creating or decoding a JPEG file that uses the RGB colorspace should now
366properly work when the input or output colorspace is one of the libjpeg-turbo
367colorspace extensions.
368
369[2] When libjpeg-turbo was built without SIMD support and merged (non-fancy)
370upsampling was used along with an alpha-enabled colorspace during
371decompression, the unused byte of the decompressed pixels was not being set to
3720xFF. This has been fixed. TJUnitTest has also been extended to test for the
373correct behavior of the colorspace extensions when merged upsampling is used.
374
375[3] Fixed a bug whereby the libjpeg-turbo SSE2 SIMD code would not preserve the
DRC4f240162012-04-26 19:50:37 +0000376upper 64 bits of xmm6 and xmm7 on Win64 platforms, which violated the Win64
377calling conventions.
378
DRC575317b2012-06-15 22:00:47 +0000379[4] Fixed a regression caused by 1.2.0[6] whereby decompressing corrupt JPEG
DRCdd2b6512012-05-30 20:36:42 +0000380images (specifically, images in which the component count was erroneously set
381to a large value) would cause libjpeg-turbo to segfault.
382
DRC575317b2012-06-15 22:00:47 +0000383[5] Worked around a severe performance issue with "Bobcat" (AMD Embedded APU)
DRC69799272012-06-13 01:21:29 +0000384processors. The MASKMOVDQU instruction, which was used by the libjpeg-turbo
385SSE2 SIMD code, is apparently implemented in microcode on AMD processors, and
386it is painfully slow on Bobcat processors in particular. Eliminating the use
387of this instruction improved performance by an order of magnitude on Bobcat
388processors and by a small amount (typically 5%) on AMD desktop processors.
389
DRC575317b2012-06-15 22:00:47 +0000390[6] Added SIMD acceleration for performing 4:2:2 upsampling on NEON-capable ARM
391platforms. This speeds up the decompression of 4:2:2 JPEGs by 20-25% on such
392platforms.
393
DRCde37e072012-06-18 00:08:18 +0000394[7] Fixed a regression caused by 1.2.0[2] whereby, on Linux/x86 platforms
395running the 32-bit SSE2 SIMD code in libjpeg-turbo, decompressing a 4:2:0 or
3964:2:2 JPEG image into a 32-bit (RGBX, BGRX, etc.) buffer without using fancy
397upsampling would produce several incorrect columns of pixels at the right-hand
398side of the output image if each row in the output image was not evenly
399divisible by 16 bytes.
DRC8126d0c2012-06-15 21:54:45 +0000400
DRC112a0bb2012-06-28 23:25:34 +0000401[8] Fixed an issue whereby attempting to build the SIMD extensions with Xcode
4024.3 on OS X platforms would cause NASM to return numerous errors of the form
403"'%define' expects a macro identifier".
404
DRC73d74c12012-06-29 23:46:38 +0000405[9] Added flags to the TurboJPEG API that allow the caller to force the use of
406either the fast or the accurate DCT/IDCT algorithms in the underlying codec.
407
DRC27fb3fc2012-01-28 01:48:07 +0000408
DRC1ca924a2011-11-29 08:58:27 +00004091.2.0
410=====
411
412[1] Fixed build issue with YASM on Unix systems (the libjpeg-turbo build system
413was not adding the current directory to the assembler include path, so YASM
414was not able to find jsimdcfg.inc.)
415
DRCebfe9e42011-12-01 10:58:36 +0000416[2] Fixed out-of-bounds read in SSE2 SIMD code that occurred when decompressing
417a JPEG image to a bitmap buffer whose size was not a multiple of 16 bytes.
418This was more of an annoyance than an actual bug, since it did not cause any
419actual run-time problems, but the issue showed up when running libjpeg-turbo in
420valgrind. See http://crbug.com/72399 for more information.
421
DRCab64b622011-12-18 16:29:35 +0000422[3] Added a compile-time macro (LIBJPEG_TURBO_VERSION) that can be used to
423check the version of libjpeg-turbo against which an application was compiled.
424
DRC67ce3b22011-12-19 02:21:03 +0000425[4] Added new RGBA/BGRA/ABGR/ARGB colorspace extension constants (libjpeg API)
426and pixel formats (TurboJPEG API), which allow applications to specify that,
427when decompressing to a 4-component RGB buffer, the unused byte should be set
428to 0xFF so that it can be interpreted as an opaque alpha channel.
429
DRCa7466c92012-01-26 22:20:31 +0000430[5] Fixed regression issue whereby DevIL failed to build against libjpeg-turbo
431because libjpeg-turbo's distributed version of jconfig.h contained an INLINE
432macro, which conflicted with a similar macro in DevIL. This macro is used only
433internally when building libjpeg-turbo, so it was moved into config.h.
434
DRC12781cb2012-01-27 01:23:20 +0000435[6] libjpeg-turbo will now correctly decompress erroneous CMYK/YCCK JPEGs whose
436K component is assigned a component ID of 1 instead of 4. Although these files
437are in violation of the spec, other JPEG implementations handle them
438correctly.
439
DRC6e6b28c2014-12-19 17:34:30 +0000440[7] Added ARMv6 and ARMv7 architectures to libjpeg.a and libturbojpeg.a in
DRCa2a2cd62013-02-04 22:29:57 +0000441the official libjpeg-turbo binary package for OS X, so that those libraries can
442be used to build both OS X and iOS applications.
DRCc0526462012-02-10 01:44:55 +0000443
DRC1ca924a2011-11-29 08:58:27 +0000444
DRCf8e00552011-02-04 11:06:36 +00004451.1.90 (1.2 beta1)
446==================
447
DRC7bc3fb52011-10-28 06:45:53 +0000448[1] Added a Java wrapper for the TurboJPEG API. See java/README for more
449details.
DRCf8e00552011-02-04 11:06:36 +0000450
DRC7bc3fb52011-10-28 06:45:53 +0000451[2] The TurboJPEG API can now be used to scale down images during
452decompression.
DRCa3c30592011-02-07 08:06:16 +0000453
DRC15866ac2011-03-04 13:46:55 +0000454[3] Added SIMD routines for RGB-to-grayscale color conversion, which
455significantly improves the performance of grayscale JPEG compression from an
456RGB source image.
457
DRC3c21b082011-10-28 06:25:13 +0000458[4] Improved the performance of the C color conversion routines, which are used
459on platforms for which SIMD acceleration is not available.
DRC15866ac2011-03-04 13:46:55 +0000460
DRC3c21b082011-10-28 06:25:13 +0000461[5] Added a function to the TurboJPEG API that performs lossless transforms.
462This function is implemented using the same back end as jpegtran, but it
463performs transcoding entirely in memory and allows multiple transforms and/or
464crop operations to be batched together, so the source coefficients only need to
465be read once. This is useful when generating image tiles from a single source
466JPEG.
DRC15866ac2011-03-04 13:46:55 +0000467
DRC3c21b082011-10-28 06:25:13 +0000468[6] Added tests for the new TurboJPEG scaled decompression and lossless
DRC77fee432011-11-01 17:14:22 +0000469transform features to tjbench (the TurboJPEG benchmark, formerly called
470"jpgtest".)
DRC15866ac2011-03-04 13:46:55 +0000471
472[7] Added support for 4:4:0 (transposed 4:2:2) subsampling in TurboJPEG, which
473was necessary in order for it to read 4:2:2 JPEG files that had been losslessly
474transposed or rotated 90 degrees.
475
DRC67d1fc12011-05-24 14:13:01 +0000476[8] All legacy VirtualGL code has been re-factored, and this has allowed
477libjpeg-turbo, in its entirety, to be re-licensed under a BSD-style license.
DRCee269922011-04-26 23:46:38 +0000478
DRCf89dd1e2011-05-21 14:23:30 +0000479[9] libjpeg-turbo can now be built with YASM.
DRC56fb2372011-05-03 06:32:41 +0000480
DRCe5c6eb52011-08-17 20:59:56 +0000481[10] Added SIMD acceleration for ARM Linux and iOS platforms that support
482NEON instructions.
DRC321e0682011-05-03 08:47:43 +0000483
DRC3c21b082011-10-28 06:25:13 +0000484[11] Refactored the TurboJPEG C API and documented it using Doxygen. The
485TurboJPEG 1.2 API uses pixel formats to define the size and component order of
486the uncompressed source/destination images, and it includes a more efficient
487version of TJBUFSIZE() that computes a worst-case JPEG size based on the level
DRC5039d732013-01-21 23:42:12 +0000488of chrominance subsampling. The refactored implementation of the TurboJPEG API
DRC3c21b082011-10-28 06:25:13 +0000489now uses the libjpeg memory source and destination managers, which allows the
490TurboJPEG compressor to grow the JPEG buffer as necessary.
DRC9b28def2011-05-21 14:37:15 +0000491
DRCe9f9ec42011-05-25 06:02:50 +0000492[12] Eliminated errors in the output of jpegtran on Windows that occurred when
DRC7e3fd2f2011-05-25 06:04:43 +0000493the application was invoked using I/O redirection
494(jpegtran <input.jpg >output.jpg).
495
DRCb8c6ee32011-05-31 20:22:37 +0000496[13] The inclusion of libjpeg v7 and v8 emulation as well as arithmetic coding
DRC0571e172011-05-31 20:17:16 +0000497support in libjpeg-turbo v1.1.0 introduced several new error constants in
498jerror.h, and these were mistakenly enabled for all emulation modes, causing
DRCfa9ff8e2011-06-21 06:17:10 +0000499the error enum in libjpeg-turbo to sometimes have different values than the
500same enum in libjpeg. This represents an ABI incompatibility, and it caused
501problems with rare applications that took specific action based on a particular
502error value. The fix was to include the new error constants conditionally
503based on whether libjpeg v7 or v8 emulation was enabled.
DRC0571e172011-05-31 20:17:16 +0000504
DRCeed08612011-06-21 04:56:02 +0000505[14] Fixed an issue whereby Windows applications that used libjpeg-turbo would
DRCb7120ca2011-06-21 04:57:32 +0000506fail to compile if the Windows system headers were included before jpeglib.h.
507This issue was caused by a conflict in the definition of the INT32 type.
DRC6ca69532011-02-18 03:31:11 +0000508
DRC3c21b082011-10-28 06:25:13 +0000509[15] Fixed 32-bit supplementary package for amd64 Debian systems, which was
DRC68a086a2011-07-19 09:26:23 +0000510broken by enhancements to the packaging system in 1.1.
511
DRC3c21b082011-10-28 06:25:13 +0000512[16] When decompressing a JPEG image using an output colorspace of
DRCc08e8c12011-09-08 23:54:40 +0000513JCS_EXT_RGBX, JCS_EXT_BGRX, JCS_EXT_XBGR, or JCS_EXT_XRGB, libjpeg-turbo will
514now set the unused byte to 0xFF, which allows applications to interpret that
515byte as an alpha channel (0xFF = opaque).
516
DRCf8e00552011-02-04 11:06:36 +0000517
DRC6ee54592011-03-01 08:18:30 +00005181.1.1
519=====
520
521[1] Fixed a 1-pixel error in row 0, column 21 of the luminance plane generated
522by tjEncodeYUV().
523
DRC8071c392011-04-17 15:29:17 +0000524[2] libjpeg-turbo's accelerated Huffman decoder previously ignored unexpected
525markers found in the middle of the JPEG data stream during decompression. It
526will now hand off decoding of a particular block to the unaccelerated Huffman
527decoder if an unexpected marker is found, so that the unaccelerated Huffman
528decoder can generate an appropriate warning.
DRC6ee54592011-03-01 08:18:30 +0000529
DRC47aaf6f2011-03-22 05:40:39 +0000530[3] Older versions of MinGW64 prefixed symbol names with underscores by
DRC1da78582011-03-22 09:34:01 +0000531default, which differed from the behavior of 64-bit Visual C++. MinGW64 1.0
532has adopted the behavior of 64-bit Visual C++ as the default, so to accommodate
533this, the libjpeg-turbo SIMD function names are no longer prefixed with an
534underscore when building with MinGW64. This means that, when building
535libjpeg-turbo with older versions of MinGW64, you will now have to add
536-fno-leading-underscore to the CFLAGS.
537
DRCd8840112011-04-25 22:46:25 +0000538[4] Fixed a regression bug in the NSIS script that caused the Windows installer
539build to fail when using the Visual Studio IDE.
540
541[5] Fixed a bug in jpeg_read_coefficients() whereby it would not initialize
542cinfo->image_width and cinfo->image_height if libjpeg v7 or v8 emulation was
543enabled. This specifically caused the jpegoptim program to fail if it was
544linked against a version of libjpeg-turbo that was built with libjpeg v7 or v8
545emulation.
546
DRC049aef52011-04-25 22:41:14 +0000547[6] Eliminated excessive I/O overhead that occurred when reading BMP files in
548cjpeg.
549
DRC5ee81f42011-05-02 00:35:50 +0000550[7] Eliminated errors in the output of cjpeg on Windows that occurred when the
DRC34a8e352011-05-10 22:14:38 +0000551application was invoked using I/O redirection (cjpeg <inputfile >output.jpg).
DRC5ee81f42011-05-02 00:35:50 +0000552
DRCf5c3bb32011-03-18 05:59:07 +0000553
DRC958b2c02011-01-28 08:00:40 +00005541.1.0
555=====
DRCfa1d1832011-01-26 05:35:20 +0000556
DRCa49c4e52011-02-18 20:50:08 +0000557[1] The algorithm used by the SIMD quantization function cannot produce correct
558results when the JPEG quality is >= 98 and the fast integer forward DCT is
559used. Thus, the non-SIMD quantization function is now used for those cases,
560and libjpeg-turbo should now produce identical output to libjpeg v6b in all
561cases.
DRCe1716b82011-02-18 03:19:43 +0000562
DRCa49c4e52011-02-18 20:50:08 +0000563[2] Despite the above, the fast integer forward DCT still degrades somewhat for
DRC5039d732013-01-21 23:42:12 +0000564JPEG qualities greater than 95, so the TurboJPEG wrapper will now automatically
565use the slow integer forward DCT when generating JPEG images of quality 96 or
566greater. This reduces compression performance by as much as 15% for these
567high-quality images but is necessary to ensure that the images are perceptually
568lossless. It also ensures that the library can avoid the performance pitfall
569created by [1].
DRCa49c4e52011-02-18 20:50:08 +0000570
571[3] Ported jpgtest.cxx to pure C to avoid the need for a C++ compiler.
572
573[4] Fixed visual artifacts in grayscale JPEG compression caused by a typo in
DRCd9ee65c2011-04-05 07:01:26 +0000574the RGB-to-luminance lookup tables.
DRC8ed7b812011-02-15 08:31:34 +0000575
DRC240d82f2011-02-19 00:00:34 +0000576[5] The Windows distribution packages now include the libjpeg run-time programs
577(cjpeg, etc.)
578
DRC9cd2c422011-02-19 17:52:45 +0000579[6] All packages now include jpgtest.
DRC240d82f2011-02-19 00:00:34 +0000580
DRCe4d9b5b2011-02-25 06:17:17 +0000581[7] The TurboJPEG dynamic library now uses versioned symbols.
582
583[8] Added two new TurboJPEG API functions, tjEncodeYUV() and
584tjDecompressToYUV(), to replace the somewhat hackish TJ_YUV flag.
585
DRC2d94e262011-01-25 06:52:31 +0000586
DRC958b2c02011-01-28 08:00:40 +00005871.0.90 (1.1 beta1)
588==================
DRC766dc5c2010-10-12 02:50:18 +0000589
DRCf38eee02011-02-18 07:00:38 +0000590[1] Added emulation of the libjpeg v7 and v8 APIs and ABIs. See
DRCefa618e2010-10-18 08:41:11 +0000591README-turbo.txt for more details. This feature was sponsored by CamTrace SAS.
592
593[2] Created a new CMake-based build system for the Visual C++ and MinGW builds.
DRC766dc5c2010-10-12 02:50:18 +0000594
DRC2c62da32012-01-17 22:55:03 +0000595[3] Grayscale bitmaps can now be compressed from/decompressed to using the
596TurboJPEG API.
DRC09854f52010-11-04 22:39:59 +0000597
DRC01e69092011-01-06 01:19:43 +0000598[4] jpgtest can now be used to test decompression performance with existing
599JPEG images.
DRCe89bbae2010-11-12 10:18:08 +0000600
DRCd1c281a2010-11-17 22:44:40 +0000601[5] If the default install prefix (/opt/libjpeg-turbo) is used, then
602'make install' now creates /opt/libjpeg-turbo/lib32 and
603/opt/libjpeg-turbo/lib64 sym links to duplicate the behavior of the binary
604packages.
605
DRCec311932010-11-22 19:51:42 +0000606[6] All symbols in the libjpeg-turbo dynamic library are now versioned, even
607when the library is built with libjpeg v6b emulation.
608
DRC01e69092011-01-06 01:19:43 +0000609[7] Added arithmetic encoding and decoding support (can be disabled with
DRC245cfdf2010-11-23 17:11:06 +0000610configure or CMake options)
DRC66f97e62010-11-23 05:49:54 +0000611
DRC2c62da32012-01-17 22:55:03 +0000612[8] Added a TJ_YUV flag to the TurboJPEG API, which causes both the compressor
613and decompressor to output planar YUV images.
DRCfbb67472010-11-24 04:02:37 +0000614
DRC2c62da32012-01-17 22:55:03 +0000615[9] Added an extended version of tjDecompressHeader() to the TurboJPEG API,
616which allows the caller to determine the type of subsampling used in a JPEG
617image.
DRC50c657b2010-12-14 01:23:16 +0000618
DRC958b2c02011-01-28 08:00:40 +0000619[10] Added further protections against invalid Huffman codes.
DRCfa1d1832011-01-26 05:35:20 +0000620
DRC766dc5c2010-10-12 02:50:18 +0000621
DRC958b2c02011-01-28 08:00:40 +00006221.0.1
623=====
DRC0fbb28e2010-07-30 17:15:52 +0000624
625[1] The Huffman decoder will now handle erroneous Huffman codes (for instance,
626from a corrupt JPEG image.) Previously, these would cause libjpeg-turbo to
627crash under certain circumstances.
628
DRC81a50f72012-01-17 22:56:22 +0000629[2] Fixed typo in SIMD dispatch routines that was causing 4:2:2 upsampling to
DRC025a2792010-08-07 16:27:56 +0000630be used instead of 4:2:0 when decompressing JPEG images using SSE2 code.
DRC30959712010-08-07 16:06:56 +0000631
DRCbdb12882010-08-21 21:14:17 +0000632[3] configure script will now automatically determine whether the
633INCOMPLETE_TYPES_BROKEN macro should be defined.
634
DRC0fbb28e2010-07-30 17:15:52 +0000635
DRC958b2c02011-01-28 08:00:40 +00006361.0.0
637=====
DRC49597872010-05-17 20:47:57 +0000638
DRCc773d102010-06-05 06:58:22 +0000639[1] 2983700: Further FreeBSD build tweaks (no longer necessary to specify
640--host when configuring on a 64-bit system)
DRC49597872010-05-17 20:47:57 +0000641
DRCd5e964c2013-01-10 11:47:39 +0000642[2] Created symlinks in the Unix/Linux packages so that the TurboJPEG
DRCf12c7db2010-05-18 19:04:47 +0000643include file can always be found in /opt/libjpeg-turbo/include, the 32-bit
644static libraries can always be found in /opt/libjpeg-turbo/lib32, and the
64564-bit static libraries can always be found in /opt/libjpeg-turbo/lib64.
646
DRC4bf3b582010-06-05 01:03:23 +0000647[3] The Unix/Linux distribution packages now include the libjpeg run-time
648programs (cjpeg, etc.) and man pages.
649
DRC81a50f72012-01-17 22:56:22 +0000650[4] Created a 32-bit supplementary package for amd64 Debian systems, which
DRC4bf3b582010-06-05 01:03:23 +0000651contains just the 32-bit libjpeg-turbo libraries.
652
653[5] Moved the libraries from */lib32 to */lib in the i386 Debian package.
654
DRCdf3337c2010-07-02 09:13:58 +0000655[6] Include distribution package for Cygwin
DRC4bf3b582010-06-05 01:03:23 +0000656
DRCdf3337c2010-07-02 09:13:58 +0000657[7] No longer necessary to specify --without-simd on non-x86 architectures, and
DRC38ccf852010-06-10 19:49:49 +0000658unit tests now work on those architectures.
659
DRC49597872010-05-17 20:47:57 +0000660
DRC958b2c02011-01-28 08:00:40 +00006610.0.93
662======
DRC0f413b22010-04-06 20:05:39 +0000663
DRCc773d102010-06-05 06:58:22 +0000664[1] 2982659, Fixed x86-64 build on FreeBSD systems
DRC0f413b22010-04-06 20:05:39 +0000665
DRCc773d102010-06-05 06:58:22 +0000666[2] 2988188: Added support for Windows 64-bit systems
DRC1a2219e2010-05-10 20:03:36 +0000667
DRC0f413b22010-04-06 20:05:39 +0000668
DRC958b2c02011-01-28 08:00:40 +00006690.0.91
670======
DRCae19bf62010-03-15 11:40:31 +0000671
672[1] Added documentation to .deb packages
673
674[2] 2968313: Fixed data corruption issues when decompressing large JPEG images
675and/or using buffered I/O with the libjpeg-turbo decompressor
DRC958b2c02011-01-28 08:00:40 +0000676
677
6780.0.90
679======
680
681Initial release