Python－PIL－ImageDraw

python教程：http://www.runoob.com/python/python-lists.html

pillow文档：http://pillow.readthedocs.io/en/latest/reference/index.html

PIL （Python Imaging Library）是 Python 中最常用的图像处理库， Image 类是 PIL 库中一个非常重要的类，通过这个类来创建实例可以有直接载入图像文件，读取处理过的图像和通过抓取的方法得到的图像这三种方法。

导入 Image 模块。然后通过 Image 类中的 open 方法即可载入一个图像文件。如果载入文件失败，则会引起一个 IOError ；若无返回错误，则 open 函数返回一个 Image 对象。现在，我们可以通过一些对象属性来检查文件内容，即：

from PIL import Image

im = Image.open("j.jpg")＃加载图像
im.format, im.size, im.mode#图像格式，尺寸，模式
box = (100, 100, 200, 200)
region = im.crop(box)＃裁剪
region.show()
region = region.transpose(Image.ROTATE_180)
region.show()
im.paste(region, box)
im.show()　#显示图像
out = im.resize((128, 128))                     #ｒｅｓｉｚｅ
out = im.rotate(45)                             #逆时针旋转 45 度角。
out = im.transpose(Image.FLIP_LEFT_RIGHT)       #左右对换。
out = im.transpose(Image.FLIP_TOP_BOTTOM)       #上下对换。
out = im.transpose(Image.ROTATE_90)             #旋转 90 度角。
out = im.transpose(Image.ROTATE_180)            #旋转 180 度角。
out = im.transpose(Image.ROTATE_270)            #旋转 270 度角。
imfilter = im.filter(ImageFilter.DETAIL)
r,g,b=im.split()
im=Image.merge("RGB",(r,g,b))＃分离和合并颜色通道
cmyk = im.convert("CMYK")
gray = im.convert("L")＃颜色空间变换

为文件夹下所有图像建立缩略图

＃文件夹下所有ｊｐｇ文件　ｇｌｏｂ.glob(""),
#文件名分割　ｏｓ.path.splitext()
#图像打开：　PIL.Image.open(fp, mode='r')，延迟加载，只要在ｌｏａｄ（）的时候才能加载图像
＃

from PIL import Image
import glob, os

size = 128, 128

for infile in glob.glob("*.jpg"):
file, ext = os.path.splitext(infile)
im = Image.open(infile)
im.thumbnail(size)
im.save(file + ".thumbnail", "JPEG")

一、ImageDraw模块的概念

1、 Coordinates

绘图接口使用和PIL一样的坐标系统，即（0，0）为左上角。

2、 Colours

为了指定颜色，用户可以使用数字或者元组，对应用户使用函数Image.new或者Image.putpixel。对于模式为“1”，“L”和“I”的图像，使用整数。对于“RGB”图像，使用整数组成的3元组。对于“F”图像，使用整数或者浮点数。

对于调色板图像（模式为“P”），使用整数作为颜色索引。在1.1.4及其以后，用户也可以使用RGB 3元组或者颜色名称。绘制层将自动分配颜色索引，只要用户不绘制多于256种颜色。

3、 Colours Names

在PIL 1.1.4及其以后的版本，用户绘制“RGB”图像时，可以使用字符串常量。PIL支持如下字符串格式：

A、 十六进制颜色说明符，定义为“#rgb”或者“#rrggbb”。例如，“#ff0000”表示纯红色。

B、 RGB函数，定义为“rgb(red, green, blue)”，变量red、green、blue的取值为[0，255]之间的整数。另外，颜色值也可以为[0%，100%]之间的三个百分比。例如，“rgb(255, 0, 0)”和“rgb(100%, 0%, 0%)”都表示纯红色。

C、 HSL（Hue-Saturation-Lightness）函数，定义为“hsl(hue,saturation%, lightness%)”，变量hue为[0，360]一个角度表示颜色（red=0， green=120， blue=240），变量saturation为[0%，100%]之间的一个值（gray=0%，full color=100%），变量lightness为[0%，100%]之间的一个值（black=0%， normal=50%， white=100%）。例如，“hsl(0,100%, 50%)”为纯红色。

D、 通用HTML颜色名称，ImageDraw模块提供了140个标准颜色名称，Xwindow系统和大多数web浏览器都支持这些颜色。颜色名称对大小写不敏感。例如，“red”和“Red”都表示纯红色。

4、 Fonts

PIL可以使用bitmap字体或者OpenType/TrueType字体。

Bitmap字体被存储在PIL自己的格式中，它一般包括两个文件，一个叫.pil，它包含字体的矩阵，另一个通常叫做.pbm，它包含栅格数据。

在ImageFont模块中，使用函数load()加载一个bitmap字体。

在ImageFont模块中，使用函数truetype()加载一个OpenType/TrueType字体。注意：这个函数依赖于第三方库，而且并不是在所有的PIL版本中都有效。

（IronPIL）加载内置的字体，使用ImageFont模块的Font()结构函数即可。

二、ImageDraw模块的函数

1、 Draw

定义：Draw(image) ⇒ Draw instance

含义：创建一个可以在给定图像上绘图的对象。

