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]

傳回:

所有支援功能的列表。