ImageShow 模块

ImageShow 模块用于显示图像。所有默认查看器都会将要显示的图像转换为 PNG 格式。

PIL.ImageShow.show(image: Image, title: str | None = None, **options: Any) → bool

显示给定的图像。

参数：

• image – 一个图像对象。

• title – 可选标题。并非所有查看器都可以显示标题。

• **options – 附加查看器选项。

返回：

True 如果找到合适的查看器，否则为 False。

class PIL.ImageShow.IPythonViewer

用于 IPython 前端的查看器。

class PIL.ImageShow.WindowsViewer

Windows 上的默认查看器是 PNG 文件的默认系统应用程序。

class PIL.ImageShow.MacViewer

macOS 上使用 Preview.app 的默认查看器。

class PIL.ImageShow.UnixViewer

如果在基于 Unix 的系统上找到给定的命令，则可以注册以下查看器。

class XDGViewer

freedesktop.org xdg-open 命令。

class DisplayViewer

ImageMagick display 命令。此查看器支持 title 参数。

class GmDisplayViewer

GraphicsMagick gm display 命令。

class EogViewer

GNOME 图像查看器 eog 命令。

class XVViewer

X 查看器 xv 命令。此查看器支持 title 参数。

为了在基于 Unix 的系统上提供最大的功能，Pillow 不会自动删除从图像创建的临时文件。

PIL.ImageShow.register(viewer: type[Viewer] | Viewer, order: int = 1) → None

register() 函数用于注册额外的查看器。

from PIL import ImageShow
ImageShow.register(MyViewer())  # MyViewer will be used as a last resort
ImageShow.register(MySecondViewer(), 0)  # MySecondViewer will be prioritised
ImageShow.register(ImageShow.XVViewer(), 0)  # XVViewer will be prioritised

参数：

• viewer – 要注册的查看器。

• order – 零或负整数，用于将此查看器放在列表的开头，正整数用于将它放在列表的结尾。

class PIL.ImageShow.Viewer

查看器基类。

show(image: Image, **options: Any) → int

显示图像的主要函数。将给定图像转换为目标格式并显示。

format: str | None = None

要将图像转换为的格式。

options: dict[str, Any] = {}

用于转换图像的附加选项。

get_format(image: Image) → str | None

返回格式名称，或 None 以保存为 PGM/PPM。

get_command(file: str, **options: Any) → str

返回用于显示文件的命令。在基类中未实现。

save_image(image: Image) → str

保存到临时文件并返回文件名。

show_image(image: Image, **options: Any) → int

显示给定图像。

show_file(path: str, **options: Any) → int

显示给定文件。