（IronPIL）用户可以使用ImageWin模块的HWND或者HDC对象来代替图像。这个允许用户直接在屏幕上绘图。

注意：图像内容将会被修改。

例子：

fromPIL import Image, ImageDraw

im01 =Image.open(“D:\Code\Python\test\img\test01.jpg”)

draw =ImageDraw.Draw(im01)

draw.line((0,0) +im01.size, fill=128)

draw.line((0,im01.size[1], im.size[0], 0), fill = 128)

im01.show()

del draw

在图像01上绘制了两条灰色的对角线，如下图：

三、ImageDraw模块的方法

1、 Arc

定义：draw.arc(xy, start, end, options)

含义：在给定的区域内，在开始和结束角度之间绘制一条弧（圆的一部分）。

变量options中fill设置弧的颜色。

例子：

from PIL import Image,ImageDraw

im01 = Image.open(“D:\Code\Python\test\img\test01.jpg”)

draw =ImageDraw.Draw(im01)

draw.arc((0,0,200,200),0, 90, fill = (255,0,0))

draw.arc((300,300,500,500), 0, -90, fill = (0,255,0))

draw.arc((200,200,300,300),-90, 0, fill = (0,0,255))

im01.show()

del draw

注意：变量xy是需要设置一个区域，此处使用4元组，包含了区域的左上角和右下角两个点的坐标。此PIL版本中，变量options不能使用outline，会报错：“TypeError: arc() got an unexpected keyword argument ‘outline’”；所以此处应该使用fill。

在图像01上(0,0,200,200)区域使用红色绘制了90度的弧，(300,300,500,500)区域使用绿色绘制了270度的弧，(200,200,300,300)区域使用蓝色绘制了90度的弧。这些弧都是按照顺时针方向绘制的。变量start/end的0度为水平向右，沿着顺时针方向依次增加。绘制后的图像01如下图：

2、 Bitmap

定义：draw.bitmap(xy, bitmap, options)

含义：在给定的区域里绘制变量bitmap所对应的位图，非零部分使用变量options中fill的值来填充。变量bitmap位图应该是一个有效的透明模板（模式为“1”）或者蒙版（模式为“L”或者“RGBA”）。

这个方法与Image.paste(xy, color, bitmap)有相同的功能。

例子：

from PIL import Image,ImageDraw

im01 =Image.open(“D:\Code\Python\test\img\test01.jpg”)

im02 =Image.open(“D:\Code\Python\test\img\test02.jpg”)

im =im02.resize(300,200)>>> im.size

(300, 200)

r,g,b =im.split()

draw =ImageDraw.Draw(im01)

draw.bitmap((0,0), r, fill = (255,0,0))

draw.bitmap((300,200), g, fill = (0,255,0))

draw.bitmap((600,400), b, fill = (0,0,255))

im01.show()

变量xy是变量bitmap对应位图起始的坐标值，而不是一个区域。

图像im01如下：

3、 Chord

定义：draw.chord(xy,start, end, options)

含义：和方法arc()一样，但是使用直线连接起始点。

变量options的outline给定弦轮廓的颜色。Fill给定弦内部的颜色。

例子：

from PIL import Image, ImageDraw

im01 =Image.open(“D:\Code\Python\test\img\test01.jpg”)

draw =ImageDraw.Draw(im01)

draw.chord((0,0,200,200),0, 90, fill = (255,0,0))

draw.chord((300,300,500,500), 0, -90, fill = (0,255,0))

draw.chord((200,200,300,300), -90, 0, fill = (0,0,255))

im01.show()

图像im01如下：

4、 Ellipse

定义：draw.ellipse(xy,options)

含义：在给定的区域绘制一个椭圆形。

变量options的outline给定椭圆形轮廓的颜色。Fill给定椭圆形内部的颜色。

例子：

from PIL import Image, ImageDraw

im01 =Image.open(“D:\Code\Python\test\img\test01.jpg”)

draw =ImageDraw.Draw(im01)

draw.ellipse((0,0, 200, 200), fill = (255, 0, 0))

draw.ellipse((200,200,400,300),fill = (0, 255, 0))

draw.ellipse((400,400,800,600), fill = (0, 0, 255))

im01.show()

图像im01如下：

5、 Line

定义：draw.line(xy,options)

含义：在变量xy列表所表示的坐标之间画线。

坐标列表可以是任何包含2元组[(x,y),…]或者数字[x,y,…]的序列对象。它至少包括两个坐标。

变量options的fill给定线的颜色。

（New in 1.1.5）变量options的width给定线的宽度。注意线连接不是很好，所以多段线段连接不好看。

例子：

from PIL import Image, ImageDraw

im01 = Image.open(“D:\Code\Python\test\img\test01.jpg”)

draw = ImageDraw.Draw(im01)

draw.line([(0,0),(100,300),(200,500)], fill = (255,0,0), width = 5)

draw.line([50,10,100,200,400,300], fill = (0,255,0), width = 10)

im01.show()

图像im01如下：

6、 Pieslice

定义：draw.pieslice(xy,start, end, options)

含义：和方法arc()一样，但是在指定区域内结束点和中心点之间绘制直线。

