查看“Pillow”的源代码

Pillow是一个[[Python]]的图像处理库，PIL(Python Imaging Library)2011年停止更新，随后Pillow分支了PIL并添加了Python 3的支持，现在成为PIL的替代品。

==简介==
===时间轴===

===安装===
使用[[pip]]安装：
<syntaxhighlight lang="bash" >
pip install --upgrade pip
pip install --upgrade Pillow
</syntaxhighlight>
{{了解更多
|[https://pillow.readthedocs.io/en/stable/installation.html Pillow 文档：安装]
}}

==快速入门==

===图片格式转换===
<syntaxhighlight lang="python" >
from PIL import Image

im = Image.open("test.webp")
print(im.size, im.format)     # 打印图片尺寸，格式
im.show()                     # 显示图片
im.save("test.jpg")
</syntaxhighlight>
{{了解更多
|[https://pillow.readthedocs.io/en/stable/handbook/tutorial.html Pillow 文档：Image类的使用]
}}

==Image类==
===生成Image类===
{| class="wikitable" 
! 名称
! 描述
! 示例
|-
| [https://pillow.readthedocs.io/en/stable/reference/Image.html#PIL.Image.open open()]
|从图像文件生成Image对象  <br /><br /><code>PIL.Image.open(fp, mode='r', formats=None)</code> 
| <syntaxhighlight lang="python" >
from PIL import Image

im = Image.open("test.jpg")
</syntaxhighlight>
|-
| [https://pillow.readthedocs.io/en/stable/reference/Image.html#PIL.Image.new new()]
| 生成一个新的Image对象  <br /><br /><code>PIL.Image.new(mode, size, color=0)</code>
| 
|-
| [https://pillow.readthedocs.io/en/stable/reference/Image.html#PIL.Image.frombytes frombytes()]
| 
| 
|}

{{了解更多
|[https://pillow.readthedocs.io/en/stable/reference/Image.html#PIL.Image.Image Pillow 文档：The Image Class]
|[https://pillow.readthedocs.io/en/stable/handbook/tutorial.html#more-on-reading-images Pillow 文档：详细了解如何读取图片]
}}

===属性===
以下示例使用如下代码：
<syntaxhighlight lang="python" >
from PIL import Image

im = Image.open("test.jpg")
print(im.format)
</syntaxhighlight>
{| class="wikitable" 
! 名称
! 描述
! 示例
|-
| filename
| 文件名
| 
|-
| format
| 文件格式
| <code>im.format</code> 返回'jpg'
|-
| size
| 
| 
|-
| 
| 
| 
|}

{{了解更多
|[https://pillow.readthedocs.io/en/stable/reference/Image.html#image-attributes Pillow 文档：Image属性]
}}

===方法===
{| class="wikitable" 
! 名称
! 描述
! 示例
|-
| save()
| 保存图片。
| 
|-
| crop()
| 裁剪图片。 输入参数4元组，坐标为（左、上、右、 下），其中 （0， 0） 中的 左上角，数值为像素。
| <syntaxhighlight lang="python" >
box = (100, 100, 400, 400)
region = im.crop(box)
</syntaxhighlight>
|-
| 
| 
| 
|-
| getexif()
| 
| 打印照片Exif信息<syntaxhighlight lang="python" >
from PIL import Image
from PIL.ExifTags import TAGS

img = Image.open(r'test.JPG')
exif = img.getexif()

for k, v in exif.items():
    print('{}: {}'.format(TAGS[k], v))
</syntaxhighlight>
|-
| 
| 
| 
|-
| 
| 
| 
|}
{{了解更多
|[https://pillow.readthedocs.io/en/stable/handbook/tutorial.html * Pillow 文档：教程]
|[https://pillow.readthedocs.io/en/stable/reference/Image.html#the-image-class Pillow API：The Image Class]
}}

==资源==
===官网===
* Pillow 官网：https://python-pillow.org/
* Pillow 文档：https://pillow.readthedocs.io/en/stable/

===网站===