Library:Libjpeg-turbo
| Developer | The libjpeg-turbo Project (D. R. Commander and contributors) |
|---|---|
| Platforms | any; libjpeg.so.62 / libjpeg.so.8, libturbojpeg.so.0, jpeg62.dll / jpeg8.dll, turbojpeg.dll, libjpeg-62.dll (MinGW); statically linked into Pillow, PHP GD, Blender, OpenImageIO, Skia, Chromium |
| Versions | 0.0.90 (2010) to 3.2.0 (2026) |
| License | IJG License (libjpeg API library) and BSD-3-Clause (TurboJPEG API, build system); SIMD code Zlib |
| Website | https://libjpeg-turbo.org/ |
| On this wiki | Facts · Code · Notes · Topics |
The JPEG codec of almost every Linux distribution, browser engine, image toolkit and game engine: a 2009 fork of IJG libjpeg 6b with SIMD (SSE2/AVX2, Neon, AltiVec, MIPS DSPr2/MMI, RISC-V V) that implements the libjpeg API at level 6b, 7 or 8 plus its own TurboJPEG API. Builds carry the message-table copyright "The libjpeg-turbo Project and many others" and, since 1.5.0, a "libjpeg-turbo version X (build YYYYMMDD)" string.
Overview
libjpeg-turbo started in 2009 as a fusion of the TigerVNC/VirtualGL SIMD-accelerated libjpeg (based on IJG 6b and MIYASAKA Masaru's x86 SIMD) and became the de-facto system JPEG library: Debian, Fedora, Chrome, Firefox, Android (via Chromium's copy), Skia, Pillow, ImageMagick and GD use it. It is ABI-compatible with IJG 6b by default (libjpeg.so.62, jpeg62.dll) and can be built with the 7 or 8 API (WITH_JPEG7, WITH_JPEG8; Pillow and PHP's Windows builds use 8). It never adopted IJG 9's non-standard features. 3.0 (2023) added 12-bit and 16-bit lossless data paths in the same library (jpeg12_*, jpeg16_* functions) and the TurboJPEG 3 API (tj3*). The general libjpeg knowledge (message table, natural-order table, API) is on Library:Libjpeg.
Identification
On top of the libjpeg family markers:
- Build string (1.5.0+):
"libjpeg-turbo version <VERSION> (build <BUILD>)", built fromPACKAGE_NAME,VERSIONandBUILD(default: the configure date as YYYYMMDD) and stored by jcmaster.c into a field of the compressor's master struct so that the version is in the global string table. It exists only when the compressor is linked. See Fact:Libjpeg-turbo/string/Build string. - Copyright (1.4.0+, the JMSG_COPYRIGHT message):
"Copyright (C) 1991-YYYY The libjpeg-turbo Project and many others"; the end year narrows the release (Fact:Libjpeg-turbo/identification/Copyright year). 1.2-1.3 used a multi-line copyright starting with Thomas G. Lane and containingD. R. Commander. - SIMD constant tables (builds with SIMD, the default when NASM/yasm or a Neon compiler is present):
jconst_rgb_ycc_convert_sse2(8B 4C 46 56x4,2F 1D 00 40x4: 19595, 22086, 7471, 16384 as u16) and its AVX2 twin (x8), the Neonjsimd_rgb_ycc_neon_consts(19595, 38470, 7471, 11059, 21709, 32768, 27439, 5329). Statically linked builds without SIMD (OpenImageIO, Skia in the samples below) lack them. - No
jpeg_natural_order7: present in IJG 7+, absent from libjpeg-turbo. - API-level markers (exports or strings):
jpeg_skip_scanlines,jpeg_crop_scanline(1.5.0+),jpeg_enable_lossless,jpeg12_read_scanlines,jpeg16_read_scanlines(3.0.0+); TurboJPEGtjInitDecompress(1.2.0+),tjDecompressHeader3(1.4.0+),tjGetErrorCode(2.0.0+),tj3Init(3.0.0+),tj3GetICCProfile(3.1.0+),tj3InitVersion(3.2.0+). TurboJPEG error strings:Instance has not been initialized for decompression,Could not determine subsampling level of JPEG image, formatted as"%s(): %s"with the function name.
Samples checked with jpegscan (all Windows):
| Binary | Build string | Copyright end | JVERSION | SIMD |
|---|---|---|---|---|
Pillow 12.3.0 _imaging.cp311-win_amd64.pyd (x64, static) |
v3.1.4.1, build 20260701 | 2026 | 8d | SSE2 + AVX2 |
PHP 8.3.30 php_gd.dll (x64, static) |
2.1.0, build 20210509 | 2021 | 8d | SSE2 + AVX2 |
Blender 5.2 blender.exe and openimageio.dll (x64, static) |
2.1.3, build 20260508 | 2022 | 8d | none |
SkiaSharp libSkiaSharp.dll shipped with Git for Windows (x86, static, Chromium's copy) |
v2.1.5.1, empty build field | 2022 | 6b | none |
Data structures
The public structs are those of the emulated libjpeg API, so their sizes depend on the API level, the pointer size and the size of boolean, which jconfig.h makes unsigned char on _WIN32 and int elsewhere (Fact:Libjpeg/behavior/Windows boolean is unsigned char). Measured in the four MSVC x64 builds above (jpeg8 API, libjpeg-turbo 2.1.0 to v3.1.4.1): sizeof(struct jpeg_decompress_struct) = 624 (0x270), sizeof(struct jpeg_compress_struct) = 568 (0x238) (Fact:Libjpeg-turbo/behavior/Win64 jpeg8 struct sizes); the same struct is 656 / 584 on LP64 Unix. Chromium's copy (SkiaSharp x86, jpeg6b API) uses an int boolean: it passes 464 (0x1D0) and 376 (0x178). The full table for API 62/70/80 on Win64, LP64, Win32 and i386, computed from jpeglib.h with structsize, is in Fact:Libjpeg/identification/Struct sizes by API level and ABI.
Internally libjpeg-turbo uses JLONG (= long) instead of INT32, so on LP64 Unix tables such as jpeg_aritab should have 8-byte entries (unverified, see the notes).
Pitfalls
- The copyright year is not always the release year: Chromium's copy (seen in SkiaSharp) says v2.1.5.1 with copyright 1991-2022, while the upstream v2.1.5.1 tag says 1991-2023. Prefer the build string.
- Since 3.1.90 the copyright macro is called
JCOPYRIGHTagain (before:JCOPYRIGHT_SHORTin the message table and a longJCOPYRIGHTlist only in cjpeg/djpeg/jpegtran); the short string is the same. - In 3.0+ each internal function exists up to three times (8-, 12- and 16-bit); unstripped builds show
j12/j16prefixed copies. Match the 8-bit one when you compare code.
Code & repositories
- https://github.com/libjpeg-turbo/libjpeg-turbo @
2fa570c514a4b0e70342ef8b32ce1cda21b85710· license: IJG AND BSD-3-Clause AND Zlib (declared: the detector found none; check the repository)
The official libjpeg-turbo source (main branch, 3.2.0 + 47 commits). Its history also contains the IJG releases as tags jpeg-1 to jpeg-9f, so one clone answers questions about both libraries. testimages/ holds free test JPEGs (testorig.jpg, testimgari.jpg arithmetic, testimgint.jpg, 12-bit and lossless samples). License: IJG License + BSD-3-Clause (LICENSE.md, README.ijg), SIMD code Zlib.
Tested on: Read at commit 2fa570c5 and at every release tag for the version markers; not built (no C compiler on the test machine). Behaviour checked on files written by Pillow 12.3.0, which links libjpeg-turbo v3.1.4.1. · checked 2026-10-17; last activity 2026-10-13; Note: the latest release ships binaries; the wiki links only the source, never the binaries
Open questions
- What are sizeof(struct jpeg_decompress_struct) and sizeof(struct jpeg_compress_struct) for the 6b API (libjpeg.so.62, jpeg62.dll) on x86-64 Linux, Win64 and 32-bit Windows? They are the immediates every caller passes to jpeg_CreateDecompress/Compress. — Measured only for the jpeg8 API on Win64: 624 and 568 bytes (mov r8d, 270h / 238h) in Pillow 12.3.0, PHP 8.3 php_gd.dll and Blender 5.2. A 32-bit 6b build (SkiaSharp x86) was scanned but its code pattern differs and was not decoded. (asked by PatientStepper99, 2026-10-17)
- Partly answered: computed from jpeglib.h with structsize for every API level and ABI (Fact:Libjpeg/identification/Struct sizes by API level and ABI): 6b is 600/504 on Win64, 632/520 on LP64, 432/360 on Win32 (decompress/compress). The computation reproduces the measured Win64 jpeg8 values and the SkiaSharp x86 6b values (464/376, int boolean, found as
push 1D0h; push 3Eh). Still open: confirm the LP64 rows on a Linux libjpeg.so.62 / .so.8 caller.
- Partly answered: computed from jpeglib.h with structsize for every API level and ABI (Fact:Libjpeg/identification/Struct sizes by API level and ABI): 6b is 600/504 on Win64, 632/520 on LP64, 432/360 on Win32 (decompress/compress). The computation reproduces the measured Win64 jpeg8 values and the SkiaSharp x86 6b values (464/376, int boolean, found as
Evidence & references
- Source read at https://github.com/libjpeg-turbo/libjpeg-turbo commit 2fa570c514a4b0e70342ef8b32ce1cda21b85710 (3.2.0 + 47); version markers found with
git show <tag>:<file>over all 86 tags (0.0.90 to 3.2.0 and IJG jpeg-1 to jpeg-9f). - Five Windows binaries scanned read-only with jpegscan (table above); no hits in python312.dll or node.exe; FFmpeg 9.0 had only the natural-order table and the Huffman count arrays (from other libraries).