变量options的fill给定pieslice内部的颜色。

例子：

from PIL import Image, ImageDraw

im01 = Image.open(“D:\Code\Python\test\img\test01.jpg”)

draw = ImageDraw.Draw(im01)

draw.pieslice((0,0,100,200), 0, 90, fill = (255,0,0))

draw.pieslice((100,200,300,400), 0, -90, fill = (0,255,0))

im01.show()

图像im01如下：

7、 Point

定义：draw.point(xy,options)

含义：在给定的坐标点上画一些点。

坐标列表是包含2元组[(x,y),…]或者数字[x,y,…]的任何序列对象。

变量options的fill给定点的颜色。

例子：

from PIL import Image, ImageDraw

im01 = Image.open(“D:\Code\Python\test\img\test01.jpg”)

draw = ImageDraw.Draw(im01)

draw.point([(0,0),(100,150), (110, 50)], fill = (255, 0, 0))

draw.point([0,10,100,110, 210, 150], fill = (0, 255, 0))

im01.show()

图像im01上在对应的坐标点上会有红色/绿色的点，每个点只占一个像素点。图像如下：

8、 Polygon

定义：draw.polygon(xy,options)

含义：绘制一个多边形。

多边形轮廓由给定坐标之间的直线组成，在最后一个坐标和第一个坐标间增加了一条直线，形成多边形。

坐标列表是包含2元组[(x,y),…]或者数字[x,y,…]的任何序列对象。它最少包括3个坐标值。

变量options的fill给定多边形内部的颜色。

例子：

from PIL import Image, ImageDraw

im01 = Image.open(“D:\Code\Python\test\img\test01.jpg”)

draw = ImageDraw.Draw(im01)

draw.polygon([(0,0),(100,150), (210, 350)], fill = (255, 0, 0))

draw.polygon([300,300,100,400, 400, 400], fill = (0, 255, 0))

im01.show()

图像01如下：

9、 Rectangle

定义：draw.rectangle(box,options)

含义：绘制一个长边形。

变量box是包含2元组[(x,y),…]或者数字[x,y,…]的任何序列对象。它应该包括2个坐标值。

注意：当长方形没有没有被填充时，第二个坐标对定义了一个长方形外面的点。

变量options的fill给定长边形内部的颜色。

例子：

from PIL import Image, ImageDraw

im01 = Image.open(“D:\Code\Python\test\img\test01.jpg”)

draw = ImageDraw.Draw(im01)

draw.rectangle((0,0,100,200), fill = (255,0,0))

draw.rectangle([100,200,300,500],fill = (0,255,0))

draw.rectangle([(300,500),(600,700)], fill = (0,0,255))

im01.show()

图像01如下：

10、 Text

定义：draw.text(position,string, options)

含义：在给定的位置绘制一个字符创。变量position给出了文本的左上角的位置。

变量option的font用于指定所用字体。它应该是类ImangFont的一个实例，使用ImageFont模块的load()方法从文件中加载的。

变量options的fill给定文本的颜色。

例子：

from PIL import Image, ImageDraw

im01 = Image.open(“D:\Code\Python\test\img\test01.jpg”)

draw = ImageDraw.Draw(im01)

draw.text((0,0),”Hello”, fill = (255,0,0))

im01.show()

在图像01的(0,0)位置绘制出字符串“Hello”。

11、 Textsize

定义：draw.textsize(string,options)⇒ (width, height)

含义：返回给定字符串的大小，以像素为单位。

变量option的font用于指定所用字体。它应该是类ImangFont的一个实例，使用ImageFont模块的load()方法从文件中加载的。

例子：

from PIL import Image, ImageDraw

im01 = Image.open(“D:\Code\Python\test\img\test01.jpg”)

draw = ImageDraw.Draw(im01)

draw.textsize(“Hello”)

(30, 11)

draw.textsize(“Hello, the world”)

(96, 11)

im01.show()

四、ImageDraw模块的option变量

Option变量有三个属性，分别为outline，fill和font。Outline和fill都可为整数或者元组；font为ImageFont类的实例。

这几个属性在前面方法介绍中都有用到，这里不作解释。

五、ImageDraw模块的兼容性

类Draw包括的一个构造函数和一些方法提供向后兼容。为了使这些函数正常工作，用户应该使用options，或者使用这些方法。但不能混合旧的和新的调用习惯。

（IronPIL）IronPIL不支持这些有兼容性的方法。

1、 ImageDraw

定义：ImageDraw(image)⇒ Draw instance

含义：（不赞成）生成Draw的实例。新代码中不要用这个函数。

2、 Setink

定义：draw.setink(ink)

含义：（不赞成）为后续绘制和fill属性设置颜色。

3、 Setfill

定义：draw.setfill(mode)

含义：（不赞成）设置fill属性。

如果变量mode为0，后续绘制的形状（像多边形和长方形）都是轮廓。如果mode为1，则它们会被填充。

4、 Setfill

定义：draw.setfont(font)

含义：（不赞成）为text()方法设置默认的字体。

变量font是ImageFont类的实例，使用ImageFont模块的load()方法从文件中加载的。