Python Imaging Library 中文手册
这是PIL的官方手册,2005年5月6日发布。这个版本涵盖 PIL 1.1.5的全部内容。本中文手册来自 啄木鸟社区
你可以在PythonWare library到改文档其它格式的版本以及先前的版本。
原版出处:www.pythonware/library/pil/handbook/
1.Python Imaging Library 中文手册
2.第一部分:介绍
1.概览
1.介绍
2.图像归档处理
3.图像显示
4.图像处理
2.入门导引
1.使用 Image 类
2.读写图像
3.裁剪、粘贴和合并图像
4.滚动一幅图像
5.分离与合并通道
3.几何变换
1.简单的几何变换
2.transpose图像
4.颜变换
1.转换图像颜模式
5.图像增强
1.滤波器
1.使用滤波器
2.点操作
1.使用点变换
2.处理单个通道
3.增强
1.增强图像
6.图像序列
1.读取图像序列
2.一个序列迭代类
7.Postscript格式打印
1.Drawing Postscript
8.更多关于读取图像
1.控制解码器
3.概念
1.通道
2.模式
3.大小
4.坐标系统
5.调板
6.信息
7.滤波器
4.第二部分:模块手册
5.Image 模块
1.例子
2.函数
1.new
2.open
3.blend
4.composite
5.eval
6.frombuffer
7.fromstring
8.merge
3.方法
1.convert
2.copy
3.crop
4.draft
5.filter
6.fromstring
7.getbands
8.getbbox
9.getdata
10.getextrema
11.getpixel
12.histogram
13.load
14.offset
15.paste
16.point
17.putalpha
18.putdata
19.putpalette
20.putpixel
21.resize
22.rotate
23.save
24.seek
25.show
26.split
27.tell
28.thumbnail
29.tobitmap
30.tostring
31.transform
32.transpose
33.verify
4.属性
1.format
2.mode
3.size
4.palette
5.info
6.ImageChops 模块
1.函数
1.constant
2.duplicate
3.invert
4.lighter
5.darker
6.difference
7.multiply
8.screen
9.add
10.subtract
11.blend
12.composite
13.offset
7.ImageColor 模块
1.Colour Names
2.函数
1.getrgb
2.getcolor
8.ImageDraw 模块
1.Example
2.Concepts
1.Coordinates
2.Colour Names
3.Fonts
3.函数
1.Draw
4.方法
1.arc
2.bitmap
3.chord
4.ellipse
5.line
6.pieslice
7.point
8.polygon
9.rectangle
10.text
11.textsize
5.Options
1.outline
2.fill
3.font
6.Compatibility
1.ImageDraw
2.setink
3.setfill
4.setfont
9.ImageEnhance 模块
1.Example
2.Interface
3.The Color Class
4.The Brightness Class
5.The Contrast Class
6.The Sharpness Class
10.ImageFile 模块
1.Example
2.函数
1.Parser
3.方法
1.feed
11.ImageFileIO 模块
1.函数
12.ImageFilter 模块
1.Example
2.Filters
1.Kernel
2.RankFilter
3.MinFilter
4.MedianFilter
5.MaxFilter
13.ImageFont 模块
1.例子
2.函数
1.load
2.load_path
3.truetype
rotate属性
4.load_default
3.方法
1.getsize
2.getmask
14.ImageGrab 模块
1.函数
1.grab
2.grabclipboard
15.ImageOps 模块
1.函数
1.autocontrast
2.colorize
3.crop
4.deform
5.equalize
6.expand
7.fit
8.flip
9.grayscale
10.invert
11.mirror
12.posterize
13.solarize
16.ImagePath 模块
1.函数
1.Path
17.ImagePalette 模块
1.例子
2.类
1.ImagePalette
18.ImageSequence 模块
1.函数
1.Iterator
2.方法
1.Operator []
19.ImageStat 模块
1.函数
1.Stat
2.Attributes
1.extrema
2.count
3.sum
4.sum2
5.pixel
6.median
7.rms
8.var
9.stddev
20.ImageTk 模块
1.The BitmapImage Class
2.The PhotoImage Class
21.ImageWin 模块
1.Dib 类
1.Dib
2.方法
1.expose
2.draw
3.palette
4.paste
22.PSDraw 模块
1.Classes
1.PSDraw
2.PSDraw 方法
1.begin
2.end
3.line
4.rectangle
5.text
6.setfont
7.setink
8.setfill
23.ImageCrackCode 模块 (PIL Plus)
1.函数
1.CrackCode
2.方法 and attributes
1.area
2.bbox
3.caliper
4.centroid
5.edge
6.links
7.offset
8.start
9.top
10.hit
11.topath
12.getmask
13.getoutline
24.ImageMath 模块 (PIL Plus)
1.例子
2.函数
1.eval
3.表达式语法
1.运算符
2.内建函数
25.第三部分:工具手册
26.pildriver 工具
1.例子
2.The PILDriver Class
3.方法
4.pilconvert 工具
5.pilfile 工具
6.pilfont 工具
7.pilprint 工具
27.附录
1.软件许可证
2.技术支持
3.图像文件格式
4.编写自己的文件解码器
28.译注:中英文术语对照表
第一部分:介绍
∙PIL 1.1.5 | 2005年5月5日 | Fredrik Lundh
概览
介绍
Python Imaging Library 为Python解释器提供了图像处理的功能。
这个库提供了广泛的文件格式支持、高效的内部表示以及相当强大的图像处理功能。
这个图像处理库的核心被设计成为能够快速访问以几种基本像素类型表示的图像数据。它为通用图像处理工具提供了一个坚实基础。
让我们来看一些这个库可能的用途:
图像归档处理
Python Imaging Library适合编写图像归档和批处理应用程序。使用这个库可以创建缩略图
、转换文件格式、打印图像等。
当前版本的库能够识别和读取很多的图像格式。而能够输出的格式被特意限制于在交换和展示图像中最常用的格式上。
图像显示
当前版本的库包含Tk的PhotoImage 和 BitmapImage 接口,也包含Windows的DIB接口(可以同PythonWin和其他基于Windows的界面工具包一起使用)。还有一些其他的PIL支持提供了很多其他的GUI工具包。
为了调试方便,库中有一个 show 方法,它把图像保存到磁盘中,并调用外部显示工具来显示它。
图像处理
这个库提供了基本的图像处理功能,包括点操作、一些内建滤波核的滤波操作以及颜空间变换操作。
这个库也支持图像的缩放、旋转及任何仿射(affine)变换。
库中包含一个histogram方法,可以从图像中提取某些统计特征。用它可以实现自动的对比度增强以及全局统计分析功能。
入门导引
使用 Image 类
Python Imaging Library中最重要的类是Image 类,它定义在与它同名的模块中。有多种创建这个类的对象的方法:可以从文件中读取得到,也可以从其他图像经处理得到,或者创建一个全新的。
要从文件读取图像,可以使用Image 模块提供的open 函数。
切换行号显示
1 >>> import Image
2 >>> im = Image.open("lena.ppm")
3
如果成功,这个函数返回一个Image 对象。可以使用这个对象的属性来查看文件的内容。
切换行号显示
1 >>> print im.format, im.size, im.mode
2 PPM (512, 512) RGB
3
format 属性表示图像的原始格式。如果图像不是从文件中读取的,则它被设置成 None。size 属性是一个2元组,表示图像的宽度和高度 (以像素为单位)。mode 属性定义图像的彩通道的数量与名字,同时也包括像素的类型和颜深度信息。通常来说,灰度图像的mode是"L" (luminance),真彩图像的mode是 "RGB" ,而用来打印的图像的mode是"CMYK"。
如果文件不能打开,会抛出一个IOError 异常。
一旦有了一个Image 类的对象,接下来就可以使用这个类定义的方法来处理和操作图像了。比如说,显示刚才打开的文件:
切换行号显示
1 >>> im.show()
2
(show 的标准实现不是很高效,因为它先将图像保存成一个临时文件,然后调用 xv 程序来显示图像。如果你没有安装xv ,它甚至不能工作。然而如果它可用,它将是非常方便的出错和测试的工具。)
接下来的内容将对库中提供的一些函数进行一个概述。
读写图像
Python Imaging Library 支持很广泛的图象文件格式。要从磁盘上读取文件,使用 Image 模块提供的open 函数。你不必了解你要打开的文件的格式,库会自动根据文件的内容来确
定图像的格式。
要保存文件,使用Image 类的save 方法。保存文件时,文件名就变得非常重要了。除非你指定了格式,否则库会根据文件扩展名来决定使用哪种格式存储。
将文件转换成 JPEG
切换行号显示
1 import os, sys
2 import Image
3
4 for infile in sys.argv[1:]:
5 f, e = os.path.splitext(infile)
6 outfile = f + ".jpg"
7 if infile != outfile:
8 try:
9 Image.open(infile).save(outfile)
10 except IOError:
11 print "cannot convert", infile
12
save 方法可以带第二个参数,用来显式指定要保存的文件的格式。如果要使用非标准的扩展名,就必须这样指定文件格式:
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论