【Python标准库】pillow中Image模块学习

简介: 【Python标准库】pillow中Image模块学习

模块介绍

Image模块提供了一个与PIL图像同名的类。该模块还提供了许多工厂函数,包括从文件中加载图像和创建新图像的函数。

相关概念

模式

图像的模式是一个字符串,它定义了图像中像素的类型和深度。每个像素使用位深度的全范围。所以1位像素的范围是0-1,8位像素的范围是0-255,以此类推。当前版本支持以下标准模式:

1         (1-bit pixels, black and white, stored with one pixel per byte)
L         (8-bit pixels, black and white)
P         (8-bit pixels, mapped to any other mode using a color palette)
RGB     (3x8-bit pixels, true color)
RGBA     (4x8-bit pixels, true color with transparency mask)
CMYK     (4x8-bit pixels, color separation)
YCbCr     (3x8-bit pixels, color video format)
         - Note that this refers to the JPEG, and not the ITU-R BT.2020, standard
LAB     (3x8-bit pixels, the L*a*b color space)
HSV        (3x8-bit pixels, Hue, Saturation, Value color space)
I         (32-bit signed integer pixels)
F         (32-bit floating point pixels)

波段

一幅图像可以由一个或多个波段的数据组成。PIL允许您在单个图像中存储多个波段,前提是它们都具有相同的尺寸和深度。例如,PNG图像可能有“R”、“G”、“B”和“a”波段,用于表示红、绿、蓝和alpha透明度值。许多操作分别作用于每个波段,例如,直方图。将每个像素看作每个波段有一个值通常是有用的。

坐标系

PIL使用笛卡尔像素坐标系,(0,0)位于左上角。注意,坐标指的是隐含的像素角;被称为(0,0)的像素的中心实际上位于(0.5,0.5)。
坐标通常以2元组(x, y)的形式传递给库。矩形以4元组表示,左上角先给出。例如,覆盖整个800x600像素图像的矩形被写成(0,0,800,600)。

相关方法

Image.new()

PIL.Image.new(mode, size, color=0)
作用:使用给定的模式和大小创建一个新图像。

参数:
- mode:要用于新图像的模式。(参考【相关概念】章节‘模式’概念)
- size:一个2元组,包含(宽度、高度)像素。
- color:使用什么颜色的图像。默认是黑色的。如果给定,这应该是一个单波段模式的整数或浮点值,以及一个多波段模式的元组(每个波段一个值)。当创建RGB图像时,你也可以使用ImageColor模块支持的颜色字符串。如果颜色为None,表示图像未初始化。(参考【相关概念】章节‘波段’概念)
返回值:
一个Image对象

Image.resize()

Image.resize(size, resample=None, box=None, reducing_gap=None)
作用:返回此图像大小调整后的副本。

参数:
- size:请求的像素大小,作为一个2元组:(宽度,高度)- resample:一个可选的重采样滤波器。 这可以是其中之一:PIL.Image.Resampling.NEAREST, PIL.Image.Resampling.BOX, PIL.Image.Resampling.BILINEAR, PIL.Image.Resampling.HAMMING, PIL.Image.Resampling.BICUBIC,PIL.Image.Resampling.LANCZOS.
如果图像有模式“1”或“P”,它总是被设置为PIL.Image.Resampling.NEAREST
如果图像模式指定了一些位,比如“I;16”,那么默认的过滤器是PIL.Image.Resampling.NEAREST
否则,默认过滤器为PIL.Image.Resampling.BICUBIC
- box:一个可选的4元浮点组,提供要缩放的源图像区域。这些值必须在(0,0,宽,高)矩形内。如果省略或为None,则使用整个源文件。
- reducing_gap:通过两个步骤调整图像的大小来应用优化。首先,使用reduce()将图像减少整数倍。第二,使用常规重采样调整大小。最后一步通过reducing_gap时间来改变大小。reducing_gap可以是None(不执行第一步)或者应该大于1.0。reducing_gap越大,结果越接近公平重采样。reducing_gap越小,调整大小就越快。当reducing_gap大于或等于3.0时,结果在大多数情况下与公平重采样没有区别。默认值为None(无优化)。
返回值:
一个Image对象

Image.putpixel()

Image.putpixel(xy, value)
作用:修改给定位置的像素。对于单波段图像,颜色是一个数值,对于多波段图像,颜色是一个元组。除此之外,RGB和RGBA元组也被接受用于P图像。
注意,这种方法相对较慢。对于更广泛的更改,使用paste()或ImageDraw模块代替。

参数:
- xy:像素坐标,给定为(x, y)。(参考【相关概念】章节‘坐标系’概念)
- value:像素值。

Image.tell()

Image.tell()
作用:返回当前帧号。
如果定义了,n_frames表示可用帧的数量。

