Modules¶

Support for the following modules can be checked:

• pil: The Pillow core module, required for all functionality.

• tkinter: Tkinter support.

• freetype2: FreeType font support viaPIL.ImageFont.truetype().

• littlecms2: LittleCMS 2 support viaPIL.ImageCms.

• webp: WebP image support.

• avif: AVIF image support.

PIL.features.check_module(feature:str)→bool[source]¶

Checks if a module is available.

Parameters:

feature – The module to check for.

Returns:

True if available,False otherwise.

Raises:

ValueError – If the module is not defined in this version of Pillow.

PIL.features.version_module(feature:str)→str|None[source]¶

Parameters:

feature – The module to check for.

Returns:

The loaded version number as a string, orNone if unknown or not available.

Raises:

ValueError – If the module is not defined in this version of Pillow.

PIL.features.get_supported_modules()→list[str][source]¶

Returns:

A list of all supported modules.

Codecs¶

Support for these is only checked during Pillow compilation.If the required library was uninstalled from the system, thepil core module may fail to load instead.Except forjpg, the version number is checked at run-time.

Support for the following codecs can be checked:

• jpg: (compile time) Libjpeg support, required for JPEG based image formats. Only compile time version number is available.

• jpg_2000: (compile time) OpenJPEG support, required for JPEG 2000 image formats.

• zlib: (compile time) Zlib support, required for zlib compressed formats, such as PNG.

• libtiff: (compile time) LibTIFF support, required for TIFF based image formats.

PIL.features.check_codec(feature:str)→bool[source]¶

Checks if a codec is available.

Parameters:

feature – The codec to check for.

Returns:

True if available,False otherwise.

Raises:

ValueError – If the codec is not defined in this version of Pillow.

PIL.features.version_codec(feature:str)→str|None[source]¶

Parameters:

feature – The codec to check for.

Returns:

The version number as a string, orNone if not available.Checked at compile time forjpg, run-time otherwise.

Raises:

ValueError – If the codec is not defined in this version of Pillow.

PIL.features.get_supported_codecs()→list[str][source]¶

Returns:

A list of all supported codecs.

Features¶

Some of these are only checked during Pillow compilation.If the required library was uninstalled from the system, the relevant module may fail to load instead.Feature version numbers are available only where stated.

Support for the following features can be checked:

• libjpeg_turbo: (compile time) Whether Pillow was compiled against the libjpeg-turbo version of libjpeg. Compile-time version number is available.

• mozjpeg: (compile time) Whether Pillow was compiled against the MozJPEG version of libjpeg. Compile-time version number is available.

• zlib_ng: (compile time) Whether Pillow was compiled against the zlib-ng version of zlib. Compile-time version number is available.

• raqm: Raqm library, required forImageFont.Layout.RAQM inPIL.ImageFont.truetype(). Run-time version number is available for Raqm 0.7.0 or newer.

• libimagequant: (compile time) ImageQuant quantization support inPIL.Image.Image.quantize(). Run-time version number is available.

• xcb: (compile time) Support for X11 inPIL.ImageGrab.grab() via the XCB library.

PIL.features.check_feature(feature:str)→bool|None[source]¶

Checks if a feature is available.

Parameters:

feature – The feature to check for.

Returns:

True if available,False if unavailable,None if unknown.

Raises:

ValueError – If the feature is not defined in this version of Pillow.

PIL.features.version_feature(feature:str)→str|None[source]¶

Parameters:

feature – The feature to check for.

Returns:

The version number as a string, orNone if not available.

Raises:

ValueError – If the feature is not defined in this version of Pillow.

PIL.features.get_supported_features()→list[str][source]¶

Returns:

A list of all supported features.