详解Python PIL ImagePath.Path.getbbox()方法

Python中的PIL模块是个非常有用的模块，提供了很多处理图像的方法和工具。在该模块中，ImagePath是其中的一个子模块，该子模块提供了一类可用于解析和操作路径的类，路径可以是 SVG 路径或者 W3C-path-data 。

ImagePath.Path.getbbox()方法是ImagePath.Path类的其中一个方法，它用于返回符合路径描边的最小矩形，常常用于计算给定路径的尺寸。

在使用getbbox()函数之前，首先需要对ImagePath.Path类有一定了解。

ImagePath.Path类的基本属性和方法

ImagePath.Path类是一个路径类，其包含多个方法和属性，其中最为常用的属性如下：

• path属性：保存了此路径的所有点坐标。

• codes属性：描述此路径每个点的操作符。

• vertices属性：描述此路径每个点的操作符及其参数。

下面是一些常用的方法：

• getbbox函数：返回符合路径描边的最小矩形。

• getlength()：返回路径的总长度，单位是像素。

• getpixel(xy)：返回像素坐标 xy 处的 RGB 值。

• point()：返回像素坐标 (x,y) 的阈值。

• transform()：使用指定的映射矩阵转换路径。

描述ImagePath.Path.getbbox()方法

ImagePath.Path.getbbox()方法是ImagePath.Path类的其中一个方法，用于返回符合路径描边的最小矩形，通俗来讲，就是获取一条路径的边框矩形。

语法

def getbbox(self, transform=None)

参数说明

• transform（可选）：用于变换路径坐标的函数，通常用于缩放和旋转等操作，这个参数是一个可调用的函数。

返回值

getbbox()将返回一组(左，上，右，下)元组，该元组表示路径的最小矩形，例如：(left, upper, right, lower)，其中left和top是矩形左上角的坐标，right和lower是下角的坐标。

如果路径不包含任何点，则将返回None值。

示例说明

示例一

from PIL import ImagePath

path = ImagePath.Path('M0,0 h100 v50 h-100 z')
bbox = path.getbbox()
print(bbox)

上面的代码使用了getbbox()函数，首先用Path()方法定义一个路径，然后使用getbbox()方法获得此路径的最小矩形的坐标，最后打印输出该坐标:

输出结果为：

(0, 0, 100, 50)

以上代码实现了一个简单的矩形，它是用路径定义的。

示例二

下面我们来举一一个实际的例子，如下所示，在图片上标注一个具有边框的文本框，那么我们可以先使用 getbbox() 函数获得文本框的边框矩形，然后根据边框矩形在图片上画出指定的矩形，以下是示例代码：

from PIL import Image, ImageDraw, ImageFont, ImagePath

# 初始化图片
image = Image.new('RGB', (400, 300), (255, 255, 255))
draw = ImageDraw.Draw(image)

# 编写文本内容
text = "Hello PIL"

# 字体
fontFamily = "/Library/Fonts/Arial.ttf"
fontSize = 50

# 文本位置
x, y = 100, 100

# 加载字体
font = ImageFont.truetype(fontFamily, fontSize)

# 获得文本路径
textPath = ImagePath.Path()
textPath.text((x, y), text, font=font, spacing=0)

# 获得文本区域的最小矩形，上下左右坐标
bbox = textPath.getbbox()

# 加个边框
boundingBox = [
    (bbox[0], bbox[1]),              # 左上
    (bbox[2], bbox[1]),              # 右上
    (bbox[2], bbox[3]),              # 右下
    (bbox[0], bbox[3])               # 左下
]

# 画矩形
draw.polygon(boundingBox, outline=(0, 0, 0))

# 显示图片
image.show()

该代码实现的效果图如下所示：

总之，getbbox()函数在对路径进行处理时非常有用，尤其对于文本、图形等的边界处理中特别实用。