Python Imaging Library中文手册、PIL中文手册、python图像处理

PythonImagingLibrary中文手册这是PIL的官方手册，2005年5月6日发布。这个版本涵盖PIL1.1.5的全部内容。本中文手册来自Woodpecker.org.cn啄木鸟社区你可以在PythonWarelibrary找到改文档其它格式的版本以及先前的版本。原版出处：目录1.PythonImagingLibrary中文手册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.DrawingPostscript8.更多关于读取图像1.控制解码器3.概念1.通道2.模式3.大小4.坐标系统5.调色板6.信息7.滤波器4.第二部分：模块手册5.Image模块1.例子2.函数1.new2.open3.blend4.composite5.eval6.frombuffer7.fromstring8.merge3.方法1.convert2.copy3.crop4.draft5.filter6.fromstring7.getbands8.getbbox9.getdata10.getextrema11.getpixel12.histogram13.load14.offset15.paste16.point17.putalpha18.putdata19.putpalette20.putpixel21.resize22.rotate23.save24.seek25.show26.split27.tell28.thumbnail29.tobitmap30.tostring31.transform32.transpose33.verify4.属性1.format2.mode3.size4.palette5.info6.ImageChops模块1.函数1.constant2.duplicate3.invert4.lighter5.darker6.difference7.multiply8.screen9.add10.subtract11.blend12.composite13.offset7.ImageColor模块1.ColourNames2.函数1.getrgb2.getcolor8.ImageDraw模块1.Example2.Concepts1.Coordinates2.ColourNames3.Fonts3.函数1.Draw4.方法1.arc2.bitmap3.chord4.ellipse5.line6.pieslice7.point8.polygon9.rectangle10.text11.textsize5.Options1.outline2.fill3.font6.Compatibility1.ImageDraw2.setink3.setfill4.setfont9.ImageEnhance模块1.Example2.Interface3.TheColorClass4.TheBrightnessClass5.TheContrastClass6.TheSharpnessClass10.ImageFile模块1.Example2.函数1.Parser3.方法1.feed11.ImageFileIO模块1.函数12.ImageFilter模块1.Example2.Filters1.Kernel2.RankFilter3.MinFilter4.MedianFilter5.MaxFilter13.ImageFont模块1.例子2.函数1.load2.load_path3.truetype4.load_default3.方法1.getsize2.getmask14.ImageGrab模块1.函数1.grab2.grabclipboard15.ImageOps模块1.函数1.autocontrast2.colorize3.crop4.deform5.equalize6.expand7.fit8.flip9.grayscale10.invert11.mirror12.posterize13.solarize16.ImagePath模块1.函数1.Path17.ImagePalette模块1.例子2.类1.ImagePalette18.ImageSequence模块1.函数1.Iterator2.方法1.Operator[]19.ImageStat模块1.函数1.Stat2.Attributes1.extrema2.count3.sum4.sum25.pixel6.median7.rms8.var9.stddev20.ImageTk模块1.TheBitmapImageClass2.ThePhotoImageClass21.ImageWin模块1.Dib类1.Dib2.方法1.expose2.draw3.palette4.paste22.PSDraw模块1.Classes1.PSDraw2.PSDraw方法1.begin2.end3.line4.rectangle5.text6.setfont7.setink8.setfill23.ImageCrackCode模块(PILPlus)1.函数1.CrackCode2.方法andattributes1.area2.bbox3.caliper4.centroid5.edge6.links7.offset8.start9.top10.hit11.topath12.getmask13.getoutline24.ImageMath模块(PILPlus)1.例子2.函数1.eval3.表达式语法1.运算符2.内建函数25.第三部分：工具手册26.pildriver工具1.例子2.ThePILDriverClass3.方法4.pilconvert工具5.pilfile工具6.pilfont工具7.pilprint工具27.附录1.软件许可证2.技术支持3.图像文件格式4.编写自己的文件解码器28.译注：中英文术语对照表第一部分：介绍PIL1.1.5|2005年5月5日|FredrikLundh概览介绍PythonImagingLibrary为Python解释器提供了图像处理的功能。这个库提供了广泛的文件格式支持、高效的内部表示以及相当强大的图像处理功能。这个图像处理库的核心被设计成为能够快速访问以几种基本像素类型表示的图像数据。它为通用图像处理工具提供了一个坚实基础。让我们来看一些这个库可能的用途：图像归档处理PythonImagingLibrary适合编写图像归档和批处理应用程序。使用这个库可以创建缩略图、转换文件格式、打印图像等。当前版本的库能够识别和读取很多的图像格式。而能够输出的格式被特意限制于在交换和展示图像中最常用的格式上。图像显示当前版本的库包含Tk的PhotoImage和BitmapImage接口，也包含Windows的DIB接口（可以同PythonWin和其他基于Windows的界面工具包一起使用）。还有一些其他的PIL支持提供了很多其他的GUI工具包。为了调试方便，库中有一个show方法，它把图像保存到磁盘中，并调用外部显示工具来显示它。图像处理这个库提供了基本的图像处理功能，包括点操作、一些内建滤波核的滤波操作以及颜色空间变换操作。这个库也支持图像的缩放、旋转及任何仿射（affine）变换。库中包含一个histogram方法，可以从图像中提取某些统计特征。用它可以实现自动的对比度增强以及全局统计分析功能。入门导引使用Image类PythonImagingLibrary中最重要的类是Image类，它定义在与它同名的模块中。有多种创建这个类的对象的方法：可以从文件中读取得到，也可以从其他图像经处理得到，或者创建一个全新的。要从文件读取图像，可以使用Image模块提供的open函数。切换行号显示1importImage2im=Image.open(lena.ppm)3如果成功，这个函数返回一个Image对象。可以使用这个对象的属性来查看文件的内容。切换行号显示1printim.format,im.size,im.mode2PPM(512,512)RGB3format属性表示图像的原始格式。如果图像不是从文件中读取的，则它被设置成None。size属性是一个2元组，表示图像的宽度和高度（以像素为单位）。mode属性定义图像的色彩通道的数量与名字，同时也包括像素的类型和颜色深度信息。通常来说，灰度图像的mode是L(luminance)，真彩色图像的mode是RGB，而用来打印的图像的mode是CMYK。如果文件不能打开，会抛出一个IOError异常。一旦有了一个Image类的对象，接下来就可以使用这个类定义的方法来处理和操作图像了。比如说，显示刚才打开的文件：切换行号显示1im.show()2（show的标准实现不是很高效，因为它先将图像保存成一个临时文件，然后调用xv程序来显示图像。如果你没有安装xv，它甚至不能工作。然而如果它可用，它将是非常方便的出错和测试的工具。）接下来的内容将对库中提供的一些函数进行一个概述。读写图像PythonImagingLibrary支持很广泛的图象文件格式。要从磁盘上读取文件，使用Image模块提供的open函数。你不必了解你要打开的文件的格式，库会自动根据文件的内容来确定图像的格式。要保存文件，使用Image类的save方法。保存文件时，文件名就变得非常重要了。除非你指定了格式，否则库会根据文件扩展名来决定使用哪种格式存储。将文件转换成JPEG切换行号显示1importos,sys2importImage34forinfileinsys.argv[1:]:5f,e=os.path.splitext(infile)6outfile=f+.jpg7ifinfile!=outfile:8try:9Image.open(infile).save(outfile)10exceptIOError:11printcannotconvert,infile12save方法可以带第二个参数，用来显式指定要保存的文件的格式。如果要使用非标准的扩展名，就必须这样指定文件格式：创建JPEG缩略图切换行号显示1importos,sys2importImage34size=128,12856forinfileinsys.argv[1:]:7outfile=os.path.splitext(infile)[0]+.thumbnail8ifinfile!=outfile:9try:10im=Image.open(infile)11im.thumbnail(size)12im.save(outfile,JPEG)13exceptIOError:14printcannotcreatethumbnailfor,infile15有一点非常重要的需要注意的是，除非到了迫不得已的时候，库不会装载或者解码原始的点阵数据。当打开一个文件的时候，库会读取文件头以获得文件格式、颜色模式、图像大小等属性，但是文件剩余的部分不会马上处理。这意味着，文件打开操作是很快的，它与文件的大小、压缩的类型没有关系。这里是一个快速识别一系列图像文件的简单例子：识别图像文件切换行号显示1importsys2importImage34forinfileinsys.argv[1:]:5try:6im=Image.open(infile)7printinfile,im.format,%dx%d%im.size,im.mode