features 模块

PIL.features 模块可用于检测您的系统上哪些 Pillow 功能可用。

PIL.features.pilinfo(out: IO[str] | None = None, supported_formats: bool = True) → None

打印有关 Pillow 的此安装的信息。此函数可以使用 python3 -m PIL 调用。它也可以使用 python3 -m PIL.report 或 python3 -m PIL --report 调用，以使“supported_formats”设置为 False，省略所有支持的图像文件格式的列表。

参数:

• out – 要打印到的输出流。如果为 None，则默认为 sys.stdout。

• supported_formats – 如果为 True，则会打印所有支持的图像文件格式的列表。

PIL.features.check(feature: str) → bool | None

参数:

feature – 模块、编解码器或功能名称。

返回值:

如果模块、编解码器或功能可用，则为 True，否则为 False 或 None。

PIL.features.version(feature: str) → str | None

参数:

feature – 要检查的模块、编解码器或功能。

返回值:

版本号作为字符串，如果未知或不可用，则为 None。

PIL.features.get_supported() → list[str]

返回值:

所有支持的模块、功能和编解码器的列表。

模块

可以检查对以下模块的支持

• pil: Pillow 核心模块，所有功能都需要它。

• tkinter: Tkinter 支持。

• freetype2: 通过 PIL.ImageFont.truetype() 的 FreeType 字体支持。

• littlecms2: 通过 PIL.ImageCms 的 LittleCMS 2 支持。

• webp: WebP 图像支持。

PIL.features.check_module(feature: str) → bool

检查模块是否可用。

参数:

feature – 要检查的模块。

返回值:

如果可用，则为 True，否则为 False。

异常:

ValueError – 如果模块在此版本的 Pillow 中未定义。

PIL.features.version_module(feature: str) → str | None

参数:

feature – 要检查的模块。

返回值:

加载的版本号作为字符串，如果未知或不可用则为 None。

异常:

ValueError – 如果模块在此版本的 Pillow 中未定义。

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

返回值:

所有支持模块的列表。

编解码器

仅在 Pillow 编译期间检查对这些的支持。如果系统中卸载了所需的库，则 pil 核心模块可能会无法加载。除了 jpg 之外，版本号在运行时检查。

可以检查以下编解码器的支持情况

• jpg: (编译时) Libjpeg 支持，JPEG 基图像格式所需。仅编译时版本号可用。

• jpg_2000: (编译时) OpenJPEG 支持，JPEG 2000 图像格式所需。

• zlib: (编译时) Zlib 支持，zlib 压缩格式所需，例如 PNG。

• libtiff: (编译时) LibTIFF 支持，TIFF 基图像格式所需。

PIL.features.check_codec(feature: str) → bool

检查编解码器是否可用。

参数:

feature – 要检查的编解码器。

返回值:

如果可用，则为 True，否则为 False。

异常:

ValueError – 如果编解码器未在此版本的 Pillow 中定义。

PIL.features.version_codec(feature: str) → str | None

参数:

feature – 要检查的编解码器。

返回值:

版本号作为字符串，如果不可用则为 None。在编译时检查 jpg，否则在运行时检查。

异常:

ValueError – 如果编解码器未在此版本的 Pillow 中定义。

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

返回值:

所有支持编解码器的列表。

功能

其中一些仅在 Pillow 编译期间检查。如果系统中卸载了所需的库，则相关的模块可能会无法加载。仅在说明的地方提供功能版本号。

可以检查以下功能的支持情况

• libjpeg_turbo: (编译时) Pillow 是否针对 libjpeg 的 libjpeg-turbo 版本进行了编译。编译时版本号可用。

• raqm: Raqm 库，在 PIL.ImageFont.truetype() 中的 ImageFont.Layout.RAQM 所需。运行时版本号适用于 Raqm 0.7.0 或更高版本。

• libimagequant: (编译时) PIL.Image.Image.quantize() 中的 ImageQuant 量化支持。运行时版本号可用。

• xcb: (编译时) 通过 XCB 库在 PIL.ImageGrab.grab() 中对 X11 的支持。

• transp_webp: 已弃用。如果安装了 WebP 模块，则始终为 True。

• webp_mux: 已弃用。如果安装了 WebP 模块，则始终为 True。

• webp_anim: 已弃用。如果安装了 WebP 模块，则始终为 True。

PIL.features.check_feature(feature: str) → bool | None

检查功能是否可用。

参数:

feature – 要检查的功能。

返回值:

如果可用则为 True，如果不可用则为 False，如果未知则为 None。

异常:

ValueError – 如果功能未在此版本的 Pillow 中定义。

PIL.features.version_feature(feature: str) → str | None

参数:

feature – 要检查的功能。

返回值:

版本号作为字符串，如果不可用则为 None。

异常:

ValueError – 如果功能未在此版本的 Pillow 中定义。

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

返回值:

所有支持功能的列表。