返回值:帧号,从0开始。

Image.seek()

Image.seek(frame)
查找序列文件中的给定帧。如果您在序列的末尾以外寻找,该方法将引发EOFError异常。当序列文件被打开时,库会自动寻找第0帧。
如果定义了,n_frames表示可用帧的数量。

参数:
frame -帧号,从0开始。
raise
EOFError -如果调用试图在序列的末尾以外进行查找。

相关属性

.filename

Image.filename: str
源文件的文件名或路径。只有打开工厂函数创建的图像才有文件名属性。如果输入是一个类似于文件的对象,则filename属性被设置为空字符串。

.format

Image.format: Optional[str]
源文件的格式。对于库本身创建的图像(通过工厂函数,或在现有图像上运行方法),此属性设置为None。

.mode

Image.mode: str
图像模式。这是一个字符串,指定图像使用的像素格式。典型的值是“1”、“L”、“RGB”或“CMYK”。完整列表请参见模式。

.size

Image.size: tuple[int]
图像大小,以像素为单位。大小是一个二元组(宽度,高度)。

.width

Image.width: int
图像宽度,以像素为单位。

.height

Image.height: int
图像高度,以像素为单位。

.palette

Image.palette: Optional[PIL.ImagePalette.ImagePalette]
调色板表,如果有的话。如果mode是“P”或“PA”,这应该是ImagePalette类的一个实例。否则,它应该设置为None。

.info

Image.info: dict
保存与图像相关联的数据的字典。这个字典被文件处理程序用来传递从文件中读取的各种非图像信息。有关详细信息,请参阅各种文件处理程序的文档。
大多数方法在返回新图像时忽略字典;因为键不是标准化的,所以方法不可能知道操作是否影响字典。如果以后需要这些信息,请保持对open方法返回的info字典的引用。
除非在其他地方注明,否则此字典不会影响保存文件。

.is_animated

Image.is_animated: bool
如果该图像有多个帧,则为True,否则为False。
此属性仅由支持动画图像的图像插件定义。如果插件不支持加载动画图像,那么这个属性可能是未定义的,即使给定的格式支持动画图像。
假设这个属性不存在于所有的图像,使用getattr(image, "is_animated", False)来检查Pillow是否能够感知图像中的多帧,而不管它的格式。

.n_frames

Image.n_frames: int
图像中的帧数。
此属性仅由支持动画图像的图像插件定义。如果插件不支持加载动画图像,那么这个属性可能是未定义的,即使给定的格式支持动画图像。
假设这个属性并不存在于所有的图像中,使用getattr(image, "n_frames",1)来检查Pillow在图像中能够感知的帧数,而不管图像的格式。

相关文章
|
4天前
|
JSON API 数据格式
30天拿下Python之requests模块
30天拿下Python之requests模块
16 7
|
4天前
|
人工智能 数据可视化 搜索推荐
Python异常模块与包
Python异常模块与包
|
3天前
|
数据挖掘 Python
【Python】应用:pyproj地理计算库应用
这篇博客介绍了 `pyproj` 地理计算库的应用,涵盖地理坐标系统转换与地图投影。通过示例代码展示了如何进行经纬度与UTM坐标的互转,并利用 `pyproj.Geod` 计算两点间的距离及方位角,助力地理数据分析。 安装 `pyproj`:`pip install pyproj`。更多内容欢迎关注本博客,一起学习进步! Pancake 🍰 不迷路。😉*★,°*:.☆( ̄▽ ̄)/$:*.°★* 😏
|
3天前
|
Linux Python Windows
一个Python模块Pendulum的问题
一个Python模块Pendulum的问题
|
4天前
|
数据挖掘 API 数据处理
Python 数据分析及预处理常用库
Python自身数据分析功能有限,需借助第三方库增强。常用库包括NumPy、pandas、Matplotlib等。NumPy由Numeric发展而来,提供了多维数组对象及各种API,支持高效的数据处理,如数学、逻辑运算等,常作为其他高级库如pandas和Matplotlib的依赖库。其内置函数处理速度极快,建议优先使用以提升程序效率。
7 0
|
4天前
|
API Python
30天拿下Python之matplotlib模块
30天拿下Python之matplotlib模块
|
4天前
|
SQL 数据处理 数据库
30天拿下Python之pandas模块
30天拿下Python之pandas模块
|
4天前
|
存储 索引 Python
30天拿下Python之numpy模块
30天拿下Python之numpy模块
|
4天前
|
开发者 Python
30天拿下Python之logging模块
30天拿下Python之logging模块
|
3月前
|
API Python
Python学习日记(二:函数和逻辑操作)
Python中的函数和逻辑操作至关重要。函数包括可变和不可变参数。
下一篇
无影云桌面